
MinGW cross compiling environment

     * Introduction
     * Screenshots
     * Tutorial
     * Latest Release
     * Development Version

     * Requirements
     * Usage
     * List of Packages
     * Copyright
     * History

     * See also

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
     * is designed to run on any Unix system
     * is easy to adapt and to extend
     * builds many free libraries in addition to the cross compiler
     * can also build just a subset of the packages, and
       automatically builds their dependencies
     * downloads all needed packages and verifies them by their
       checksums
     * is able to update the version numbers of all packages
       automatically
     * directly uses source packages, thus ensuring the whole build
       mechanism is transparent
     * allows inter-package and intra-package parallel builds
       whenever possible
     * creates libraries to be linked statically, no DLL hell

Screenshots

   Cross compiling 4tH:
   4th-compile 

   and running it:
   4th-run 

Tutorial

Step 1: Download and Unpack

   First, you should ensure that your system meets mingw_cross_env's
   requirements. You probably need to install some stuff.

   When everything is fine, download the latest release:
wget http://www.profv.de/mingw_cross_env/mingw_cross_env-2.7.tar.gz

   and unpack the tarball:
tar -xzvf mingw_cross_env-2.7.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_env. 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-2.7 /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_env.
   Now it depends on what you actually want - or need.

   If you choose to enter:
make

   you're in for a long wait, because it compiles a lot of packages.
   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.

Step 4: Environment Variables

   Edit your .bashrc script in order to change $PATH:
export PATH=/where mingw_cross_env is installed/usr/bin:$PATH

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

   Congratulations! You're ready to cross compile anything you like.

Step 5a: Cross compile your Project (Autotools)

   If you use the Autotools, all you have to do is:
./configure --host=i386-mingw32msvc
make

   Don't worry about a warning like this:
configure: WARNING: If you wanted to set the --build type, don't use --hos
t.
If a cross compiler is detected then cross compile mode will be used.

   Everything will be just fine.

Step 5b: Cross compile your Project (Makefile)

   If you have a handwritten Makefile, you probably will have to
   make a few adjustments to it:
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:
make CROSS=i386-mingw32msvc-

   That's it!

Latest Release

   2009-08-11 - Release 2.7
          Download | Changelog

          This release provides an improved version recognition for
          SourceForge packages. SourceForge changed their page
          layout in a way that makes it much harder to identify the
          current version of a package.

          Additionally, almost all packages are updated to their
          latest version.

   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.

Requirements

   Mingw_cross_env requires a recent Unix system where the following
   components are installed:
   Bash           
   Bzip2          
   LibC for 32-bit
   GCC (gcc, g++) 
   GNU Make        >= 3.81
   GNU Sed        
   OpenSSL        
   Patch          
   Perl           
   SCons           >= 0.98
   UnZip          
   Wget           

   Detailed installation instructions for various systems follow.

Debian

aptitude install -R bash bzip2 g++ make sed openssl \
                    patch perl scons unzip wget

   On 64-bit Debian, install also:
aptitude install -R g++-multilib

FreeBSD

pkg_add -r bash gmake gsed perl scons unzip wget

   On 64-bit FreeBSD, there are open issues with the NSIS package.

Frugalware

pacman-g2 -S bash bzip2 gcc make sed openssl \
             patch perl scons unzip wget

   On 64-bit Frugalware, there are open issues with the NSIS
   package.

MacOS X

   Install Xcode and MacPorts, then run:
sudo port install gmake gsed scons wget

Solaris

   First, install all requirements that already ship with Solaris:
pfexec pkg install SUNWgcc SUNWgmake SUNWgsed SUNWgzip \
                   SUNWlibm SUNWgpch SUNWunzip SUNWwget

   Then download and install SCons by hand:
wget http://prdownloads.sourceforge.net/scons/scons-1.2.0.tar.gz
tar -xzf scons-1.2.0.tar.gz
cd scons-1.2.0
pfexec python setup.py install

