Changes between Version 307 and Version 308 of BuildInstructions
- Timestamp:
- Sep 26, 2017, 5:21:21 PM (7 years ago)
Legend:
- Unmodified
- Added
- Removed
- Modified
-
BuildInstructions
v307 v308 1 1 [[TOC]] 2 2 3 This page describes how to get the very latest unstable version of the code. Unless you want to actively follow and contribute to development, **you probably want the [http ://play0ad.com/download latest relatively-stable release] instead.**4 5 The current release of the game is aimed at developers and not at 'normal' users. As such, the following instructions assume a reasonable level of technical proficiency. If you encounter difficulties, please post on the [http ://www.wildfiregames.com/forum/index.php?showforum=312 forum].3 This page describes how to get the very latest unstable version of the code. Unless you want to actively follow and contribute to development, **you probably want the [https://play0ad.com/download latest relatively-stable release] instead.** 4 5 The current release of the game is aimed at developers and not at 'normal' users. As such, the following instructions assume a reasonable level of technical proficiency. If you encounter difficulties, please post on the [https://www.wildfiregames.com/forum/index.php?showforum=312 forum]. 6 6 7 7 == General prerequisites == … … 42 42 The game's code, data and build environment are stored on a Subversion server. The recommended way to get an up-to-date copy is with TortoiseSVN: 43 43 44 * Download and install [http ://tortoisesvn.net/ TortoiseSVN]. (Make sure you reboot when it asks you to.)45 * Use TortoiseSVN to check out `http ://svn.wildfiregames.com/public/ps/trunk/`. This may take a while, and will use around 5GB of disk space. If there are errors during the checkout, use TortoiseSVN's "update" to resume downloading.46 47 The [http ://tortoisesvn.net/docs/release/TortoiseSVN_en/index.html TortoiseSVN manual] has information on [http://tortoisesvn.net/docs/release/TortoiseSVN_en/tsvn-dug-checkout.html checking out], as well as [http://tortoisesvn.net/docs/release/TortoiseSVN_en/tsvn-dug-update.html updating] and [http://tortoisesvn.net/docs/release/TortoiseSVN_en/tsvn-dug-patch.html creating patches].48 49 (This is the read-only public SVN URL. If you have commit access, you need to use `http ://svn.wildfiregames.com/svn/ps/trunk/` instead.)44 * Download and install [https://tortoisesvn.net/ TortoiseSVN]. (Make sure you reboot when it asks you to.) 45 * Use TortoiseSVN to check out `https://svn.wildfiregames.com/public/ps/trunk/`. This may take a while, and will use around 5GB of disk space. If there are errors during the checkout, use TortoiseSVN's "update" to resume downloading. 46 47 The [https://tortoisesvn.net/docs/release/TortoiseSVN_en/index.html TortoiseSVN manual] has information on [https://tortoisesvn.net/docs/release/TortoiseSVN_en/tsvn-dug-checkout.html checking out], as well as [https://tortoisesvn.net/docs/release/TortoiseSVN_en/tsvn-dug-update.html updating] and [https://tortoisesvn.net/docs/release/TortoiseSVN_en/tsvn-dug-patch.html creating patches]. 48 49 (This is the read-only public SVN URL. If you have commit access, you need to use `https://svn.wildfiregames.com/svn/ps/trunk/` instead.) 50 50 51 51 If you only wish to play the most cutting-edge version, this is all you have to do (other than [#Keepinguptodate Keeping up to date]). The executable will be located at `binaries/system/pyrogenesis.exe`. … … 75 75 After you've set everything up, the process for staying up to date is: 76 76 77 * [http ://tortoisesvn.net/docs/release/TortoiseSVN_en/tsvn-dug-update.html Update] the root directory of the checkout.77 * [https://tortoisesvn.net/docs/release/TortoiseSVN_en/tsvn-dug-update.html Update] the root directory of the checkout. 78 78 * Close the solution in Visual Studio if you've got it open. Run `update-workspaces.bat` again. (This is only needed if any source files have been added or removed. If you forget to run this, you'll probably get build errors about missing symbols.) 79 79 * Build again. … … 112 112 113 113 * [https://developer.mozilla.org/docs/SpiderMonkey/38 SpiderMonkey 38] (`--with-system-mozjs38`) 114 * [http ://code.google.com/p/nvidia-texture-tools NVTT] (`--with-system-nvtt`)114 * [https://github.com/castano/nvidia-texture-tools NVTT] (`--with-system-nvtt`) 115 115 116 116 For a list of all options to `update-workspaces.sh` see [wiki:premake]. … … 184 184 If there are issues, install more header files depending on the compiler's error message. 185 185 `nspr-devel` is required for building SpiderMonkey and pyrogenesis requires `MesaLib-devel` to provide header files for libGL. 186 Custom compile `gloox` for the Lobby or use xbps source packages or use `update-workspaces.sh --without-lobby` or wait until http ://github.com/voidlinux/void-packages/pull/5102 is merged.186 Custom compile `gloox` for the Lobby or use xbps source packages or use `update-workspaces.sh --without-lobby` or wait until https://github.com/voidlinux/void-packages/pull/5102 is merged. 187 187 If there are unresolved shlibs or an update breaks a package, then e.g. 188 188 {{{ … … 198 198 {{{ 199 199 #!sh 200 svn co http ://svn.wildfiregames.com/public/ps/trunk/ 0ad200 svn co https://svn.wildfiregames.com/public/ps/trunk/ 0ad 201 201 }}} 202 202 '''Note:''' Sometimes SVN stops before it has downloaded all files. You should check that it outputs something like `at revision rXXXX`. Otherwise run … … 233 233 * The '''Release''' mode builds (which are the default) are more optimised, but are harder to debug. Use `make config=debug` (and run `pyrogenesis_dbg`) if you need better debugging support. See [wiki:Debugging] for more details. 234 234 235 If you encounter any build errors, review the [http ://trac.wildfiregames.com/report existing bug reports], check the [#Knownproblemsandsolutions known problems section] or please file a [http://trac.wildfiregames.com/newticket new bug in the tracker].235 If you encounter any build errors, review the [https://trac.wildfiregames.com/report existing bug reports], check the [#Knownproblemsandsolutions known problems section] or please file a [https://trac.wildfiregames.com/newticket new bug in the tracker]. 236 236 237 237 === Testing === … … 264 264 265 265 == Creating Linux packages == 266 If you want to create packages for a Linux distribution see the current [http ://anonscm.debian.org/viewvc/pkg-games/packages/trunk/0ad/debian/ 0ad] and [http://anonscm.debian.org/viewvc/pkg-games/packages/trunk/0ad-data/debian/ 0ad-data] packages on OBS for examples (especially the `control` and `rules` files).266 If you want to create packages for a Linux distribution see the current [https://anonscm.debian.org/viewvc/pkg-games/packages/trunk/0ad/debian/ 0ad] and [https://anonscm.debian.org/viewvc/pkg-games/packages/trunk/0ad-data/debian/ 0ad-data] packages on OBS for examples (especially the `control` and `rules` files). 267 267 268 268 == OS X == … … 279 279 * As of Alpha 21, the game uses SpiderMonkey 38 which requires a Python 2.7 version later than 2.7.3. If you're on Mountain Lion (10.8) or earlier, you will need to first update your Python installation with the latest 2.7.x installer from [https://www.python.org/downloads/release/python-279/ here]. 280 280 * Obtain CMake: 281 * You can download a prebuilt OS X package [http ://www.cmake.org/cmake/resources/software.htmlhere].281 * You can download a prebuilt OS X package [https://cmake.org/download/ here]. 282 282 * If prompted, install the CMake command line tools to the default location. 283 283 * '''Note:''' Recent versions have no installer, so after copying the app bundle to '''Applications''', you need to run CMake with elevated permissions to install the command line tools. From the terminal: … … 294 294 {{{ 295 295 #!sh 296 svn co http ://svn.wildfiregames.com/public/ps/trunk/ 0ad296 svn co https://svn.wildfiregames.com/public/ps/trunk/ 0ad 297 297 }}} 298 298 '''Note:''' Sometimes SVN stops before it has downloaded all files. You should check that it outputs something like `at revision rXXXX`. Otherwise run … … 327 327 }}} 328 328 * The '''Release''' mode builds (which are the default) are more optimised, but are harder to debug. Use `make config=debug` (and run `pyrogenesis_dbg`) if you need better debugging support. See [wiki:Debugging] for more details. 329 * If you encounter any build errors, review the [http ://trac.wildfiregames.com/report existing bug reports], check the [#Knownproblemsandsolutions known problems section] or please file a [http://trac.wildfiregames.com/newticket new bug in the tracker].330 * Or if you have Xcode 4 installed, you can open `build/workspaces/xcode4/pyrogenesis.xcworkspace` (see discussion on this [http ://www.wildfiregames.com/forum/index.php?showtopic=15511&st=160#entry261743 here]).329 * If you encounter any build errors, review the [https://trac.wildfiregames.com/report existing bug reports], check the [#Knownproblemsandsolutions known problems section] or please file a [https://trac.wildfiregames.com/newticket new bug in the tracker]. 330 * Or if you have Xcode 4 installed, you can open `build/workspaces/xcode4/pyrogenesis.xcworkspace` (see discussion on this [https://www.wildfiregames.com/forum/index.php?showtopic=15511&st=160#entry261743 here]). 331 331 * Run the automated tests to verify that everything works as expected like this: 332 332 {{{