How to build a beta modules pack
All Project Apollo files and sources are public available via the anonymous CVS access. But to run and test Project Apollo the user has to have a compiler to build the modules from the sources. Since not every user has a suitable compiler we offer the already compiled modules in a separate download and keep this download up to date.
The following instructions explain how a developer can build this download, the beta modules zip, so that the users can test the latest CVS version. If you are an user who wants to use and test the beta release please go to the Installation.
Step-by-step instructions
It is assumed that you are already a Project Apollo developer and that you already did the CVS checkout as explained here: http://nassp.sf.net/developer/cvs.html. The following instructions are no comprehensive description of the SourceForge file release system, for more informations about that please look here: Guide to the File Release System
- Make sure that you have the latest sources from all developers. That means choose the "CVS Update" menu item from the Tortoise context menu at least for the "Orbitersdk" folder.
- Build all modules (.dll's) of all projects included in the Project Apollo workspace in release configuration. There should be a "batch build" menu item in your Visual Studio for that.
- All modules (.dll's ) should build without errors. If you get errors please don't do a release but fix the errors first or ask in the forum for advice. If you have some time left do some tests with the modules, you should at least check your own changes.
- Build a zip file from those modules. Like all Orbiter add-ons the zip file should have the proper directory structure, that means the modules should be in the "Modules\ProjectApollo" directory as the compiler did before. If you look at the latest beta modules zip at SourceForge you'll see how the zip file should look like. The name of the beta modules zip should be "ProjectApollo_Beta_<YYYYMMDD>.zip" where <YYYYMMDD> is the current date, for example "ProjectApollo_Beta_20050915.zip".
- Upload this new beta modules zip to ftp://upload.sourceforge.net/incoming/.
- Open the SourceForge file release system page and log in with your SourceForge user id and password if necessary.
- Scroll down and click the "[Edit Releases]" link of the "Beta Releases" package. Log in with your SourceForge user id and password if necessary.
- The "Beta releases" package has only one release, so choose the "[Edit This Release]" link of this release.
- You are now on the release edit page, which is divided into 4 steps. At first change the "Release Date" and "Release Name" to the date of your beta modules zip and click the first "Submit/Refresh" button.
- Then scroll down to step 2, choose the previously uploaded beta modules zip in the "Add Files To This Release" list and click the "Add Files and/or Refresh View" button below.
- Scroll down to step 3 and choose "i386" as processor and ".zip" as file type for the new beta modules zip and click the "Update/Refresh" button of the file. You can also delete older beta modules zips if you like, but please don't delete the "-READ_ME_FIRST-.txt" file.
- Scroll down to step 4 and notify the monitoring people about the new release.
- The new beta modules zip is now available on the SourceForge download pages here, instructions to update the beta testing page on the project home page will follow soon...
If you have questions or problems doing a beta release please post in the forum, we will help you then, of course!