|
|
(48 intermediate revisions by 6 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; 4 GB or more RAM is recommended.
| + | |
− | | + | |
− | 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.
| + | |
− | | + | |
− | 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 and OSX, most dependencies are available pre-compiled in the [[Compile#FreeOrion SDK|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.47'''
| + | |
− | * [http://www.ogre3d.org/ Ogre 3D] - '''version 1.6.1''' or later. 1.7.3 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.17 ====
| + | |
− | | + | |
− | * [https://sourceforge.net/projects/freeorion/files/FreeOrion/FreeOrion%20Version%200.3.17/ FreeOrion v0.3.17] is FreeOrion SVN revision 4282: '''http://freeorion.svn.sourceforge.net/viewvc/freeorion/trunk/?pathrev=4282''' with GiGi SVN revision 1044: '''http://gigi.svn.sourceforge.net/viewvc/gigi/trunk/?pathrev=1044'''
| + | |
− | | + | |
− | ==== FreeOrion v0.3.16 ====
| + | |
− | | + | |
− | * [https://sourceforge.net/projects/freeorion/files/FreeOrion/FreeOrion%20Version%200.3.16/ FreeOrion v0.3.16] is FreeOrion SVN revision 4046: '''http://freeorion.svn.sourceforge.net/viewvc/freeorion/trunk/?pathrev=4046''' with GiGi SVN revision 1043: '''http://gigi.svn.sourceforge.net/viewvc/gigi/trunk/?pathrev=1043'''
| + | |
− | | + | |
− | ==== 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].
| + | |