Introduction

This Makefile compiles a MinGW cross compiler and cross compiles many free libraries such as GD and SDL. Thus, it provides a nice MinGW cross compiling environment which

Tutorial

Step 1: Download and Unpack

First, download the latest release and unpack the tarball:

wget http://www.profv.de/mingw_cross_env/mingw_cross_env-X.Y.tar.gz
tar -xzvf mingw_cross_env-X.Y.tar.gz

If you don't mind installing it in your home directory, just skip the following step and go straight to step 3.

Step 2: System-wide Installation (optional)

Now you should save any previous installation of the MinGW cross compiling environment. Assuming you've installed it under /opt/mingw (any other directory will do as well), you should execute the following commands:

su
mv /opt/mingw /opt/mingw.old
exit

Then you need to transfer the entire directory to its definitive location. We will assume again you use /opt/mingw, but feel free to use any other directory if you like.

su
mv mingw_cross_env-X.Y /opt/mingw
exit

We're almost done. Just change to your newly created directory and get going:

cd /opt/mingw

Step 3: Build mingw_cross_env

Enter the directory where you've unpacked the MinGW cross compiling environment. Now it depends on what you actually want – or need.

If you choose to enter:

make

you're in for a long wait, because the MinGW cross compiling environment compiles a lot of stuff. On the other hand it doesn't require any intervention, so you're free to do whatever you like – like watch a movie or go for a night on the town. When it's done you'll find that you've installed a very capable Win32 cross compiler onto your system.

If you only need the most basic tools you can also use:

make gcc

and add any additional packages you need later on. You can also supply a host of packages on the command line, e.g.:

make gtk lua libidn

You'll always end up with a consistent cross compiler environment.

After you're done it just needs a little post-installation. Edit your .bashrc script in order to change $PATH:

export PATH=/where MinGW cross compiler is installed/usr/bin:$PATH

BTW, note that any compiler related environment variables (like $CC, $LDFLAGS, etc.) may spoil your compiling pleasure, so be sure to delete or disable those.

Step 4: Build your Project

You probably will have to make a few adjustments to your Makefile:

CC=$(CROSS)gcc
LD=$(CROSS)ld
AR=$(CROSS)ar

You may have to add a few others, depending on your project. Then, all you have to do is type this:

make CROSS="i386-mingw32msvc-"

If you're using configure, all you have to do is:

./configure --host="i386-mingw32msvc"
make

That's it!

Don't let any warnings put you off. A warning like this is absolutely harmless:

configure: WARNING: If you wanted to set the --build type, don't use --host.
If a cross compiler is detected then cross compile mode will be used.

Everything will be just fine.

Latest Release

2009-06-xx – Release 2.6

Download | Changelog

This release ...

The documentation and website are completely revised.

New packages haven been added.

New versions of various packages are supported.

Old Releases
History

Development Version

To obtain the current development version, install Mercurial and run:

hg clone http://www.profv.de/mingw_cross_env/hgweb.cgi mingw_cross_env

You can also browse the Web Repository.

Prerequisites

Linux
Install GCC, GNU Make (>= 3.81) and SCons (>= 0.98), everything else is usually already there.
Minimal Debian
Create a minimal Debian system with debootstrap, then run:
aptitude install -R g++ make scons openssl unzip bzip2 patch
FreeBSD
pkg_add -r bash gmake gsed wget unzip perl
MacOS X
Install Xcode and MacPorts, then run:
sudo port install gmake gsed wget scons

Usage

make
build all packages, non-parallel
make gcc
build a minimal useful set of packages, i.e. the cross compilers and the most basic packages, non-parallel
make foo bar
build packages "foo", "bar" and their dependencies, non-parallel
make foo bar -j 4 JOBS=2
build packages "foo", "bar" and their dependencies, where up to 4 packages are build in parallel, each with up to 2 compiler processes running in parallel
make strip
strip all package builds and remove unnecessary files
make clean
remove all package builds – use with caution!
make clean-pkg
remove all unused package files, handy after a successful "make update"
make update
update the version numbers of all packages, download the new versions and note their checksums – use with caution!
make dist
build a source distribution tarball

List of Packages

Authors:

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

History

2009-04-06 – Release 2.5

Download | Changelog

This release fixes a download error caused by the MinGW project. They suddenly changed the names of their source tarballs. That sort of thing should never happen!

This release also contains some bugfixes which allow it to run on a wider range of systems.

All downloaded files are now verified by their SHA-1 checksums.

New versions of various packages are supported.

2009-03-08 – Release 2.4

Download | Changelog

This release provides many new libraries such as wxWidgets, GTK+ and OpenEXR.

In addition, new versions of various packages are supported.

2009-02-09 – Release 2.3

Download | Changelog

This release fixes some serious build problems on FreeBSD and MacOS-X.

The Makefile has a new target "clean-pkg" and allows to be called from a separate build directory via "make -f .../Makefile".

Some new versions of the packages are supported, especially GCC-4.3 by switching from MinGW GCC to TDM-GCC.

2009-01-31 – Release 2.2

Download | Changelog

This release fixes some minor build problems.

It also supports some new packages and some newer versions of the already supported packages.

Parallelization is now disabled by default.

2008-12-13 – Release 2.1

Download | Changelog

This release fixes a download error caused by the GDAL project. They suddenly changed their download URLs. That sort of thing should never happen!

In addition, some newer versions of various packages are supported.

There is also a small compatibility fix for OS X.

2008-11-10 – Release 2.0

Download | Changelog

The shell script has been rewritten as Makefile and supports partial builds and parallel builds.

As usual, this release also supports some new packages and some newer versions of the already supported packages.

2008-01-11 – Release 1.4

Download | Changelog

This release now includes a tutorial by Hans Bezemer and has improved compile options of FLTK. As usual, it supports some newer versions of the libraries.

At the request of its author, libowfat is no longer supported from this release on.

The script now uses a specific SourceForge mirror instead of randomly chosen ones, because the download phase often stumbled on some very slow mirrors.

2007-12-23 – Release 1.3

Download | Changelog

A sudden change in the download URLs of GEOS made the automatic download fail. Such changes should never happen! But it happened, and this quick release is an attempt to limit the damage.

This release also supports some newer versions of the libraries including support for fontconfig-2.5.0.

2007-12-13 – Release 1.2

Download | Changelog

This release is a switch from gcc-3 to gcc-4. It also supports a new library and some newer versions of the already supported libraries.

2007-07-24 – Release 1.1

Download | Changelog

This release is the result of the public attention the release 1.0 got. It contains many improvements suggested by its first users, and adds support for many new libraries.

Thanks to Rocco Rutte who contributed many code snippets.

2007-06-19 – Release 1.0

Download | Changelog

This first release has been created in a 7-day-sprint.

2007-06-12 – Project start

See also