|
|
(71 intermediate revisions by 8 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; at least 1 GB of 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. Expect more than one hour for a first-time build on a 2 GHz processor (after building GG and any other necessary dependencies).
| + | |
− | | + | |
− | 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.42''' (Other versions may also work)
| + | |
− | * [http://www.ogre3d.org/ Ogre 3D] - '''version 1.6.1''' or later. 1.7 is known to work.
| + | |
− | * [http://www.bulletphysics.com/Bullet/wordpress/ Bullet] - '''version 2.73'''
| + | |
− | * [http://www.freetype.org FreeType2] - a GiGi dependency
| + | |
− | * [http://www.python.org/download/ Python] - '''version 2.4 or later''' ('''version 2.5 if using the FreeOrion Windows SDK''') ('''version 2.x only; 3.x will not work''')
| + | |
− | * [http://www.openal.org/downloads.html OpenAL and ALUT]
| + | |
− | * [http://xiph.org/downloads/ libogg] - '''version 1.1.3'''
| + | |
− | * [http://xiph.org/downloads/ libvorbis] - '''version 1.1.2'''
| + | |
− | * [http://www.graphviz.org/ GraphViz] - '''version 2.8''' ('''version < 2.22''' on Linux)
| + | |
− | * [http://glew.sourceforge.net/ GLEW] - (Windows only)
| + | |
− | * [http://www.zlib.net/ zlib]
| + | |
− | * [http://www.libpng.org/pub/png/libpng.html libpng] - ''' version 1.2 works, or there is [http://www.freeorion.org/forum/viewtopic.php?p=44430#p44430 a patch] for 1.4'''
| + | |
− | | + | |
− | ==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''.
| + | |
− | | + | |
− | Alternatively, you can download the [http://sourceforge.net/project/showfiles.php?group_id=75752&package_id=236893 FreeOrion Windows SDK] 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].
| + | |