Qrow: Created page with "Development < Building Spring < {{FULLPAGENAME}} TOC Cross-compiling allows you to build for other platforms than the machine you are building on. You can, for example, compile Windows 32-bit binaries on a Linux 64-bit machine. = Obtaining the Source = {{Obtaining_The_Source_Code}} = CMake cross compiling = == Setting up the cross compiler == The compiler is called MinGW, which is a port of GCC to windows. The version..."

2026-03-05T01:48:11Z

Created page with "Development < Building Spring < {{FULLPAGENAME}} __TOC__ Cross-compiling allows you to build for other platforms than the machine you are building on. You can, for example, compile Windows 32-bit binaries on a Linux 64-bit machine. = Obtaining the Source = {{Obtaining_The_Source_Code}} = CMake cross compiling = == Setting up the cross compiler == The compiler is called MinGW, which is a port of GCC to windows. The version..."

New page

[[Engine_Development|Development]] < [[Building_spring|Building Spring]] < {{FULLPAGENAME}}

__TOC__

Cross-compiling allows you to build for other platforms than the machine you are building on. You can, for example, compile Windows 32-bit binaries on a Linux 64-bit machine.

= Obtaining the Source =

{{Obtaining_The_Source_Code}}

= CMake cross compiling =

== Setting up the cross compiler ==

The compiler is called MinGW, which is a port of GCC to windows. The version are going to need is MinGW GCC 4.4.0 (which is MinGW 2.7) or later. Most Linux distributions come with MinGW-GCC 4.1.2 only in their standard repos (Summer 2009), so you have to do extra work to get 4.4.0+.

