Building Spring on Linux

2010-02-24T04:20:03Z

Fustrateduserq: 64 bit multicore edit

[[Engine_Development|Development]] < [[Building_spring|Building Spring]] < {{FULLPAGENAME}}

= Build From Source on Linux =
If prefer to use your distributions package system, refer to the Linux [[SetupGuide]].

If there is no package tailored for your distribution, you have to install from sources manually. Doing this for distributions where packages are available is not recommended.

'''Warning: Be carefull when building from source. You might encounter sync errors in online play if you are using special compilers (all GCC from the 4.x series should be safe) or unstandard compiler settings (be carefull about -march)!'''
 

==Obtaining the Source ==
{{Obtaining_The_Source_Code}}

= Get Dependencies =

You will need to install some development packages Spring depends on. These vary from distro to distro and may also depend on your specific configuration.

If your distributions is not listed below, you should be able to figure out the correct package names from this. The scons configure will whine if you forget something, but it does not check if you remembered to install zip, even though you still need it.

== Full list ==
* Programs necessary to build
** cmake
** 7zip (aka p7zip)
** The usual build toolchain
*** gcc
*** make
* Libraries
** SDL
** boost (version 1.35 or later)
*** threads
*** regex
*** signals
*** system
** DeviL (IL, ILU)
** OpenAL (openal-soft, older openal-0.0.8 does not work)
** OpenGL headers (mesa, glew, etc.)
** zlib
** freetype
** ogg,vorbis and vorbisfile
* Optional, for bindings and Ais
** Python (2.5)
** Java-SDK

== Debian ==

For Etch (debian 4.0 stable) and Sid (debian unstable), I've confirmed the
following to be the minimal set that is necessary to get. This works with Ubuntu 8.10, too.
The version of spring from git repository depends on boost at least version 1.35.* (if your distro is behind you can try [https://launchpad.net/~pgquiles/+archive/ppa some unofficial backports]) and won't work on lower versions.

Also, on 64-bit be sure to build against devIl 1.6.8-rc2 or higher, 1.6.7 has a bug in the PNG loading code that causes issues.

<code><pre>
sudo aptitude install build-essential zlib1g-dev libfreetype6-dev
sudo aptitude install libsdl1.2-dev libopenal-dev libglew-dev zip
sudo aptitude install libvorbis-dev libxcursor-dev libdevil-dev
sudo aptitude install libboost-system1.37-dev libboost-system1.37-thread-dev
sudo aptitude install libboost-system1.37-regex-dev
sudo aptitude install libboost-system1.37-serialization-dev
sudo aptitude install libboost-system1.37-program-options-dev

</pre></code>

and either scons and python2.5-dev or cmake, depending on what you use for building (I advise to use cmake). On debian 5.0 (lenny), libglew1.5-dev is required as well.

=== Ubuntu 8.04 ===
Additionally you will need to install these packages:
<code><pre>
apt-get install p7zip-full libboost-thread1.40-dev libboost-regex1.40-dev
apt-get install libboost-program-options1.40-dev libboost-signals1.40-dev
</pre></code>
(or exchange the libboost 1.40 for 1.37 if you're using that version)

== Gentoo ==
This has been tested to work with a clean install of gentoo 2008.0:

<code><pre>
emerge cmake \>=media-libs/freetype-2.0.0 \>=media-libs/libsdl-1.2.0
emerge media-libs/openal media-libs/glew dev-libs/boost
emerge app-arch/zip media-libs/libogg
USE="png jpg tiff opengl" emerge media-libs/devil
</pre></code>

== Fedora ==

On Fedora 8, these dependencies should be sufficient:

<code><pre>
yum install cmake boost-devel openal-devel SDL-devel \
DevIL-devel glew-devel libvorbis-devel
</pre></code>

On Fedora 12, these dependencies should be sufficient:

<code><pre>
yum install gcc-c++ cmake boost-devel DevIL-devel freetype-devel \
glew-devel libvorbis-devel libXcursor-devel openal-devel SDL-devel p7zip
</pre></code>

== Slackware ==

On Slackware 13, cmake, ogg vorbis, boost, glew and SDL already come with the full regular install, both libs and headers. Also [http://slackbuilds.org/ here] you will find helper scripts to easily compile and package DEvIL, openAL and spring itself.

= Build And Install =

== Using CMake (2.6 or newer) ==
Configure and build:

<code><pre>
cmake .
make
</pre></code>

Install:

<code><pre>
make install
</pre></code>

Your paths are: Spring executable in <code>/usr/local/bin/spring</code> and
read-only data in <code>/usr/local/share/games/spring</code>. If you want <code>/usr</code> prefix instead <code>/usr/local</code> do the compilation in this way:

<code><pre>
cmake -DCMAKE_INSTALL_PREFIX=/usr .
make
</pre></code>

Additionally, If you experience performance problems on multi core 64 bit systems, try these additional commands:
<code><pre>

cmake -DUSE_GML=1 -DUSE_GML_SIM=1 .
make
</pre></code>
And install as shown previously

== Using Scons ==
Configure and build:

<code><pre>
scons configure
scons
</pre></code>

Install:

<code><pre>
scons install
</pre></code>

 
{{Finalizing_linux_install}}

 
{{Troubleshooting_linux}}

[[Category:Compiling]]

Spring - User contributions [en]

Building Spring on Linux