Difference between revisions of "Compiling VDrift"

From VDrift
Jump to: navigation, search
(Importing from FAQ, updating)
 
(Moved to Compiling)
 
(106 intermediate revisions by 12 users not shown)
Line 1: Line 1:
Compiling VDrift is different depending on the operating system on which it is compiled.
+
#REDIRECT [[Compiling]]
 
 
==Linux==
 
===Prerequisites===
 
Make sure you have all the required libraries and build tools. Make sure you also have the development files for each of the libraries.
 
====SCons====
 
As of the 2005-10-02 release, VDrift no longer uses ./configure, make, etc. (autotools). Now the project is built with [http://scons.org/ SCons] which is written in Python and makes much better sense than autotools in many ways. You may want to read a little about [[Using SCons]].
 
 
 
There are two ways to use SCons. The first way is to install scons on your system, then you can use it simply by the name of the program, "scons". The second way is to use the scons-local package (included with VDrift) which will do the same thing but doesn't require that you install scons on your system. To do this, you must use the <code>./scons.py</code> command instead of <code>scons</code>.
 
 
 
===Get the Code===
 
You can get the code from a source package for a particular version, or you can get the development version.
 
====Source Package====
 
[http://sourceforge.net/project/showfiles.php?group_id=137283 Download] the latest VDrift Linux source package. All the files in the package are in a directory called vdrift-'''version'''-src where '''version''' is something like 2005-10-02.
 
 
 
Unpack the archive, then enter the directory it creates.
 
 
 
tar jxvf vdrift-2005-10-02-src.tar.bz2
 
cd vdrift-2005-10-02-src
 
 
 
====Development version====
 
You can check out the development version of VDrift from our [http://subversion.tigris.org/ Subversion] repository. See [[Getting the development version]].
 
 
 
Once you've checked out the code, enter the directory Subversion created.
 
cd vdrift
 
 
 
====scons-local====
 
If you have decided not to install SCons on your system, you can use scons-local. To set it up, do the following:
 
 
 
tar zxvf tools/scons-local-0.96.1.tar.gz
 
 
 
{{note|Some of the following steps refer to the <code>scons</code> command, you should now replace that with <code>./scons.py</code>.}}
 
 
 
===Compiling===
 
To compile VDrift, just use the <code>scons</code> command.
 
scons
 
 
 
====Options====
 
You may need to use one or more compile options. To compile with optimization for a certain platform, you can use the '''arch''' option.
 
scons arch=a64
 
Compiling VDrift in '''release''' mode will turn off debugging options, and enbale more compiler optimizations.
 
scons release=1
 
 
 
===Installing===
 
To install, use the SCons build target '''install'''. This command must be run as root.
 
scons install
 
 
 
====Options====
 
There are a few options it's important to know about when installing VDrift. These include the install location, and the amount of data that is installed.
 
To install the full data set you must turn off the '''minimal''' option, which is on by default.
 
scons install minimal=0
 
 
 
You can also change the installation prefix. By default, VDrift is installed to <code>/usr/share/games/vdrift</code>, but if you wanted it to go in <code>/usr/local/share/games/vdrift</code>, you can change the '''prefix''' setting.
 
scons install prefix=/usr/local
 
 
 
{{note|There are many more build and install options, see the [[Using SCons]] page for more information.}}
 

Latest revision as of 13:52, 26 August 2012

Redirect to: