Compile In Linux
Each linux distribution will come with varying components already installed, although some libraries may be older than the version required by FreeOrion. Hopefully the notes below will help to identify what is required for your particular distribution.
- 1 Compiler
- 2 Kernel
- 3 Platform specifics
- 4 GiGi
- 5 FreeOrion
- 6 Clean After Dependency Changes
- 7 User stories
- 8 Compilation Errors
- 9 Runtime Errors
- 10 IDE for development
- 11 Debugging
GCC 4.x is required. See this forum thread.
If you compile using kernel 2.6.22 or above, your binary will likely not run on any other system having a lower numbered kernel version. This is due to a feature called "eventfd" which boost uses if a kernel 2.6.22 or above is found.
To avoid this incompatibility, you can specify CPPDEFINES="BOOST_ASIO_DISABLE_EVENTFD" as a parameter to scons to disable usage of eventfd.
This issue should not be a problem at all if you don't share your binaries.
To build gigi or FreeOrion you first need to install the following packages using Synaptic (you will need to have the Universe repository included):
- python and python2.5-dev
- libboost1.37-dev(only in Ubuntu Jaunty repository)
You can install all of these (including dependencies) from the command line using this:
sudo apt-get install build-essential subversion scons sudo apt-get install python python2.5-dev libfreetype6-dev libsdl1.2-dev libsdl-mixer1.2-dev graphviz-dev libalut-dev libvorbis-dev
Ubuntu (Jaunty repository)
sudo apt-get install libboost1.37-dev
Ogre3D 1.6, which is only recommended and not required to compile GiGi, is not in Ubuntu repository.
Same as Ubuntu, but Ogre3D 1.6, which is only recommended and not required to compile GiGi, is not in Debian repository.
Before attempting to build FreeOrion you will first need to build and install the GiGi library.
The GiGi source should be automatically downloaded from SVN along with the FreeOrion source code. If not, it can be manually downloaded:
Change into the GiGi directory and build the library:
cd freeorion/FreeOrion/GG scons sudo scons install sudo ldconfig
Since improvements and changes will be made to GiGi periodically, you should keep it up to date with:
cd freeorion/FreeOrion/GG svn update scons sudo scons install sudo ldconfig
After GiGi is compiled and installed, compile FreeOrion:
cd freeorion/FreeOrion scons
When improvements have been made to FreeOrion, you should build the new version:
cd freeorion/FreeOrion svn update scons
Clean After Dependency Changes
It has been reported that on Gentoo, it may be necessary to clean your old build before rebuilding GiGi or FreeOrion after updates that make changes to dependencies or versions of dependencies used, such as Boost. To do this:
Bogus build errors
You may see errors during the build process like this:
Checking for freetype2 >= 9.0.0... no Checking for C header file ft2build.h... yes Checking for FT_Init_FreeType() in C library freetype... yes Checking for C header file IL/il.h... yes
These failed messages refer to scons not finding an installed package for these components. The subsequent successful checks show that despite there being no pkg-config ".pc" file, the required header and library files were successfully located.
SCons Can't Find Libraries/Dependencies
If SCons is not able to find a library (e.g. Boost, GiGi, etc) that is installed, you need to be certain SCons is looking in the right directories. Your distribution may install the library in an unexpected location, or you may have manually installed the library in a non-standard directory (e.g. /home/user/freeorion/Boost). You will need to configure scons to look in these additional directories. The command:
lists the command-line options for SCons, including how to configure dependency directories. The command (add or remove options to match your needs):
scons configure prefix=/usr/local/freeorion with_boost_include=/usr/local/include/boost with_ogre_include=/usr/include/OGRE
will store these options permanently in the file options.cache. Run configure again, or edit options.cache, to change the settings.
- If in your distribution is only newer boost library(boost 1.36 is missing), see this forum post
- Scons can't find boost library. Then you have to tell scon to use mt version of boost with commands:
scons boost_lib_suffix=-mt --config=force
If after compiling everything, you run freeorion and get a segmentation fault:
$ ./freeorion Segmentation fault
- You might be mixing dependencies compiled with different versions of GCC. See this forum post, this other forum post, this third post.
Video mode set failed: Couldn't find matching GLX visual
Your video mode is probably set to 16-bit instead of 32-bit, which is what FreeOrion defaults to. You need to either change your X server color depth to 32-bit, or edit the FreeOrion config file in ~/freeorion/config.xml and change color-depth from 32 to 16. You can also try the command line argement:
./freeorion --color-depth 16
IDE for development
- Text editor and scons to compile
- Eclipse is open source multiplatform IDE and can be used to compile FreeOrion, but plugins to support scons and subversion have to be installed. See howto Compile With Eclipse.
Adding debug symbols to binary
Turn on debugging symbols on GG and FreeOrion with:
scons configure debug=1
and then rebuild GG and FreeOrion.
Install debugger gdb and run freeorion with:
and after it starts gdb type
and wait until segfault occurs. Then to print backtrace type