Difference between revisions of "HowTo:Compile from SVN on Linux"

From VsWiki
Jump to: navigation, search
(Compiling: Include cmake)
Line 43: Line 43:
  
 
==Compiling==
 
==Compiling==
 +
 +
Complining can be accomplished with two systems as of now. There's the classic autotools, and the newer (recommended) cmake. If you have cmake installed, you should try it.
 +
 +
===CMake===
 +
 +
Building with CMake is just building with Make, only the configure part can be done interactively, and all intermediate files are tidily put in their own folders:
 +
 +
<pre>
 +
cd ./vegastrike
 +
mkdir build
 +
cd build
 +
ccmake ..  # this will pop up an interactive configuration screen, press "c" to autoconfigure,
 +
          # and once it's done "g" to generate everything and exit.
 +
          # Or edit stuff and follow on-screen instructions if you know what you're doing.
 +
make
 +
</pre>
 +
 +
Now you can run from the build folder:
 +
 +
<pre>
 +
cd ./vegastrike
 +
./build/vegastrike # to play the game
 +
./build/vegastrike --debug=3 # to generate detailled logs for bug reporting
 +
./build/setup/vssetup # to edit game settings
 +
./build/mesh_tool/mesh_tool # mesh converter, for modding
 +
</pre>
 +
 +
===Autotools===
 
The compile procedure should look like the following listing. Remember the configure part depends on above requirements. Though autoconf may not work, if so just skip it.
 
The compile procedure should look like the following listing. Remember the configure part depends on above requirements. Though autoconf may not work, if so just skip it.
 
<pre>
 
<pre>
Line 49: Line 77:
 
./configure --enable-flags='-O3 -g'  # or --enable-debug to disable optimization.  -ffast-math will cause problems in code that checks for infinities. Note that in the first flag there's a capital 'o', not a zero.
 
./configure --enable-flags='-O3 -g'  # or --enable-debug to disable optimization.  -ffast-math will cause problems in code that checks for infinities. Note that in the first flag there's a capital 'o', not a zero.
 
make
 
make
make install # [AS ROOT]
 
 
</pre>
 
</pre>
  
 +
Now you can run from the build folder:
 +
 +
<pre>
 +
cd ./vegastrike
 +
./vegastrike # to play the game
 +
./vegastrike --debug=3 # to generate detailled logs for bug reporting
 +
./vssetup # to edit game settings
 +
./mesher # mesh converter, for modding
 +
</pre>
 +
 +
===Installing===
 +
 +
Installing is not really necessary to play, but you can do it if you wish to have the game accessible to all users. Otherwise, you can play by executing the built binary from the data folder.
 +
 +
If you do want to install, you'll need root access:
 +
 +
<pre>
 +
sudo make install
 +
</pre>
 +
 +
If you plan to install, when you're configuring:
  
 
* To be sure '''set the data dir''' to your vs-data dir:
 
* To be sure '''set the data dir''' to your vs-data dir:

Revision as of 15:39, 9 October 2012

arrow_left.png Compiling with Cygwin arrow_up.png HowTos Compiling from SVN on Mac OSX arrow_right.png

How to compile from SVN under Linux.

See also: HowTo:Cygwin Compiling, HowTo:VCPP Compiling, HowTo:Checkout SVN (Ubuntu Linux)

Getting the SVN-files

Requirements

