Building Spring on Linux

2008-10-04T11:56:07Z

Steelside:

== Build From Source ==

'''You might encounter sync errors in online play if you are not using the exact same version of the compiler and same compiler settings as used for prebuilt packages! (Applies to GCC <4.0)'''

For 0.76b1 these are: TODO add them here.

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.

=== Get Source ===

You can either download the source as a 3.9MB tarball (recommended; v. 0.76b1) or get it from the subversion repository. Either way, the result is the same.

==== Tarball ====

<code><pre>
cd /usr/local/src # or /var/tmp, or whatever
wget http://spring.clan-sy.com/dl/spring_0.76b1_src.tar.bz2
tar xjf spring_0.76b1_src.tar.bz2
cd spring_0.76b1
</pre></code>

'''NOTE: The .zip release is for windows only. Linux users have to get .bz2 like shown above.'''

==== Subversion ====

<code><pre>
aptitude install subversion # if you are not on debian, figure it out
svn co https://spring.clan-sy.com/svn/spring/tags/spring_0.76b1 \
/usr/local/src/spring_0.76b1
cd /usr/local/src/spring_0.76b1
</pre></code>

If the above subversion host happens to be down (which is unlikely since you're reading this wiki page now), you can try the following hourly updated mirror (replace the svn co line above with the following line):
<code><pre>
svn co svn://caspring.org:3691/tags/spring_0.76b1 \
/usr/local/src/spring_0.76b1
</pre></code>

=== 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. I have not tested
with any version of Ubuntu, but the line is probably almost identical if not
the same. Quilted tested with ubuntu fiesty fawn on july 28 2007 WORKS. Note
that Spring 0.75b2 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 scons 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 python2.5-dev zip
sudo aptitude install sun-java6-jdk libvorbis-dev libxcursor-dev
</pre></code>

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

<code><pre>
emerge dev-util/scons \>=media-libs/freetype-2.0.0 \>=media-libs/libsdl-1.2.0
emerge media-libs/openal =dev-lang/python-2.4\* media-libs/glew dev-libs/boost
emerge media-libs/devil app-arch/zip media-libs/libogg
</pre></code>

==== Fedora ====

On Fedora 8, these dependencies should be sufficient:

<code><pre>
yum install scons boost-devel openal-devel SDL-devel \
DevIL-devel glew-devel java-1.7.0-icedtea-devel libvorbis-devel
</pre></code>

Fedora 9 has issues with 0.76b1, because it uses GCC 4.3 which changed a few compilation warnings into errors. However, the [http://spring.clan-sy.com/phpbb/viewtopic.php?f=20&t=12802 inofficial Linux installer] may work for you (it installs a precompiled binary).

=== 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 Scons ====
Configure and build:

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

Install:

<code><pre>
scons install
mkdir -p /etc/spring
echo '$HOME/.spring' > /etc/spring/datadir
</pre></code>

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

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

Install:

<code><pre>
make install
mkdir -p /etc/spring
echo '$HOME/.spring' > /etc/spring/datadir
</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>.

{{Finalizing_linux_install}}

{{Linux_tips}}

{{Troubleshooting_linux}}

Spring - User contributions [en]

Building Spring on Linux