Spring - User contributions [en]

Building Spring on Windows

2015-01-02T05:09:42Z

Super mario:

[[Engine_Development|Development]] < [[Building_spring|Building Spring]] < {{FULLPAGENAME}}
{{#css:
code * {margin:inherit;}
}}

If you only want to produce your own Spring game and not contribute to the core engine, compilation is not necessary. Check out [[Gamedev:Main]].

Warning: Of the active developers nobody uses windows for developing. So they might not be able to help as effectively as on Linux. Thus compiling on windows is rarely tested and possibly leads to some unintentional errors.

If you do wish to use Windows, the best place to get real-time help is the #sy lobby channel, or #sy on [[IRC]].

=Compiling with MinGW=

== Requirements ==
Install [http://www.cmake.org/ CMake] and [http://msysgit.github.io/ msysGit] and MinGW-w64:

When installing msysGit you should select the option to "Run Git from the Windows Command Prompt":

[[File:Msysgit6.png|400px]]

This is in order to automatically add Git to PATH making it easy for CMake to find.

== Installing MinGW-w64 ==

Download and run the "Mingw-builds project - native toolchains using trunk" installer from [http://mingw-w64.sourceforge.net/download.php MinGW-w64].

Select the following options:

[[File:InstallingMinGW-w64.png|400px]]

* '''Version:''' Any version above 4.8.x should work, 4.9.x+ may not have been tested as thoroughly.
* '''Architecture:''' i686
* '''Threads:''' posix
* '''Exception:''' sjlj This is the only setting which needs to be changed from the default
* '''Build Revision:''' The latest one

== Adding to PATH ==

Once installed, you should add the MinGW directory to your PATH variable so that Cmake can find the relevant binaries.

* Go to System properties (either via Control Panel\System and Security\System or by right clicking 'Computer' on the desktop), then click 'Advanced System Settings'.
* Click the 'Environment Variables' button at the bottom.
* Find Path in the 'System Variables' scrollbox, add an extra <code>;</code> to the end and then copy-paste in the MinGW directory (e.g. default is <code>C:\Program Files (x86)\mingw-w64\i686-4.9.1-posix-sjlj-rt_v3-rev0\mingw32\bin</code>).
* Alternative instructions with images are easy to find online, for example [http://geekswithblogs.net/renso/archive/2009/10/21/how-to-set-the-windows-path-in-windows-7.aspx here].

= Get the Source Code =

* use git's bash (you find it in the right click context menu when clicking the folder), <code>cd</code> into your spring source dir

<code><pre>
git clone --recursive git://github.com/spring/spring.git -b develop
cd spring
git clone https://github.com/spring/mingwlibs
</pre></code>

* update it from time to time with: <code>git pull --rebase</code>

* Make sure you install the package in the checkout directory, so the path is: /spring/mingwlibs. If done right, it will look like:
** */spring/
** */spring/...
** */spring/mingwlibs
** */spring/rts

* Note: if you install the package somewhere else (preferably outside of the source tree), and pass its location with the ''MINGDIR'' option to CMake in the configure step (see further down, in the quick instructions).

== configure using CMake ==

* run the ''cmake-gui'' and select a source and a build directory
* configure and follow the instructions, and adjust variables to your needs (defaults are OK)
* press '''Generate'''
* open a console (''cmd.exe''), ''cd'' into your '''build''' directory
* ''optional:'' for multi-threaded compilation, the ''mingw32-make'' part may differ on your system: <code>''<pre>set MAKE_COMMAND=mingw32-make -j2</pre>''</code> (use -j4 for 4 threads)
* compile with: <code>''<pre>mingw32-make install-spring</pre>''</code>
* compile just the engine (spring.exe) with: <code>''<pre>mingw32-make engine-legacy</pre>''</code>

===Generating the AI Sources/Wrappers===

you can either build the wrapper:

<code>make Cpp-AIWrapper</code>

or generate all sources, in case you don't need the binary:

<code>make generateSources</code>

===Possible Problems===
* If you get undefined reference to `_Unwind_Resume' linking errors, deinstall ''whole'' MinGW and reinstall it with ''sjlj''.

* When you installed an old version of MinGW/TDM and forgot to deinstall it correctly, <code>gcc.exe</code> & <code>g++.exe</code> will be named <code>gcc-dw2.exe</code>/<code>g++-dw2.exe</code>. CMake will then fail to find the correct one, first try to deinstall anything mingw related and reinstall everything. If that didn't helped just rename the files. If even that doesn't help open cmake-gui and click the advanced button and set the paths to the correct files yourself (<code>CMAKE_C_COMPILER</code> & <code>CMAKE_CXX_COMPILER</code>).

=== Notes ===

You can still use Visual Studio 2012 as described below to edit the code. This is very useful because it allows excellent code navigation, and it highlights syntax errors and trivial mistakes before compiling.

For debugging mingw builds, you can aquire a windows build of gdb from http://www.equation.com/servlet/equation.cmd?fa=gdb

To start debugging, copy ''gdb.exe'' to your build output directory, and launch it with ''gdb spring.exe''. You can supply command line arguments to ''spring.exe'' with ''gdb --args spring.exe myreplayfile.sdf''

=Compiling with Visual Studio (not officially supported!)=
Currently Visual Studio lacks some c++ features it doesn't compile spring!

==General Visual Studio Notes==
When developing using Visual Studio keep in mind:
*It's experimental and not proved to compile or run!
*Your VS build won't sync with GCC builds in multiplayer mode
*AIs built with Visual Studio will work with the mingw32 release builds thanks to the C AI Interface, however this interface may change when newer releases are made
*Running any non-LUA AI on VS built Spring will crash it

===2012 (v11)===

Install [http://www.microsoft.com/visualstudio/eng/downloads#d-express-windows-desktop Visual Studio 2012 Express for Windows Desktop], [http://www.microsoft.com/en-us/download/confirmation.aspx?id=35515 Visual C++ Compiler November 2012 CTP], [http://www.cmake.org/ cmake], [http://www.7-zip.org 7-zip] and [http://msysgit.github.io/ msysgit].

From the Startmenu run "VS2012 x86 Native Tools Command Prompt" and type:

<code><pre>
set PATH=%PATH%;%PROGRAMFILES%\git\bin;%PROGRAMFILES%\cmake 2.8\bin\
git clone git://github.com/spring/spring.git
cd spring
git clone git://github.com/spring/vclibs11.git vclibs
cmake -G "Visual Studio 11" .
</pre></code>

Now start visual studio & open Spring.sln. Select "engine-legacy" as default project, as AIs and ofter stuff are known to fail to compile on visual studio.

In the Project Properties, make sure to [http://stackoverflow.com/questions/13238408/variadic-template-in-vs-2012-visual-c-november-2012-ctp select the Microsoft Visual C++ Compiler Nov 2012 CTP].

Note: Visual Studio 2012 Express for Windows Desktop is for free, but requires a registration after 30 days (to get a free license).

[[Category:Compiling]]

Building Spring on Windows

2015-01-02T05:08:36Z

Super mario: Remove subjective option concerning the reasoning of the warning

[[Engine_Development|Development]] < [[Building_spring|Building Spring]] < {{FULLPAGENAME}}
{{#css:
code * {margin:inherit;}
}}

If you only want to produce your own Spring game and not contribute to the core engine, compilation is not necessary. Check out [[Gamedev:Main]].

Warning: Of the active developers nobody uses windows for developing. So they might not be able to help as effectively as on Linux. Thus compiling on windows is rarely tested possibly leads to some unintentional errors.

If you do wish to use Windows, the best place to get real-time help is the #sy lobby channel, or #sy on [[IRC]].

=Compiling with MinGW=

== Requirements ==
Install [http://www.cmake.org/ CMake] and [http://msysgit.github.io/ msysGit] and MinGW-w64:

When installing msysGit you should select the option to "Run Git from the Windows Command Prompt":

[[File:Msysgit6.png|400px]]

This is in order to automatically add Git to PATH making it easy for CMake to find.

== Installing MinGW-w64 ==

Download and run the "Mingw-builds project - native toolchains using trunk" installer from [http://mingw-w64.sourceforge.net/download.php MinGW-w64].

Select the following options:

[[File:InstallingMinGW-w64.png|400px]]

* '''Version:''' Any version above 4.8.x should work, 4.9.x+ may not have been tested as thoroughly.
* '''Architecture:''' i686
* '''Threads:''' posix
* '''Exception:''' sjlj This is the only setting which needs to be changed from the default
* '''Build Revision:''' The latest one

== Adding to PATH ==

Once installed, you should add the MinGW directory to your PATH variable so that Cmake can find the relevant binaries.

* Go to System properties (either via Control Panel\System and Security\System or by right clicking 'Computer' on the desktop), then click 'Advanced System Settings'.
* Click the 'Environment Variables' button at the bottom.
* Find Path in the 'System Variables' scrollbox, add an extra <code>;</code> to the end and then copy-paste in the MinGW directory (e.g. default is <code>C:\Program Files (x86)\mingw-w64\i686-4.9.1-posix-sjlj-rt_v3-rev0\mingw32\bin</code>).
* Alternative instructions with images are easy to find online, for example [http://geekswithblogs.net/renso/archive/2009/10/21/how-to-set-the-windows-path-in-windows-7.aspx here].

= Get the Source Code =

* use git's bash (you find it in the right click context menu when clicking the folder), <code>cd</code> into your spring source dir

<code><pre>
git clone --recursive git://github.com/spring/spring.git -b develop
cd spring
git clone https://github.com/spring/mingwlibs
</pre></code>

* update it from time to time with: <code>git pull --rebase</code>

* Make sure you install the package in the checkout directory, so the path is: /spring/mingwlibs. If done right, it will look like:
** */spring/
** */spring/...
** */spring/mingwlibs
** */spring/rts

* Note: if you install the package somewhere else (preferably outside of the source tree), and pass its location with the ''MINGDIR'' option to CMake in the configure step (see further down, in the quick instructions).

== configure using CMake ==

* run the ''cmake-gui'' and select a source and a build directory
* configure and follow the instructions, and adjust variables to your needs (defaults are OK)
* press '''Generate'''
* open a console (''cmd.exe''), ''cd'' into your '''build''' directory
* ''optional:'' for multi-threaded compilation, the ''mingw32-make'' part may differ on your system: <code>''<pre>set MAKE_COMMAND=mingw32-make -j2</pre>''</code> (use -j4 for 4 threads)
* compile with: <code>''<pre>mingw32-make install-spring</pre>''</code>
* compile just the engine (spring.exe) with: <code>''<pre>mingw32-make engine-legacy</pre>''</code>

===Generating the AI Sources/Wrappers===

you can either build the wrapper:

<code>make Cpp-AIWrapper</code>

or generate all sources, in case you don't need the binary:

<code>make generateSources</code>

===Possible Problems===
* If you get undefined reference to `_Unwind_Resume' linking errors, deinstall ''whole'' MinGW and reinstall it with ''sjlj''.

* When you installed an old version of MinGW/TDM and forgot to deinstall it correctly, <code>gcc.exe</code> & <code>g++.exe</code> will be named <code>gcc-dw2.exe</code>/<code>g++-dw2.exe</code>. CMake will then fail to find the correct one, first try to deinstall anything mingw related and reinstall everything. If that didn't helped just rename the files. If even that doesn't help open cmake-gui and click the advanced button and set the paths to the correct files yourself (<code>CMAKE_C_COMPILER</code> & <code>CMAKE_CXX_COMPILER</code>).

=== Notes ===

You can still use Visual Studio 2012 as described below to edit the code. This is very useful because it allows excellent code navigation, and it highlights syntax errors and trivial mistakes before compiling.

For debugging mingw builds, you can aquire a windows build of gdb from http://www.equation.com/servlet/equation.cmd?fa=gdb

To start debugging, copy ''gdb.exe'' to your build output directory, and launch it with ''gdb spring.exe''. You can supply command line arguments to ''spring.exe'' with ''gdb --args spring.exe myreplayfile.sdf''

=Compiling with Visual Studio (not officially supported!)=
Currently Visual Studio lacks some c++ features it doesn't compile spring!

==General Visual Studio Notes==
When developing using Visual Studio keep in mind:
*It's experimental and not proved to compile or run!
*Your VS build won't sync with GCC builds in multiplayer mode
*AIs built with Visual Studio will work with the mingw32 release builds thanks to the C AI Interface, however this interface may change when newer releases are made
*Running any non-LUA AI on VS built Spring will crash it

===2012 (v11)===

Install [http://www.microsoft.com/visualstudio/eng/downloads#d-express-windows-desktop Visual Studio 2012 Express for Windows Desktop], [http://www.microsoft.com/en-us/download/confirmation.aspx?id=35515 Visual C++ Compiler November 2012 CTP], [http://www.cmake.org/ cmake], [http://www.7-zip.org 7-zip] and [http://msysgit.github.io/ msysgit].

From the Startmenu run "VS2012 x86 Native Tools Command Prompt" and type:

<code><pre>
set PATH=%PATH%;%PROGRAMFILES%\git\bin;%PROGRAMFILES%\cmake 2.8\bin\
git clone git://github.com/spring/spring.git
cd spring
git clone git://github.com/spring/vclibs11.git vclibs
cmake -G "Visual Studio 11" .
</pre></code>

Now start visual studio & open Spring.sln. Select "engine-legacy" as default project, as AIs and ofter stuff are known to fail to compile on visual studio.

In the Project Properties, make sure to [http://stackoverflow.com/questions/13238408/variadic-template-in-vs-2012-visual-c-november-2012-ctp select the Microsoft Visual C++ Compiler Nov 2012 CTP].

Note: Visual Studio 2012 Express for Windows Desktop is for free, but requires a registration after 30 days (to get a free license).

[[Category:Compiling]]