In order to compile Vegastrike there are a few things to check:

  • Make sure you have these packages installed ...
    • make
    • gcc
    • automake at least version 1.6
    • autoconf at least version 2.53
    • X11...
    • libpng + libpng-devel <-- libpng 3 is recommended.
    • python and python-dev <-- 2.2.1
    • expat + expat-devel
    • (lib)jpeg + libjpeg-devel
    • opengl (see below) (you probably already have it)
    • glut + glut-devel
    • openal + openal-devel
    • libgtk2.0 + libgtk2.0-devel
    • libfreeimage3 (vegastrike itself can compile without it, but mesher can't)

This probably should do the trick in debian/ubuntu (copy and paste the entire code into terminal):

sudo apt-get install libpng12-0 libpng12-dev python-dev libexpat1-dev     \
        libjpeg62-dev glutg3-dev libopenal-dev libgtk2.0-dev libogg-dev libvorbis-dev \
        build-essential libgl1-mesa-dev automake autoconf

Compiling

Complining can be accomplished with two systems as of now. There's the classic autotools, and the newer (recommended) cmake. If you have cmake installed, you should try it.

CMake

Building with CMake is just building with Make, only the configure part can be done interactively, and all intermediate files are tidily put in their own folders:

cd ./vegastrike
mkdir build
cd build
ccmake ..  # this will pop up an interactive configuration screen, press "c" to autoconfigure, 
           # and once it's done "g" to generate everything and exit. 
           # Or edit stuff and follow on-screen instructions if you know what you're doing.
make

Now you can run from the build folder:

cd ./vegastrike
./build/vegastrike # to play the game
./build/vegastrike --debug=3 # to generate detailled logs for bug reporting
./build/setup/vssetup # to edit game settings
./build/mesh_tool/mesh_tool # mesh converter, for modding

Autotools

The compile procedure should look like the following listing. Remember the configure part depends on above requirements. Though autoconf may not work, if so just skip it.

cd ./vegastrike
./bootstrap-sh
./configure --enable-flags='-O3 -g'  # or --enable-debug to disable optimization.  -ffast-math will cause problems in code that checks for infinities. Note that in the first flag there's a capital 'o', not a zero.
make

Now you can run from the build folder:

cd ./vegastrike
./vegastrike # to play the game
./vegastrike --debug=3 # to generate detailled logs for bug reporting
./vssetup # to edit game settings
./mesher # mesh converter, for modding

Installing

Installing is not really necessary to play, but you can do it if you wish to have the game accessible to all users. Otherwise, you can play by executing the built binary from the data folder.

If you do want to install, you'll need root access:

sudo make install

If you plan to install, when you're configuring:

  • To be sure set the data dir to your vs-data dir:
./configure --with-data-dir=<DIR> ........
  • When using libpng 1.2,
--with-png-inc=<DIR>

is needed. An example is

--with-png-inc=/usr/include/libpng12/
  • If you don't want to compile with GTK just turn it off, however you will not get a setup program if you do this:
./configure --disable-gtk ...........
  • If you only want the server, and want to disable all GUI components--This removes the dependency on X11, OpenGL, SDL, GLUT, OpenAL.
./configure --disable-client ...........
  • See this thread about boost versions. Set this option to 1.28, 1.29, 1.33, or "system" if the default does not compile.
./configure --with-boost=<VER> ...........

You will likely receive some error messages during any of these stages, especially during the configure part. If they tell you that your system is missing some development libraries, install them. How this is done depends on your Linux distribution, but we will assist you in the Compiling Problems forums. You will be left with a file called "config.log" please attach that instead of copy-and-pasting thousands of lines of error messages. It's all in this file.

After you installed the missing libraries repeat the last (failed) step and continue.


Note: The configure script currently has a bug that can cause it to incorrectly report on the absence of GLUT. If you are sure you have installed glut-devel and are still seeing this error, check near the end of config.log to see if another library (such as libxmu or libxi) is the true culprit. [1]


Make

The final step for compiling is the make command. The Makefile should be able to compile most of the included utilities.

To compile mesher, for example, type:

make mesher
  • Running
make all-am

reduces memory usage while compiling because there's only one instance of make instead of two. From this forum thread.

  • The step
make install

is optional as the program is quite happy running in userland.

If you receive error without any mention of missing library (or something like) after very long line about running g++, try to set proper permissions or simply force your way through it and see whether it's your problem (if you're superuser). It looks like that:

collect2: ld returned 1 exit status
make[1]: *** [vegastrike] Error 1
make[1]: Leaving directory `/home/username/Games/VegaStrike/vegastrike'
make: *** [all] Error 2
~/Games/VegaStrike/vegastrike$ sudo make

See also


arrow_left.png Compiling with Cygwin arrow_up.png HowTos Compiling from SVN on Mac OSX arrow_right.png