Difference between revisions of "Compile"

From FreeOrionWiki
Jump to: navigation, search
(Software requirements)
(Remove most content; just link to github build instructions)
 
(56 intermediate revisions by 7 users not shown)
Line 1: Line 1:
 
Currently, [[FreeOrion]] will compile in most recent Windows, Linux, and MacOSX.  The *BSD genus of operating systems might also work; follow the Linux instructions in this case.
 
Currently, [[FreeOrion]] will compile in most recent Windows, Linux, and MacOSX.  The *BSD genus of operating systems might also work; follow the Linux instructions in this case.
  
==Overview==
+
Consult the [https://github.com/freeorion/freeorion/blob/master/BUILD.md build instructions] in the project git repository.
First of all, you will need to obtain the [[source]].  This can be grabbed from our [[project page]] or from Subversion (SVN).  The versions available on the [[project page]] are official releases or point releases, and may be somewhat or very out of date.  To help with [[programming]] [[FreeOrion]], you will need to grab the SVN copy.  Then you need to set up the required software, compile the game, download the missing artwork, and run it.
+
 
+
 
+
==Hardware requirements==
+
The FreeOrion code makes heavy use of templates, and requires much memory to compile; 2 GB or more RAM is reccomended.
+
 
+
On Linux, shutting down your X server and compiling from console may help on systems with little RAM.  (If this doesn't mean anything to you, simply ignore this advice.)
+
 
+
You will also need a fast processor.  To build GG and FreeOrion, expect up to 45 minutes of a Core i5 system, or over an hour on a Core2 Duo system.
+
 
+
At least 2 GB of free disk space is also recommended.
+
 
+
Note that, while not required to compile FreeOrion, running the FreeOrion client requires a graphics card and drivers that support OpenGL 2.0.
+
 
+
==Software requirements==
+
'''Note: On Windows, most dependencies are available pre-compiled in the FreeOrion SDK.'''
+
 
+
* [[GiGi]] - Latest version from [http://sourceforge.net/svn/?group_id=84040 SourceForge SVN] will automatically be included in the FreeOrion/GG directory when checking out the FreeOrion Subversion archive
+
* [http://www.boost.org/ Boost] - '''version 1.44'''
+
* [http://www.ogre3d.org/ Ogre 3D] - '''version 1.6.1''' or later.  1.7.2 is known to work.
+
* [http://code.google.com/p/bullet/downloads/list Bullet]  - '''version 2.73 or later.''' 2.77 is known to work.
+
* [http://www.freetype.org FreeType2] - a GiGi dependency.  version 2.4.3 is known to work.
+
* [http://www.python.org/download/ Python] - '''version 2.5 or later''' ('''version 2.x only; 3.x will not work''')
+
* [http://www.openal.org/downloads.html OpenAL and ALUT] - freealut 1.1.0 is known to work.
+
* [http://xiph.org/downloads/ libogg] - '''version 1.1.3 or later''' 1.2.1 is known to work.
+
* [http://xiph.org/downloads/ libvorbis] - '''version 1.1.2 or later''' 1.3.2 is known to work.
+
* [http://glew.sourceforge.net/ GLEW] - (Windows only) version 1.5.7 is known to work.
+
* [http://www.zlib.net/ zlib] - version 1.2.5 is known to work with libpng 1.4.4
+
* [http://www.libpng.org/pub/png/libpng.html libpng] - ''' versions 1.2 and 1.4 work'''
+
 
+
==Getting the source==
+
 
+
===Subversion===
+
 
+
The source code can be obtained from the sourceforge Subversion server, using this command from the Linux command prompt:
+
 
+
svn co https://freeorion.svn.sourceforge.net/svnroot/freeorion/trunk freeorion
+
 
+
For Windows, a graphical shell-extension SVN client, such as [http://tortoisesvn.tigris.org/ TortoiseSVN] is recommended, with which the source can be obtained from ''https://freeorion.svn.sourceforge.net/svnroot/freeorion''.
+
===FreeOrion SDK===
+
Alternatively, you can download the [http://sourceforge.net/projects/freeorion/files/FreeOrion%20SDK/ FreeOrion SDK] (Windows and MacOSX) and update that directory tree with SVN.
+
 
+
===Tarballs===
+
 
+
The SourceForge Subversion web-client allows one to download numbered versions of the source code as a tarball.
+
 
+
The latest version can be obtained from the '''Download GNU tarball''' link on the bottom of this page: ''http://freeorion.svn.sourceforge.net/viewvc/freeorion/trunk/FreeOrion/''
+
 
+
You can also download source versions corresponding to previous releases:
+
 
+
==== FreeOrion v0.3.15 ====
+
 
+
* [https://sourceforge.net/projects/freeorion/files/FreeOrion/FreeOrion%20Version%200.3.15/ FreeOrion v0.3.15] is FreeOrion SVN revision 3727: '''http://freeorion.svn.sourceforge.net/viewvc/freeorion/trunk/?pathrev=3727''' with GiGi SVN revision 813: '''http://gigi.svn.sourceforge.net/viewvc/gigi/trunk/?pathrev=813'''
+
 
+
==== FreeOrion v0.3.14 ====
+
 
+
* [https://sourceforge.net/projects/freeorion/files/FreeOrion/FreeOrion%20Version%200.3.14/ FreeOrion v0.3.14] is FreeOrion SVN revision 3571: '''http://freeorion.svn.sourceforge.net/viewvc/freeorion/trunk/?pathrev=3571''' with GiGi SVN revision 812: '''http://gigi.svn.sourceforge.net/viewvc/gigi/trunk/?pathrev=812'''
+
 
+
==== FreeOrion v0.3.13 ====
+
 
+
* [https://sourceforge.net/project/showfiles.php?group_id=75752&package_id=111134&release_id=685272 FreeOrion v0.3.13]
+
** '''On Windows''' is FreeOrion SVN revision 3094: '''http://freeorion.svn.sourceforge.net/viewvc/freeorion/trunk/?pathrev=3094''' with GiGi SVN revision 756: '''http://gigi.svn.sourceforge.net/viewvc/gigi/trunk/?pathrev=756'''
+
** '''On Linux''' is FreeOrion SVN revision 3103: '''http://freeorion.svn.sourceforge.net/viewvc/freeorion/trunk/?pathrev=3103''' with GiGi SVN revision 757: '''http://gigi.svn.sourceforge.net/viewvc/gigi/trunk/?pathrev=757'''
+
** '''On Mac OSX''' is FreeOrion SVN revision 3094: '''http://freeorion.svn.sourceforge.net/viewvc/freeorion/trunk/?pathrev=3094''' with GiGi SVN revision 757: '''http://gigi.svn.sourceforge.net/viewvc/gigi/trunk/?pathrev=757'''
+
 
+
==== FreeOrion v0.3.12.1 '''for Linux''' ====
+
* [https://sourceforge.net/project/showfiles.php?group_id=75752&package_id=111134&release_id=660507 FreeOrion v0.3.12.1 '''for Linux'''] is SVN revision 2918: '''http://freeorion.svn.sourceforge.net/viewvc/freeorion/trunk/?pathrev=2918''' with GiGi revision 711: '''http://gigi.svn.sourceforge.net/viewvc/gigi/?pathrev=711'''
+
 
+
==== FreeOrion v0.3.12 '''for Windows''' ====
+
* [https://sourceforge.net/project/showfiles.php?group_id=75752&package_id=111134&release_id=660507 FreeOrion v0.3.12 '''for Windows'''] is SVN revision 2807: '''http://freeorion.svn.sourceforge.net/viewvc/freeorion/trunk/?pathrev=2807''' with GiGi revision 710: '''http://gigi.svn.sourceforge.net/viewvc/gigi/?pathrev=710'''
+
 
+
==== FreeOrion v0.3.11 ====
+
* [https://sourceforge.net/project/showfiles.php?group_id=75752&package_id=111134&release_id=652545 FreeOrion v0.3.11]
+
** '''On Windows''' is SVN revision 2729 '''http://freeorion.svn.sourceforge.net/viewvc/freeorion/trunk/FreeOrion/?pathrev=2729''' with GiGi revision 695: '''http://gigi.svn.sourceforge.net/viewvc/gigi/trunk/GG/?pathrev=695'''
+
** '''On Linux''' is SVN revision 2732 '''http://freeorion.svn.sourceforge.net/viewvc/freeorion/trunk/FreeOrion/?pathrev=2732''' with GiGi revision 695: '''http://gigi.svn.sourceforge.net/viewvc/gigi/trunk/GG/?pathrev=695'''
+
 
+
==== FreeOrion v0.3.10 ====
+
* [https://sourceforge.net/project/showfiles.php?group_id=75752&package_id=111134&release_id=609273 FreeOrion v0.3.10] is SVN revision 2607: '''http://freeorion.svn.sourceforge.net/viewvc/freeorion/trunk/FreeOrion/?pathrev=2607''' with GiGi revision 651: '''http://gigi.svn.sourceforge.net/viewvc/gigi/trunk/GG/?pathrev=651'''
+
 
+
==Compilation==
+
Compilation instructions and troubleshooting tips are available for the following operating systems:
+
* [[Compile_In_Linux|Linux]]
+
* [[Compile_In_Windows|Windows]]
+
* [[Compile_In_MacOsX|MacOS X]]
+
* For BSD, consult the Linux instructions, and possibly [http://www.freeorion.org/forum/viewtopic.php?p=36318#p36318 this forum thread].
+

Latest revision as of 14:39, 22 April 2020

Currently, FreeOrion will compile in most recent Windows, Linux, and MacOSX. The *BSD genus of operating systems might also work; follow the Linux instructions in this case.

Consult the build instructions in the project git repository.