Getting started with development - Philbywhizz/pioneer GitHub Wiki

Getting the Code

Pioneer is managed using Git, and is stored here on Github. The official repository is the best one to get. To get it:

git clone git://github.com/pioneerspacesim/pioneer.git

This will get you on the "master" branch, which is where new code is merged. This is the latest and greatest development and is quite unstable. To build a specific alpha, you need to checkout the appropriate release tag:

git checkout alpha9

Compiling Pioneer on Windows

An MSVC 2008 project file can be found in the win32/vc2008 folder. Open this project file and Pioneer should build just fine. All dependencies are provided so you don't need to compile any libraries.

Copy the .dll files from win32/vc2008 into the root folder (the one containing data, src, win32 directories), and you will be able to run the pioneer .exe file you just compiled.

Compiling Pioneer on Linux

Requirements

libtool
sigc++-2.0
freetype2
GL and GLU
GLEW
SDL 1.2
SDL_image_

Since pioneer is currently only available from the source repository, you also need autoconf and automake in order to generate the ./configure script (by running ./bootstrap)

You also need git to check the source code out from the repository.

Ubuntu 10.04 command to install all the requisite libraries

sudo apt-get install libsigc++-2.0-dev libglut3-dev libglew1.5-dev libsdl1.2-dev libvorbis-dev libsdl-image1.2-dev dh-autoreconf git libfreetype6-dev

This may work on other versions of Ubuntu, and possibly Debian or their derivatives too.

Building it

./bootstrap
./configure
make
ln -s ../data ./src/data

Currently Pioneer runs from where it is built, and doesn't require (or work with) '''make install'''. To run it:

./src/pioneer

Debugging

For developers, gdb can be used for debugging

gdb ./src/pioneer
run

Bugs, and feature requests, should be logged on the issue tracker.