Cross-compiling for windows (from linux) - Part 1
This article explains how to cross-compile a 64-bit windows application
from linux. This means that you don't need to have a windows build-machine,
and you can use all linux based development tools. This is great for
developers who feel more comfortable in linux.
For some time, I knew that this was technically possible, but always
assumed it would be either too difficult, or otherwise buggy and cumbersome.
That I would eventually give up, and porting the compilation to windows,
using a build machine running windows.
After two days of working at this problem, I'm eager to explain and
share my experience with it. I'll try to do so in two parts:
- Install the mingw cross-compilation tools.
- Compile hello_world.exe.
- A SCons based build system, that will be used in part 2.
- Cross-compile SDL. Cross-compile a program that links to,
and initializes SDL.
- Repeat the process for similar libraries:
- SDL_image, together with libjpg and libpng.
- SDL_mixer, with libogg and libvorbis
- SDL_ttf, with libfreetype
1. Getting mingw, the cross-compiler tools
To cross-compile, I'll use the mingw-project, in
partuclar, the 64 bit gcc-like build tools. On ubuntu, I installed these with
If you're relying on c++11 features, you might want to verify that
the mingw-g++ compiler is version 4.7 or newer.
To check out which version you have:
In order to cross-compile a hello world program, all you need to do is:
It works fine
makes sure all necessary libraries get
packed into the exe
Without it, you'll get
an error message.
3. Simple SCons build system
Since a project usually consists of more than a main.cpp,
you want an exensible build system. Preferably, one with the ability
to easy switch between target platforms, and manage the differences between
I'll be using SCons.
It is based on python, and easy to understand and customize. In fact, I
don't think you need to know anything about SCons or python
to make sense of the scripts (which rarely is the case for make and cmake)
To follow along, grab a
copy of the repo
(and check out the "basic" branch)
The SCons "Makefile", aka SConsctruct
This sets it up so we can use --win64 flag to specify that we
want a windows build. With this enabled, x86_64-w64-mingw32-g++ is
used as the compiler, instead of g++.
Additionally, the SConstruct script asks SCons to
put all files created by the build in ./build/linux/ or ./build/windows/. This
keeps things tidy, and we also don't need to rebuild everything when alternating
building for the two platforms.
Lastly, is does whatherver the SCons build script src/SConscript
(together with the environment we set up) tells it to do. But, before I show that, I want to show
the two python scripts that will be used to differentiate the details
between the target platforms:
The SCons build script, src/SConscript
Building with SCons
Using the SCons setup, we can build a
linux executable (./bin/main) with:
To build a windows executable (./bin/main.exe
If you want to clean up, add -c
at the end, e.g.: scons --win64 -c
To be continued ... (part 2)