Building Spring on Linux

2009-04-04T01:02:48Z

Malouin: documented another debian 5.0 dependency.

== 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.

==== 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.
that Spring 0.77b5 depends on the boost libraries version 1.34.* and won't
work on lower versions. (updated libboost-serialization-dev, and libvorbis-dev dependencies for 0.76b1)

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 libboost-dev
sudo aptitude install libboost-thread-dev libboost-regex-dev libdevil-dev
sudo aptitude install libboost-serialization-dev zip
sudo aptitude install libvorbis-dev libxcursor-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.

==== 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>

== Build And Install ==

The build will spew out warnings like the following, which you can safely ignore:

<code><pre>
warning: division by zero
warning: 'q' may be used uninitialized in this function
</pre></code>

=== 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/games/spring</code> and
read-only data in <code>/usr/local/share/games/spring</code>.

=== Using Scons ===
Configure and build:

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

Install:

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

 
== Finalizing installation ==
{{Finalizing_linux_install}}

 
== Linux specific Troubleshooting ==
{{Troubleshooting_linux}}

Spring - User contributions [en]

Building Spring on Linux