Difference between revisions of "Getting the FreeSpace2: SCP Source Code"

From FreeSpace Wiki
Jump to: navigation, search
(Windows: Suppose these pictures go here?)
(Windows)
 
(3 intermediate revisions by one other user not shown)
Line 1: Line 1:
'''IMPORTANT NOTES:'''
+
{{Note| In April 2015, the SCP team transitioned the source code repository from SVN-based to GitHub-based (Git).}}
 
 
On March 2008, the SCP team has changed the repository server from CVS based to SVN based.
 
 
 
Some terms have also changed with the new repository server:
 
*'''The stable branch''' (old CVS) is now called '''Trunk''' (new SVN).
 
*'''HEAD revision''' (new SVN) is latest version. Do not confuse it with '''the unstable branch''', also called '''HEAD branch''', in old CVS.
 
 
 
  
  
 
==Windows==
 
==Windows==
  
''Ported from karajorma's [http://www.hard-light.net/forums/index.php/topic,52845.0.html thread] on the [http://www.hard-light.net/forums/index.php HLP Forums].''
+
Documentation is available on [[Guide_to_FS_Open_and_git|this page]] under the section [[Guide_to_FS_Open_and_git#Getting_the_source:_Tortoise_Git|Getting the Source]]
 
 
Here's how you set things up:
 
 
 
*Go to the [http://tortoisesvn..or/ Tortoise SVN homepage] and download the latest version.
 
*Install it. You'll probably have to restart your PC afterwards.
 
*Make a new folder on your HD where you'd like to install the code. You'll need a fair bit of space for the code + the intermediate files when building it. Press right mouse and choose SVN Checkout from the list.
 
[[Image:CheckingOutSVN1.jpg]]
 
*An new window will open up. Cut and paste this into the URL of repository box:<br>'''svn://svn.icculus.org/fs2open/trunk/fs2_open'''
 
*By default the HEAD revision will be selected. You probably don't want to change this. Your screen should now look like this:
 
[[Image:CheckingOutSVN2.jpg]]
 
*Press OK to begin downloading from the repository.
 
 
 
It's pretty easy. It shouldn't take you more than a minute or two to do once you've installed Tortoise.
 
  
 
== Mac ==
 
== Mac ==
Line 32: Line 12:
 
== Unixes ==
 
== Unixes ==
  
With a fresh Ubuntu 12.10 (latest) install, you will need to install the following packages.  Other distributions will vary on which packages need to be installed on top of the base install.
+
Please see the [[Guide_to_FS_Open_on_Linux|Linux Development Guide]].
* build-essential
 
* subversion
 
* autoconf
 
* automake
 
* libsdl1.2-dev
 
* libogg-dev
 
* libvorbis-dev
 
* libtheora-dev
 
* lua5.1
 
* liblua5.1-0-dev
 
* libjpeg-dev
 
 
 
To checkout the fs2_open repsoitory :
 
svn checkout svn://svn.icculus.org/fs2open/trunk/fs2_open
 
 
 
After checkout, autogen the makefiles
 
cd fs2_open
 
./autogen.sh
 
 
 
To build a debug build :
 
cd fs2_open
 
./autogen.sh --enable-debug
 
 
 
To build with custom CFLAGS :
 
cd fs2_open
 
./autogen.sh "CFLAGS={Your CFLAGS Here}"
 
Note that the quotes are required
 
 
 
Building with custom CFLAGS for machine specific binaries (such as -march=native -mtune=native), may be unstable and unsupported.  Use at your own risk.
 
 
 
 
 
After makefile autogen is complete, run 'make' to actually build the executable.  Use the -j option to compile faster.  It causes make to use multiple cores instead of 1.
 
make -j 4
 
The number after '-j' should be the number of logical processors (physical + hyperthread)
 
 
 
 
 
 
 
After compiling completes, the executable is placed at $(FSO_BUILD_DIR)/code/fs2_open.M.m.vv (currently 3.6.19)
 
 
 
Copy this file to your fs2_open installation directory (your path will vary).  You may need root permission to copy the file.
 
sudo cp ./code/fs2_open_3.6.19 /usr/share/games/freespace2
 
  
  
  
 
[[Category:Source Code Project]]
 
[[Category:Source Code Project]]

Latest revision as of 22:59, 23 May 2015

Note: In April 2015, the SCP team transitioned the source code repository from SVN-based to GitHub-based (Git).


Windows

Documentation is available on this page under the section Getting the Source

Mac

Please see the Mac Development Guide.

Unixes

Please see the Linux Development Guide.