Usage

   All build commands also download the packages if necessary.

   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 download
          download all packages, non-parallel, such that subsequent
          builds work without internet access

   make download-foo download-bar
          download packages "foo", "bar" and their dependencies,
          non-parallel

   make download-foo download-bar -j 4
          download packages "foo", "bar" and their dependencies,
          where up to 4 packages are downloaded 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

   atk          1.26.0
   binutils     2.19.1
   boost        1_38_0
   bzip2        1.0.5
   cairo        1.8.8
   cppunit      1.12.1
   curl         7.19.5
   expat        2.0.1
   fltk         1.1.9
   fontconfig   2.7.1
   freetype     2.3.9
   gcc          4.4.0-tdm-1
   gcc-core     4.4.0
   gcc-fortran  4.4.0
   gcc-g++      4.4.0
   gcc-gmp      4.3.0
   gcc-mpfr     2.4.1
   gcc-objc     4.4.0
   gd           2.0.35
   gdal         1.6.1
   geos         3.1.1
   gettext      0.17
   giflib       4.1.6
   glew         1.5.1
   glib         2.20.4
   gnutls       2.8.1
   gtk          2.16.4
   ilmbase      1.0.1
   jasper       1.900.1
   jpeg         6b
   libdnet      1.11
   libevent     1.4.12
   libgcrypt    1.4.4
   libgeotiff   1.2.5
   libgpg_error 1.7
   libgsasl     1.2
   libgsf       1.14.11
   libiconv     1.13.1
   libidn       1.15
   libmikmod    3.2.0-beta2
   libntlm      1.1
   libpng       1.2.39rc01
   libusb       0.1.12.2
   libxml2      2.7.3
   libxslt      1.1.24
   lua          5.1.4
   mingwrt      3.15.2-mingw32
   nsis         2.45
   ogg          1.1.4
   old          0.17
   openexr      1.6.1
   pango        1.24.2
   pcre         7.9
   pdcurses     3.4
   pdflib_lite  7.0.4p4
   pixman       0.15.18
   pkg_config   0.23
   popt         1.15
   proj         4.6.1
   pthreads     2-8-0
   readline     6.0
   sdl          1.2.11
   sdl_image    1.2.7
   sdl_mixer    1.2.8
   sdl_ttf      2.0.9
   smpeg        0.4.5+cvs20030824
   sqlite       3.6.16
   theora       1.0
   tiff         3.8.2
   tre          0.7.6
   vorbis       1.2.3
   w32api       3.13-mingw32
   winpcap      4_0_2
   wxwidgets    2.8.10
   xmlwrapp     0.6.1
   zlib         1.2.3

Copyright

   Authors:
     * Volker Grabsch <vog@notjusthosting.com>
     * Rocco Rutte
     * Andreas Roever
     * Martin Lambers
     * Tony Theodore
     * Giuseppe Scrivano
     * Martin Gerhardy
     * Mark Brand
     * Hans Bezemer

   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-06-19 - Release 2.6
          Download | Changelog

          This release contains some portability fixes which allow
          it to run on a wider range of systems such as Frugalware.

          The documentation and website are completely revised.

          New packages such as CppUnit, libUsb, NSIS, Popt, SQLite
          and Theora are supported.

          Almost all packages are updated to their latest version.

          A new command "make download" is implemented.

   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

This project

     * Project website
     * Project entry on Freshmeat
       with a filled comments section
     * First release anouncement
       and the discussion around it

Related projects

     * IMCROSS
       another project with similar goal
     * mingw32 Debian package
       bare win32 cross compiler
     * GnuWin32
       win32 ports of many free software packages
     * MinGW cross-compiler build script
       old script provided by the SDL project

Articles

     * Cross compilers, the new wave
       appeared on LXer and Linux Today
     * Cross Compiling for Win32
       overview of win32 cross compiling
     * MinGW cross compiler for Linux build environment
       official tutorial of the MinGW project
     * Cross-compiling under Linux for MS Windows
       old tutorial provided by the wxWidgets project
