SetupGuide

2006-09-24T21:20:53Z

Evolux: remove gemadata and bitmaps directories

== Linux Setup Guide ==

=== gentoo linux ===
* If you're running [http://www.gentoo.org Gentoo linux], you're lucky, because [http://developer.berlios.de/project/showfiles.php?group_id=4358 an ebuild is already available]. The best way to install the ebuild in gentoo would be to add an portage overlay and copy the file into the overlay. Now in detail: 
:# mkdir /usr/local/portage
:# add this line to you /etc/make.conf PORTDIR_OVERLAY="/usr/local/portage"
:# download the ebuild you want, for example: taspring-linux-release-ebuild-0.72-r1.tar.bz2
:# mv taspring-linux-release-ebuild-0.72-r1.tar.bz2 /usr/local/portage
:# cd /usr/local/portage
:# tar jxvf taspring-linux-release-ebuild-0.72-r1.tar.bz2
:# most likely you don't run a ~x86 system (unstable) so do a: echo "games-strategy/taspring-linux-release ~x86" >> /etc/portage/package.keywords
:# echo "dev-libs/boost threads" >> /etc/portage/package.use
:# You might want to have a look at the USE flags, type: emerge -pv taspring-linux-release
:# finally install it with: emerge taspring-linux-release
:* if you get this error:
:: Calculating dependencies... done!
:: >>> Emerging (1 of 1) games-strategy/taspring-linux-release-0.72-r1 to /
:: >>> checking ebuild checksums ;-)
:: >>> checking auxfile checksums ;-)
:: >>> checking miscfile checksums ;-)
:: >>> checking taspring-linux-data-0.72b1.tar.bz2 ;-)
:: >>> Unpacking source...
::
:: !!! ERROR: games-strategy/taspring-linux-release-0.72-r1 failed.
:: Call stack:
:: ebuild.sh, line 1539: Called dyn_unpack
:: ebuild.sh, line 711: Called src_unpack
:: taspring-linux-release-0.72-r1.ebuild, line 45: Called subversion_src_unpack
:: subversion.eclass, line 278: Called subversion_fetch
:: subversion.eclass, line 127: Called die
:: !!! subversion.eclass: ESVN_REPO_URI is empty.
:: !!! If you need support, post the topmost build error, and the call stack if relevant.
::
:: !!! This ebuild is from an overlay: '/usr/local/portage'
:* Then try: rm -Rf /usr/portage/distfiles/svn-src/spring
:* Afterwards do: emerge taspring-linux-release

=== all other linux distributions ===

In short, to get spring compiled under linux, make sure you've got all necessary development packages installed. On [http://www.ubuntu.com/ (K)Ubuntu linux], and maybe [http://www.debian.org/ Debian] too, this can be done by copying the following in a root terminal (or use the graphical package manager Synaptic or Adept if you can't stand commandline): <code>apt-get install build-essential subversion scons libsdl-dev libopenal-dev libglew-dev libboost-dev libboost-thread-dev libboost-filesystem-dev libboost-regex-dev libdevil-dev libfreetype6-dev python2.4-dev</code> For any other distribution, grab these libraries and the base development packages too (for Gentoo, base development packages aren't needed, because everything is compiled from source: they're already installed). I've no clue about RPM based distros. But [http://www.google.com google] is your friend.

* Grab the latest work-in-progress sourcecode from subversion (using commandline SVN): <code>svn co https://taspring.clan-sy.com/svn/spring/trunk</code> Or look in https://taspring.clan-sy.com/svn/spring/tags/ for the last official release.

* To compile the sourcecode, switch to the trunk directory created by the svn checkout in the previous step. Then type: <code>scons configure</code> to configure the build. (You can fine tune the build by passing options to this command [for enabling debugging/optimizing etc.]. Type <code>scons --help</code> to view the available options.) Now, if you really installed all development package, the scons configure will output: "Everything seems OK. Run `scons' now to build.". If it outputs with an error you're probably missing a development package.

* As instructed on end of previous step, type: <code>scons</code> Spring will now build including [[NTAI]], [[JCAI]] and a few [[GroupAI]]s. You should end up with a file <code>trunk/game/spring</code> (the executable) and some shared objects (SOs or DLLs) in <code>trunk/game/aidll</code>

* Now, grab [https://developer.berlios.de/project/showfiles.php?group_id=4358 the linux data tarball] and extract it somewhere. This will create a directory taspring-linux-data-0.71b1 (or higher version number).

* Put a symlink to the spring executable in the data directory: <code>ln -s /path/to/trunk/game/spring /path/to/taspring-linux-data-0.71b1/spring</code>

* Optionally, make symlinks for the shared objects in <code>trunk/game/aidll too</code>.

* For the current svn version, the directories "gamedata" and "bitmaps" are superseded by content from sdz archives, you should delete these directories from the data directory.

* Now run spring by <code>cd</code>'ing (change dir) to the <code>taspring-linux-data-0.71b1</code> directory and typing: <code>./spring</code> If you've compiled with debugging enabled, you might want to run inside gdb to provide the devs with a backtrace if spring crashes: <code>gdb ./spring</code>
** Basic commands inside gdb are:
*** <code>'''r'''un</code> - Run the program (spring)
*** <code>'''bt'''</code> - Print a backtrace
*** <code>'''q'''uit</code> - Quit
*** <code>'''help'''</code> - This one's important

* Be happy!

Tips:

* Checkout [http://www.fileuniverse.com File Universe] for much more maps & mods.
* If spring hangs/crashes while in full screen mode, you can press ctrl+alt+backspace to restart X, so no need for a reboot.
* A binary release of [[AAI]], a skirmish AI, is included in the data package.
* Spring uses OpenAL for sound, Config your sound output i.e esd / arts / oss / alsa by editing /etc/openalrc or ~/.openalrc, example: ("'(" is not a typo)

<code>
(define devices '(alsa)) 
(define speaker-num 2) 
(define alsa-out-device "hw:0,0") 
(define alsa-in-device "hw:0,0") 
</code>
Adventurous people with an emu10k1 based card (sblive) can try the accelerated openal version. http://www.lost.org.uk/openal.html , don't submit audiobugs if you do.

If you really can't figure out how to get spring compiled, or you think there's a bug in the code or the buildsystem...
* just poke any developer on IRC
** channel <code>#taspring</code> on [http://freenode.net/ FreeNode]
** or channel <code>#sy</code> on [http://www.quakenet.org/ QuakeNet]
* post it on the forum
* or file a bug in our [http://taspring.clan-sy.com/mantis/ Bug tracking system].

[[Category:Linux Port]][[Category:Playing]]

Spring - User contributions [en]

SetupGuide