Setting game version number
Package versioning and In game display
in configure.ac change
AC_INIT(freedroidRPG, 0.11rc1)
The "testing version" warning popup message is added automatically for builds with "rc" in the name.
Todo: Figure out if...
- Possible to make a version string that automatically updates svn version?
AC_INIT(freedroidRPG, 0.11rc1 svn961 ) ?
Other projects, eg ufoai, has this. Convenient for bug reports.
- Should rc builds be treated as "stable" to not be quitting due to float exceptions? This is true now, but should it?
Creating the packages
Before starting:
- Update src/vars.h with the languages that should be included.
- We probably need to properly handle creating new up to date po/*.pot files without any outdated cruft in them.
# Get a clean checkout (save a tarball of it for later)
# Delete the .pot files
# autogen-config-make
# svn commit the freshly generated pot files.
Linux source tarball
1) Do a new fresh checkout (so old cruft in your own version isn't included)
svn co
https://freedroid.svn.sourceforge.net/svnroot/freedroid freedroid-clean
2) cd freedroid-clean
3) ./autogen.sh
4) ./configure
5) make dist-bzip2
6) Verify that the created tar works (unpack && ./configure && make) and game runs from src/ folder.
7) Also verify that make install works and installed game runs. (sudo make install, run it, sudo make uninstall)
8) Check 6-7 also with user folder deleted.
9) Check that Mapediting (load/change/save) works.
Current manual fixups for Windows and
MacOS?-binary versions:
- Remove any language dir in po/ that is not complete enough to be in the release (Windows and MacOS? currently irreversibly default to system localization.)
Windows .zip
1) Create a new empty folder with an appropriate name, eg freedroidrpg-0.11rc1-win32
2) Compile or download freedroidRPG.exe (AH usually has it here
http://www.freedroid.org/freedroidRPG.exe ) and place it in the created folder
3) Add all needed DLLs to the folder (
http://ah34.free.fr/DLL/ )
4) Add the following files and subfolders from the Linux tarball
Files Required:
COPYING (the GPL licence)
README Files Optional:
HELP-WANTED NEWS Changelog Folders:
dialogs/ graphics/ map/ po/ sound/ 5) Compress the folder into a zip.
6) Verify it extracts & runs properly.
Windows Self Extracting Archive
Get Cygal to do his SEA under Windows (that adds desktop links etc)
or, for more plain versions
1-4) As above, then
for SE zip:
http://www.info-zip.org/FAQ.html#unixSFX
for 7z:
5) 7za a -sfx freedroidrpg-0.11rc1-win32.exe freedroidrpg-0.11rc1-win32
6) Verify it extracts & runs properly.
http://www.tu-harburg.de/rzt/tuinfo/oberflaechen/linux/sfx.html
Advantage over zip: No risk of user using broken unziptool, about 5% smaller
Disadvantage: Some people don't like .exe packages
Todo:
Linux .deb package
http://ubuntuforums.org/showthread.php?t=51003
Beos
MacOS
Putting the files online
Temporary upload location.
Do NOT release from here. Only used this as a temporary storage location to eg allow a small group of users, eg the development team, to download and verify your package is working before putting it on the release server.
1) Before interacting with SFs services via commandline, you first need to create an active shell
ssh -t USERNAME,freedroid@shell.sourceforge.net create 2) In a new commandline window SCP the files 1 by 1 to the SF server
scp FILENAME USERNAME@shell.sf.net:/home/groups/f/fr/freedroid/htdocs 3) Send the proper link(s) to the target people.
http://www.freedroid.org/FILENAME
Remember to login and remove the files when not needed any more.
ssh -t USERNAME,freedroid@shell.sourceforge.net create cd /home/groups/f/fr/freedroid/htdocs rm FILENAME
If you need to verify the RSA keys for SF you find them here
http://alexandria.wiki.sourceforge.net/SSH+Host+Key+Fingerprints
SourceForge File Release System (FRS)
Note: You have to have the appropriate administration rights on SF for FreedroidRPG
1) Using eg Filezilla, connect to frs.sourceforge.net:22
2) Upload the files to the upload/ dir.
3) Login to your account on
http://sourceforge.net/ with your browser.
4) Go to the freedroid project.
5) In the ADMIN tab select "File Releases"
https://sourceforge.net/project/admin/editpackages.php?group_id=54521 6) in FRS for package name: freedroidRPG press the add release button.
7) Name the release, eg freedroidRPG-0.11rc1 and continue
8) Fill in the form, committing the section after each change. Look on previous releases for file settings.
9) Verify links are working and correct packages are downloaded.
You find the relevant documentation here
http://sourceforge.net/docman/?group_id=1 section E01
http://sourceforge.net/docman/display_doc.php?docid=6445&group_id=1
Announcing the release
FRS people monitoring this package
Put a marker in the box to mail these people
Maillist
Send out a mail
Website
Put up a news item on the front/news page
nano -w /home/groups/f/fr/freedroid/htdocs/data/news.txt
News item on SF
1) Login to your account on
http://sourceforge.net/ with your browser.
2) Go to the freedroid project.
3) In the ADMIN tab select "News"
4) Press submit
5) Write the new entry