| 59 | | * Install various standard tools and development libraries: |
| 60 | | * GCC (at least 4.0, preferably 4.3 or later) |
| 61 | | * Subversion |
| 62 | | * NASM |
| 63 | | * There is a [http://sourceforge.net/tracker/?func=detail&aid=2821249&group_id=6208&atid=106208 bug] in NASM 2.06 on x86_64, so you might want to try a different version if you get errors. |
| 64 | | * SDL |
| 65 | | * Boost |
| 66 | | * zlib |
| 67 | | * libpng |
| 68 | | * libxml2 |
| 69 | | * OpenGL |
| 70 | | * OpenAL |
| 71 | | * zip (needed by spidermonkey) |
| 72 | | * libogg |
| 73 | | * libvorbis |
| 74 | | * libcurl |
| 75 | | * wxWidgets (probably called wxgtk on Linux) (optional, but required for the editor tools) |
| 76 | | * Gamin (FAM should work too) (Linux only) |
| 77 | | * ENet (pass the flag `--with-system-enet` to `update-workspaces.sh` to use the installed version, otherwise an included version will be used) |
| 78 | | * DevIL |
| 79 | | * CMake |
| 80 | | * ''Optionally'': [http://code.google.com/p/nvidia-texture-tools NVTT] (pass the flag `--with-system-nvtt` to `update-workspaces.sh` to use the installed version; otherwise we'll automatically use a bundled copy of the library) |
| 81 | | * For '''Ubuntu''' or '''Debian''' (at least unstable and testing) the following might help: |
| 82 | | {{{ |
| | 59 | Linux is a supported platform as well. 0ad runs smoothly, just give it a try! |
| | 60 | |
| | 61 | ==== Dependecies ==== |
| | 62 | |
| | 63 | First you need to install various standard tools and development libraries: |
| | 64 | |
| | 65 | * GCC (at least 4.0, preferably 4.3 or later) |
| | 66 | * Subversion (or git if you want to use the git mirror; read below) |
| | 67 | * NASM |
| | 68 | * There is a [http://sourceforge.net/tracker/?func=detail&aid=2821249&group_id=6208&atid=106208 bug] in NASM 2.06 on x86_64, so you might want to try a different version if you get errors. |
| | 69 | * SDL |
| | 70 | * Boost |
| | 71 | * zlib |
| | 72 | * libpng |
| | 73 | * libxml2 |
| | 74 | * OpenGL |
| | 75 | * OpenAL |
| | 76 | * zip (needed by spidermonkey) |
| | 77 | * libogg |
| | 78 | * libvorbis |
| | 79 | * libcurl |
| | 80 | * Gamin (FAM should work too, but is considered deprecated) |
| | 81 | * ENet (pass the flag `--with-system-enet` to `update-workspaces.sh` to use the installed version, otherwise an included version will be used) |
| | 82 | * DevIL |
| | 83 | * CMake |
| | 84 | * '''Optionally''' for editor tools: wxWidgets (probably called wxgtk) |
| | 85 | * '''Optionally''' for Nvidia cards: [http://code.google.com/p/nvidia-texture-tools NVTT] (pass the flag `--with-system-nvtt` to `update-workspaces.sh` to use the installed version; otherwise we'll automatically use a bundled copy of the library) |
| | 86 | |
| | 87 | ==== Debian/Ubuntu ==== |
| | 88 | |
| | 89 | Install the dependencies like this: |
| | 90 | |
| | 91 | {{{ |
| 113 | | "`-j3`" gives the number of parallel builds to run, and should typically be one plus the number of CPU cores available. |
| 114 | | * Alternatively you could download the code from a [http://github.com/0ad/0ad/ Git mirror] (which may be slightly less up-to-date than SVN, but likely much faster to download). |
| 115 | | * The Release mode builds are more optimised, are harder to debug. Use `CONFIG=Debug` (and run `pyrogenesis_dbg`) if you need better debugging support. |
| 116 | | * If you encounter any build errors, look for an existing bug report or report a new bug. Also check the [#Knownproblemsandsolutions known problems section] below. |
| 117 | | * Run the automated tests to verify that everything works as expected, then run the game: |
| 118 | | {{{ |
| 119 | | cd ../../../binaries/system |
| 120 | | ./test |
| 121 | | ./pyrogenesis |
| 122 | | }}} |
| | 148 | |
| | 149 | * '''-j3''' gives the number of parallel builds to run, and should typically be one plus the number of CPU cores available. |
| | 150 | * The '''Release''' mode builds are more optimised, are harder to debug. Use `CONFIG=Debug` (and run `pyrogenesis_dbg`) if you need better debugging support. |
| | 151 | |
| | 152 | |
| | 153 | 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]. |
| | 154 | |
| | 155 | === Testing === |
| | 156 | |
| | 157 | Run the automated tests to verify that everything works as expected like this: |
| | 158 | |
| | 159 | {{{ |
| | 160 | binaries/system/test |
| | 161 | }}} |
| | 162 | |
| | 163 | === Running === |
| | 164 | |
| | 165 | If everything went well, compiling the code worked and all tests passed, it's finally time to run the game: |
| | 166 | |
| | 167 | {{{ |
| | 168 | binaries/system/pyrogenesis |
| | 169 | }}} |
| | 170 | |