===Gentoo===
<code><pre>
emerge crossdev
EXTRA_ECONF="--with-dwarf2 --disable-sjlj-exceptions" crossdev -t i686-mingw32
</pre></code>
Additional instructions can be found [http://en.gentoo-wiki.com/wiki/Crossdev here] or [http://psas.pdx.edu/GentooCrossCompilerHowto/ here].

===Ubuntu 10.04===

Use the repository specified [https://launchpad.net/~tobydox/+archive/mingw mingw ppa], and then install the required packages:

<code>
sudo add-apt-repository ppa:tobydox/mingw
sudo apt-get update
sudo apt-get install mingw32-x-binutils mingw32-x-gcc mingw32-x-runtime mingw-x-w32api
</code>

===Ubuntu 11.10===

see the section [https://github.com/spring/spring/blob/develop/buildbot/README.markdown Recompile MinGW package with dwarf2 exceptions instead of sjlj exceptions].

===Other distros===

You have to find a way yourself, or use [http://www.profv.de/mingw_cross_env/#tutorial these] instructions to get the sources and compile it yourself. When doing so, make sure to use these build flags for gcc:

<code>
--with-dwarf2 --disable-sjlj-exceptions --enable-shared --enable-version-specific-runtime-libs
</code>

you can add them under ''src/gcc-core.mk''.

''Note:'' This method will most likely not work anymore, as the checksum of the build files is checked by the makefile.

Alternatively, use this line to compile all the deps (which will then be used instead of mingwlibs):
<code><pre>make zlib boost devil ogg vorbis openal freetype sdl glew gcc</pre></code>

== Getting Spring's windows dependencies ==

These are called '''mingwlibs'''. How to get them is described below.

=== official MinGW - dwarf2 (default) ===
You can get it here ('''Download Source''' button, or use ''git''):
* [http://github.com/spring/mingwlibs '''mingwlibs''']

=== TDM MinGW - sjlj (alternative) ===
http://github.com/spring/spring/downloads

== Setting up your directories ==
Here is my recommended layout

<pre>
~/spring-xcompile/ (or wherever you want to put it all)
___ spring/ (the spring source)
___ win32/ (your target platform)
_______ build/ (the build files for your target will go here)
_______ final/ (the compiled binaries and libs will be installed here)
_______ libs/ (mingwlibs, the target libraries you just downloaded)
_______ win32.cmake (see below)
</pre>

== Create your cmake toolchain ==
Create the toolchain file:
<code><pre>pico "~/spring-xcompile/win32/win32.cmake"</pre></code>
=== Example toolchain file ===
An example should be self-explanatory:
<code><pre>
# the name of the target operating system
SET(CMAKE_SYSTEM_NAME Windows)

# which compilers to use for C and C++
SET(CMAKE_C_COMPILER i686-mingw32-gcc)
SET(CMAKE_CXX_COMPILER i686-mingw32-g++)

# here is the target environment located
SET(CMAKE_FIND_ROOT_PATH /usr/i686-mingw32)

# the spring mingw32 dependencies
SET(MINGWLIBS ~/spring-xcompile/win32/libs)

# the path that make install will use to put the final binaries
SET(CMAKE_INSTALL_PREFIX ~/spring-xcompile/win32/final)
</pre></code>

Pass this with <code>-DCMAKE_TOOLCHAIN_FILE=~/spring-xcompile/win32/win32.cmake</code> to cmake or select it in the gui to make a cross-compilation (see below).

=== Some Options Explained ===
* '''MINGWLIBS''': absolute path to the directory where [[Building_Spring_Cross_Compiled#Getting_Spring.27s_windows_dependencies |'''mingwlibs''']] are located
* '''CMAKE_INSTALL_PREFIX''': installation prefix (defaults to ''/usr/local'') defines the base directory for installing
* '''DATADIR''', '''LIBDIR''', '''BINDIR''': where to install data, libraries or binaries (relative paths are based on ''CMAKE_INSTALL_PREFIX'', absolute paths are absolute (''DESTDIR'' is still respected))
* '''APPLICATIONS_DIR''', '''MIME_DIR''', '''PIXMAPS_DIR''': where to install freedesktop-files (icons, mime-types and application-description)

=== Further reference ===
* [http://www.vtk.org/Wiki/CMake_FAQ CMake FAQ]
* ''man CMake''
* [http://www.cmake.org/HTML/cmake-2.6.html CMake documentation] (long!)

== Run CMake ==

=== The GUI method ===
CMake offers a nice Qt4 gui to ease the following steps (to use the gui explained here, cmake must be at least version 2.6.1). Doing so should be straightforward:
* run <code>cmake-gui</code>
* select source directory
* select (and/or create) build directory where temporary files are stored
* hit configure button
* choose your build type:
** Unix makefile if you are using linux and want to compile linux executables
** mingw makefiles if you are working on windows
** Unix makefile with cross compiler setup to cross-compile mingw32 executables, you have to select the toolchain file you want to use (see below)
* configure variables to your need (move the mouse over the options and read the tooltip for further informations on them and or see Section "Options")
* push generate button
* open commandline and do "make" and "make install"

=== The commandline method ===

* cd to build directory
<code><pre>cd ~user/spring-xcompile/win32/build</pre></code>
* <code>cmake <path to source tree> <options></code> where:
** <code><path to source tree></code> is the path to the spring source directory
** <code><options></code> are defined like <code>-D<option name>=<value></code>

* IMPORTANT: depending on your settings you may need to run this command twice. It can't hurt so I recommend doing it anyway.
<code><pre>cmake "~user/spring-xcompile/spring" "-DCMAKE_TOOLCHAIN_FILE=~user/spring-xcompile/win32/win32.cmake"</pre></code>
* run <code>make</code> and <code>make install</code>
<code><pre>make spring && make install-spring DESTDIR=~user/spring-xcompile/win32/final</pre></code>

to show other build targets type: <code>make help</code>

== Package Maintainers Note: ==
* doing <code>make install DESTDIR=/some/path</code> will install spring in the specified place, putting files in subdirectories like configured. This may be helpful when making packages so Spring don't get installed on your system for real (see also CMake FAQ [[http://www.vtk.org/Wiki/CMake_FAQ#Does_CMake.27s_.22make_install.22_support_DESTDIR.3F]]).
* You need to update the mime database (<code>update-mime-database</code>) and the kde database (<code>kbuildsycoca</code>) after installing to make the system aware of the newly installed mime types and desktop shortcuts.

==Buildbot==
For setting up a buildbot slave, see: {{sourcelink|file=buildbot/README.markdown}}

[[Category:Linux]]

Building Spring Cross Compiled - Revision history