Support:Releasing: Difference between revisions
Jump to navigation
Jump to search
Content deleted Content added
imported>Hendrik Brummermann started to convert into wiki formating |
imported>Hendrik Brummermann No edit summary |
||
| Line 1: | Line 1: | ||
| ⚫ | |||
From /home/marauroa/doc/releasing.txt |
From /home/marauroa/doc/releasing.txt |
||
| Line 10: | Line 8: | ||
* Ask testers to test everything new and everything old |
* Ask testers to test everything new and everything old |
||
* Ask developers to update doc/CHANGES.txt |
* Ask developers to update doc/CHANGES.txt |
||
* Ask testers to make nice screenshots of the changes |
* Ask testers to make nice screenshots of the changes (to use later for the arianne.sf.net announcement) |
||
=== Version numbers === |
=== Version numbers === |
||
| Line 18: | Line 16: | ||
version.old = 0.95 |
version.old = 0.95 |
||
version = 0.96 |
version = 0.96 |
||
I am sure I don't need to explain the numbers or names to you, it is self evident. |
|||
=== Branching procedure === |
=== Branching procedure === |
||
We develop code on HEAD and branch from HEAD for each release. |
We develop code on HEAD and branch from HEAD for each release. |
||
| Line 30: | Line 27: | ||
== Releasing == |
== Releasing == |
||
=== CVS Checkout |
|||
* In a shell go to directory /home/marauroa/branch_cvs |
|||
* Create subfolder with the version number (e. g. 1.00) |
|||
* cd into subfolder |
|||
* run with the correct branch name: <code>cvs -d :pserver:arianne.cvs.sf.net:/cvsroot/arianne checkout -r VERSION_01_RELEASE_00 stendhal</code> |
|||
=== Building the release === |
=== Building the release === |
||
* still in /home/marauroa/<version> move all the files from the subfolder "stendhal", which was created by CVS, one into the current folder: <code>mv stendhal/* stendhal/.hotspotrc stendhal/.cvsignore .</code> |
|||
Normally when you build the client or server, ant clean && build is enough. For release we need to build many things - not just the server and client but also the server source code, zipped up, the .jnlp file for webstart, and signed jars so that updates work correctly. A signed jar needs a 'key'. This is inside a file called keystore.ks which you can only get from people trusted by the Sun corporation. If you are a Stendhal project admin please ask Miguel for this file. It is placed in the same directory as build.xml etc - i.e. your root stendhal source directory. A keystore alias and password is expected. You can put these as parameters everytime you run ant dist (see below) or in a file called build.ant-private.properties (ask hendrik about this). |
|||
* copy the keystore.ks and build.ant-private.properties: <code>cp ../skeleton/* .</code> |
|||
* download the last official release to build-archive: <code>cd build-archive; wget <nowiki>http://arianne.sourceforge.net/download/stendhal.zip</nowiki>; mv stendhal.zip stendhal-<oldversion>.zip; cd ..</code> |
|||
* run <code>ant dist</code> |
|||
* copy the output from the signupdated-step into an editor. |
|||
So, the download and release files are build nowupdate-0.95.properties.xxx |
|||
<pre> |
|||
Now you are ready to run: |
|||
== Preparing the updater == |
|||
ant dist -Dkeystore.alias=miguelangelblanchlardin@hotmail.com -Dkeystore.password=qwerty |
|||
Note: 0.95 is the version of the update-base. (The last time the updater was broken). |
|||
You should now have the 4 files for the file release: |
|||
the server zip, at build/stendhal-server-0.XX.zip |
|||
* download the file <nowiki>http://arianne.sourceforge.net/stendhal/updates/update-0.95.properties</nowiki> and save it as update-0.95.properties.xxx |
|||
the 2 client zips, build/stendhal-FULL-0.XX.zip and build/stendhal-0.XX.zip |
|||
* edit update-0.95.properties.xxx. The file has lots of comments. Important: for the *file-list* file list parameters, stendhal/stendhal-diff must be the last entry in order to recover from a half download. |
|||
the source gzip, at build/stendhal-0.XX-src.tar.gz |
|||
* You need at least stendhal-data-1.xx.jar and stendhal-1.xx.jar for the initial download and stendhal-data-diff-1.xx-1.xx.jar,stendhal-diff-1.xx-1.xx.jar for the update. If there had been changes, include marauroa-client, stendhal-sound-diff and/or stendhal-music-diff. |
|||
* Upload the files to the arianne webspace on Sourceforge. |
|||
== Testing the updater == |
|||
* On your local computer find ~/.stendhal/jar/jar.properties and add this line <code>server.update-prop-0.95=http://arianne.sourceforge.net/stendhal/updates/update-0.95.properties</code>. |
|||
* Test a normal update for the download client |
|||
* Test a update for the webstart client. |
|||
* Test a fresh download for the webstart client. |
|||
* Test a webstart start with only diff-files (created by an update of a downloaded client) in the jar-folder |
|||
| ⚫ | |||
</pre> |
|||
=== Uploading the File Release === |
=== Uploading the File Release === |
||
* download + z_old |
|||
You need to get the folder ready for the files to go in. You can: |
You need to get the folder ready for the files to go in. You can: |
||