Build STK on Linux
Note that these instructions apply to STK versions more recent that 0.8 alpha. If you want to compile an older version, please use the history feature of the wiki.
If you are a packager making a package for a Linux distribution, please do not try to modify our build system to use system versions of bullet and irrlicht. In both cases we use a specific and/or modified version of the library, and linking STK against the system library will only introduce bugs (corrupted graphics, memory leaks) into SuperTuxKart. Thanks
First of all, you will need a compiler and the autotools build system. When building the current SVN, you will also need cmake. Other dependencies you will need include openal, ogg, vorbis.
yum install gcc-c++ autoconf automake libogg-devel libvorbis-devel openal-soft-devel fribidi-devel subversion libcurl-devel cmake irrlicht-devel
sudo apt-get install autoconf automake build-essential cmake libogg-dev libvorbis-dev libopenal-dev libxxf86vm-dev libgl1-mesa-dev libglu1-mesa-dev libcurl4-openssl-dev libfribidi-dev
This part is required only for STK 0.8, no longer required with STK SVN.
From the STK root source directory, start by compiling irrlicht.
NDEBUG=1 make -j2
(in this sample I configure make to use 2 cores. You can use more/less depending on your configuration). Note that these steps should be repeated whenever we update irrlicht.
Then build SuperTuxKart using CMake
make VERBOSE=1 -j2
(again in this sample I configure make to use 2 cores. You can use more/less depending on your configuration).
To make a debug build add -DCMAKE_BUILD_TYPE=Debug like this:
cmake .. -DCMAKE_BUILD_TYPE=Debug
Another option is to build the regular release version with its optimizations, but with debugging symbols still enabled. Replace the Debug with RelWithDebInfo for that.
And finally, to install (optional):
sudo make install
this will install in /usr/local. If you want to install somewhere else, replace the "cmake" command with something like:
cmake .. -DCMAKE_INSTALL_PREFIX=/opt/stk
If you want to use the eclipse ide, use the following approach:
In cmake_build :
mkdir cmake_build cmake -G "Eclipse CDT4 - Unix Makefiles" -DCMAKE_BUILD_TYPE=Debug ..
This will generate project files based on the cmake files.
Now open Eclipse, Import -> Existing projects into workspace, browse to the trunk and import the project.
Right-click the project -> New -> Convert to C++ Project
Right-click the project -> properties -> C/C++ Build
- Uncheck "Use default build command"
- Enter as build command "make VERBOSE=1 -j2" (replace 2 by the number of cores)
C/C++ Build -> Discovery options
- Automate discovery of path and symbols
- Discovery profile : GCC per project scanner into profile
Right-click project -> index -> rebuild
Now you can build the project by :
- Right-click project -> Build Project
- Or by using the build button at the top