DarkRadiant - Compiling in Linux: Difference between revisions
Oops, should have been a subsection |
|||
| Line 62: | Line 62: | ||
== Compile == | == Compile == | ||
'''Note: in the past, DarkRadiant was built using SCons. This build system has now been deprecated in favour of the standard Automake build, and in future the SCons files will be removed. Please do not expect any support from the developers if you attempt to compile DarkRadiant using the SCons build system.''' | |||
DarkRadiant employs an Autoconf/Automake build system under Linux as used in the majority of open-source projects. Compilation can be achieved using the standard | |||
$ ./configure | |||
$ make | |||
$ make install | |||
on most systems. | |||
By default, a release build will be created; if a debug build is required pass the '''--enable-debug''' option to the configure script. | |||
Other points to note about the configure process: | |||
* The DarkMod-specific plugins are not built by default. To enable these, pass '''--enable-darkmod-plugins''' to ./configure. | |||
* The configure script autodetects required dependencies, and will conditionally-enable optional components of DarkRadiant (such as the sound plugin) based on what it finds. | |||
* For quick testing of a DarkRadiant build, it is desirable to install it into a temporary location rather than the default of '''/usr/local'''; for this, simply pass a prefix option such as '''--prefix=/tmp/dr''' to configure, after which DarkRadiant will be installed in '''/tmp/dr/bin/darkradiant'''. | |||
* To build a Debian/Ubuntu package, simply run '''dpkg-buildpackage -rfakeroot''' in the main '''darkradiant''' directory. The .deb will be created in the parent directory. | |||
If you want to update the source with the latest version from the SVN, just issue: | If you want to update the source with the latest version from the SVN, just issue: | ||
Revision as of 12:58, 6 August 2008
Install Libraries and Tools
Ubuntu 7.04
You'll need a bunch of packages to get DarkRadiant to compile without glitches. I can't remember all from the top of my head, I will try to complete this list during my next Linux setup, but don't hold your breath. These are the names as found in Ubuntu 7.04 (Feisty Fawn):
- g++
- gcc-4.1
- scons 0.96.93 (or higher)
- libboost-dev
- libboost-serialization-dev
- libboost-filesystem-dev
- libboost-regex-dev
- libglew-dev
- libgtk2.0-dev
- libglib2.0-dev (maybe installed with libgtk2.0-dev)
- libgtkglext1-dev
- libxml2-dev
- libopenal-dev
- libalut-dev
- libvorbis-dev
Always download all the dependencies as well. Python should already be installed by Ubuntu at least, other distributions might require to install it separately.
If you get an error about the G++ compiler not being found, make sure you also install the g++ package, and not just the g++-4.1 package.
Ubuntu 7.10
- g++
- scons 0.97
- libboost-dev
- libboost-regex-dev
- libgtk2.0-dev
- libglew1.4-dev
- libgtkglext1-dev
- libxml2-dev
- libboost-serialization-dev
- libboost-filesystem-dev
- libboost-date-time-dev
- libalut-dev
- libvorbis-dev
Always download all the dependencies as well.
For the D3Hook plugin, the boost/asio library is needed (version 0.3.7, newer versions don't work). This library is located in the plugins/dm.d3hook/boost/ folder and should be ready for compilation.
Ubuntu 8.04
Copy and paste the following into a terminal:
sudo apt-get install g++ scons libboost-dev libboost-regex-dev libgtk2.0-dev libglew1.5-dev libgtkglext1-dev libxml2-dev libboost-serialization-dev libboost-filesystem-dev libboost-date-time-dev libalut-dev libvorbis-dev
In the terminal, Ctrl Shift V is used for pasting instead of Ctrl V.
Obtain the source
Install the subversion client. On Ubuntu this can be done via the Synaptic Manager or the command line:
sudo apt-get install subversion
Change to the directory where you want the source code to be in and then check the current version out of SVN with:
svn checkout https://darkradiant.svn.sourceforge.net/svnroot/darkradiant/trunk/darkradiant/ darkradiant
Compile
Note: in the past, DarkRadiant was built using SCons. This build system has now been deprecated in favour of the standard Automake build, and in future the SCons files will be removed. Please do not expect any support from the developers if you attempt to compile DarkRadiant using the SCons build system.
DarkRadiant employs an Autoconf/Automake build system under Linux as used in the majority of open-source projects. Compilation can be achieved using the standard
$ ./configure $ make $ make install
on most systems.
By default, a release build will be created; if a debug build is required pass the --enable-debug option to the configure script.
Other points to note about the configure process:
- The DarkMod-specific plugins are not built by default. To enable these, pass --enable-darkmod-plugins to ./configure.
- The configure script autodetects required dependencies, and will conditionally-enable optional components of DarkRadiant (such as the sound plugin) based on what it finds.
- For quick testing of a DarkRadiant build, it is desirable to install it into a temporary location rather than the default of /usr/local; for this, simply pass a prefix option such as --prefix=/tmp/dr to configure, after which DarkRadiant will be installed in /tmp/dr/bin/darkradiant.
- To build a Debian/Ubuntu package, simply run dpkg-buildpackage -rfakeroot in the main darkradiant directory. The .deb will be created in the parent directory.
If you want to update the source with the latest version from the SVN, just issue:
svn update
in the darkradiant source directory. svn info shows you what version you currently have.
Note for users with Multiprocessor Systems
Scons can run several jobs simultaneously, which can use your multicore system to its full capacity. By calling
scons JOBS="2"
the tool runs up to two compile tasks at the same time, which speeds up things a bit.
For a dual-core setup, a value of 2 jobs should be is sufficient, especially if you have only one Gbyte of memory, or less. If your machine has 2 or more Gbyte, you can also try higher values like:
scons JOBS="4"
