Difference between revisions of "Compile In Windows"
(→Software Dependencies) |
(Updated instructions for use with the April 2015 SDK version.) |
||
| Line 1: | Line 1: | ||
| − | == | + | ==Prerequisites== |
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
===Compiler=== | ===Compiler=== | ||
| Line 15: | Line 9: | ||
If you are a student, you may also be eligible for [http://www.dreamspark.com Microsoft Dreamspark], which will give you the Professional version of MSVC 2010 or several other Microsoft programs. | If you are a student, you may also be eligible for [http://www.dreamspark.com Microsoft Dreamspark], which will give you the Professional version of MSVC 2010 or several other Microsoft programs. | ||
| − | Also, if you are a student you should check out if your university takes part in the MSDNAA (Microsoft Developers Network Academic Alliance). You might be able to get Visual Studio 2010 Ultimate and other very pricy software for free or at some places a small administrative fee (like 5€ to get access for a semester) | + | Also, if you are a student you should check out if your university takes part in the MSDNAA (Microsoft Developers Network Academic Alliance). You might be able to get Visual Studio 2010 Ultimate and other very pricy software for free or at some places a small administrative fee (like 5€ to get access for a semester). |
| + | |||
| + | ===Version Control System=== | ||
| + | |||
| + | The FreeOrion project uses [http://en.wikipedia.org/wiki/Git_%28software%29 Git] for version control. To be able to use the SDK, you need to install the git command line client (the most recent release for Windows can be downloaded [http://git-scm.com/download/win here]). '''Important:''' When installing the git command line client, be sure to select the option that will include the git executable in your command path, otherwise the batch script which sets up the SDK will fail. | ||
| + | |||
| + | ==Compilation Instructions== | ||
| + | |||
| + | ===Step by Step=== | ||
| + | |||
| + | # First, get the [http://sourceforge.net/projects/freeorion/files/FreeOrion%20SDK FreeOrion SDK] for Windows from SourceForge. (~30MB) | ||
| + | # Unpack the SDK to a directory of your choice. | ||
| + | # Run the ''bootstrap.bat'' file located in the root folder of the unpacked SDK. This will download and check out the source code from GitHub ([https://github.com/freeorion/freeorion freeorion/freeorion] repository, checked out branch will be "master"). | ||
| + | # Open FreeOrion\msvc2010\FreeOrion.sln | ||
| + | # Use Build->Build Solution to build all projects' release targets. | ||
| + | |||
| + | Compilation may take some time: ~1 hour on Core i3 370M with 6GB RAM, ~20 min on Core i7 4710HQ with 8 GB RAM. | ||
===Software Dependencies=== | ===Software Dependencies=== | ||
| + | |||
The majority of FreeOrion dependencies can be found precompiled and packaged in the FreeOrion Windows SDK, from the [http://sourceforge.net/projects/freeorion/files/FreeOrion%20SDK/ SourceForge FreeOrion SDK page]. | The majority of FreeOrion dependencies can be found precompiled and packaged in the FreeOrion Windows SDK, from the [http://sourceforge.net/projects/freeorion/files/FreeOrion%20SDK/ SourceForge FreeOrion SDK page]. | ||
| Line 23: | Line 34: | ||
==Runtime Errors== | ==Runtime Errors== | ||
| + | |||
Please report runtime errors in the [http://www.freeorion.org/forum/viewtopic.php?f=9&t=1787 forums]. | Please report runtime errors in the [http://www.freeorion.org/forum/viewtopic.php?f=9&t=1787 forums]. | ||
Revision as of 10:54, 10 April 2015
Contents
Prerequisites
Compiler
FreeOrion can be compiled on Windows with the Visual Studio 2010. Premade Visual Studio 2010 project files are available in the source code repoistory, and the SDK provides precompiled dependencies for this compiler. Project files may also be generated using CMake.
Visual Studio 2010 Express Edition may be downloaded for trial from Microsoft. If that link doesn't work even in IE, than use this English link. But after 30 days you have to register for free.
If you are a student, you may also be eligible for Microsoft Dreamspark, which will give you the Professional version of MSVC 2010 or several other Microsoft programs.
Also, if you are a student you should check out if your university takes part in the MSDNAA (Microsoft Developers Network Academic Alliance). You might be able to get Visual Studio 2010 Ultimate and other very pricy software for free or at some places a small administrative fee (like 5€ to get access for a semester).
Version Control System
The FreeOrion project uses Git for version control. To be able to use the SDK, you need to install the git command line client (the most recent release for Windows can be downloaded here). Important: When installing the git command line client, be sure to select the option that will include the git executable in your command path, otherwise the batch script which sets up the SDK will fail.
Compilation Instructions
Step by Step
- First, get the FreeOrion SDK for Windows from SourceForge. (~30MB)
- Unpack the SDK to a directory of your choice.
- Run the bootstrap.bat file located in the root folder of the unpacked SDK. This will download and check out the source code from GitHub (freeorion/freeorion repository, checked out branch will be "master").
- Open FreeOrion\msvc2010\FreeOrion.sln
- Use Build->Build Solution to build all projects' release targets.
Compilation may take some time: ~1 hour on Core i3 370M with 6GB RAM, ~20 min on Core i7 4710HQ with 8 GB RAM.
Software Dependencies
The majority of FreeOrion dependencies can be found precompiled and packaged in the FreeOrion Windows SDK, from the SourceForge FreeOrion SDK page.
The SDK includes compiled libraries, headers and DLLs for: zlib, Python, Boost, FreeType, GLEW, libpng, libjpeg, OpenAL, ALUT, libvorbis, and libogg, SDL2.
Runtime Errors
Please report runtime errors in the forums.
