MinGW64 how-to（内含编译openssl，libjpeg，libcurl等例子）

Index of contents

• Setting up the MinGW 64 environment
• Step 1) building libiconv
• Step 2) building libz
• Step 3) building libjpeg
• Step 4) building libpng
• Step 5) building libtiff
• Step 6) building libproj
• Step 7) building libgeotiff
• Step 8) building libgeos
• Step 9) building libexpat
• Step 10) building libspatialite
• Step 11) building spatialite-tools
• Step 12) building wxWidgets MSW
• Step 13) building libfreetype
• Step 14) building libfontconfig
• Step 15) building libpixman
• Step 16) building libcairo
• Step 17) building libgaiagraphics
• Step 18) building spatialite_gui
• Step 19) building OpenSSL
• Step 20) building libcurl

Setting up the MinGW 64 environment

MinGW 64 is an open source C/C++ compiler based on the popular gcc; basically, it is intended to generate executables for Windows 64 bit.

We‘ll suppose that you already have a basic familiarity with standard MinGW 32 + MSYS: MinGW 64 is more or less the same, but acting (more or less) as a cross-compiler.
This practically means that you can build 64 bit executables on any Win32 platform: but obviously any 64 bit program requires some Windows 64 platform to be executed.

The standard build tool-chain [originally developed for Linux] natively supports cross-compilers: and this works under Windows as well, e.g. using MinGW 64.
As you surely already know, the standard build procedure is the following one:

./configure
make
make install

Using the MinGW 64 cross-compiler is the same of using standard MinGW32: but in this case you are required to always specify the following ./configure argument:

./configure --host=x86_64-w64-mingw32
make
make install

The above --host directive is enough for ./configure to intend that a cross-compilation is required: and that the intended target is Windows 64 bit.
There are many different ways to deploy MinGW 64 (this including cross-compiling on Linux or Cygwin).
After some careful preliminary testing, I choosed the following one because it appairs the most straightforward:

• I already had MinGW32+MSYS installed on the Windows 7 64 bit box I use to develop Win32 sw:
  so I decided to install MinGW 64 as well on the same platform.
• mixing up at random 32 bit and 64 bit binaries doesn‘t seem so good at all:
  so I‘ve purposely choosen an appropriate configuration, completely avoiding any undesirable confusion.
• anyway, you are absolutely free to choose the configuration best fit for your specific requirements: simply read the appropriate documentation.

Once I decided the most appropriate disk layout, I duly started installing MinGW 64 on Windows 7 Pro 64 bit:

• first I‘ve downloaded the most recent mingw-w64-bin_i686-mingw_yyyymmdd.zip for Win32
• then I‘ve unzipped all this stuff into the C:\MinGW64 directory.
• and finally I‘ve downloaded the most recent MinGW 64 own MSYS
• once I‘ve installed it into the C:\msys64 directory (completing the postinstall procedure) I was immediately ready to work.

All right: we are now ready to start creating our Windows 64 bit software. Let‘s go !

Be warned: building on MinGW 64 is more or less the same as building on MinGW 32: anyway here and there some further patch is absolutely required.

Please, carefully read and verbatim follow any given instruction.

Step 1) building libiconv

libiconv is the standard GNU library supporting locale charsets.
Required by: libspatialite, spatialite-tools

Building under Windows is not too much difficult.

• download libiconv-1.13.1.tar.gz
• uncompress this gzipped-file
• then untar the tarball
• and finally open an MSYS shell

cd libiconv-1.13.1
./configure --host=x86_64-w64-mingw32
make
make install-strip

Anyway, this will simply build and install the DLL: a further step is required in order to get the static library as well.

make distclean
./configure --host=x86_64-w64-mingw32 --disable-shared
make
make install-strip

Now you‘ve built and installed both the static library and the DLL.
However the above process has installed badly misconfigured libcharset.la and libiconv.la files
(which are required to build other libraries in the following steps).
So in order to get a properly configured libiconv you have to accomplish a further operation:

• download libiconv.la and libcharset.la
• then copy both files: cp libiconv.la libcharset.la /usr/local/lib

Step 2) building libz

libz is a popular library implementing Deflate, i.e. the compression algorithm used by gzip and Zip.
Depends on: nothing
Required by: libpng, libtiff, ...

Building under Windows is quite easy, but requires to pay some attenction.

• download the latest sources: zlib125.zip
• uncompress this zip-file
• then open an MSYS shell

A very simple patch is required: you must first edit the zlib-1.2.5/win32/Makefile.gcc file:

After applying the above patch you are now to build zlib:

cd zlib-1.2.5
make -f win32/Makefile.gcc

Now you simply have to manually copy the following files:

cp zlib1.dll /usr/local/bin
cp zconf.h zlib.h /usr/local/include
cp libz.a /usr/local/lib
cp libzdll.a /usr/local/lib/libz.dll.a

All this will build and install both the static library and the DLL as well.
Anyway this process will not generate the libz.la file (which is required to build libtiff in one of the following steps.
So in order to get a fully installed libz you have to accomplish a further operation:

• download libz.la
• and then copy this file: cp libz.la /usr/local/lib

Step 3) building libjpeg

libjpeg is a popular library supporting the JPEG image compression.
Depends on: nothing
Required by: libtiff, libgaiagraphics

Important notice: you can now choose between two alternative implementations:

• libjpeg is the standard, plain library
• libjpeg-turbo is a new library, that fully takes profit from the most recent Intel/AMD CPUs
  If you are planning to deploy your software on such platforms, then using libjpeg-turbo can ensure a 200% performance boost (and even more than this).
  I strongly recommend using libjpeg-turbo: both libraries share the same identical API/ABI (they are absolutely inter-changeable), but libjpeg-turbo runs in an impressively faster mode.

Building the one or the other under Windows is absolutely a plain and easy task.

How-to-build libjpeg-turbo

Please note: the NASM assembler is absolutely required: if you don‘t have it already installed on your system, you can download and install now.

• download the latest sources: libjpeg-turbo-1.1.1.tar.gz
• uncompress this gzipped-file
• then untar the tarball
• and finally open an MSYS shell

cd libjpeg-turbo-1.1.1
./configure --host=x86_64-w64-mingw32 --prefix=/usr/local
make
make install-strip

This will build and install both the static library and the DLL as well.

How-to-build libjpeg

• download the latest sources: jpegsr8b.zip
• uncompress this zip-file
• then open an MSYS shell

cd jpeg-8b
./configure --host=x86_64-w64-mingw32 
make
make install-strip

This will build and install both the static library and the DLL as well.

Step 4) building libpng

libpng is a popular library supporting the PNG image compression.
Depends on: libz
Required by: libgaiagraphics

Building under Windows is absolutely a plain and easy task.

• download the latest sources: libpng-1.5.2.tar.gz
• uncompress this gzipped-file
• then untar the tarball
• and finally open an MSYS shell

cd libpng-1.5.2
export "CFLAGS=-I/usr/local/include"
export "LDFLAGS=-L/usr/local/lib"
./configure --host=x86_64-w64-mingw32
make
make install-strip

Important notice: you have to properly set the shell environment in order to retrieve the already installed libz; this is the duty of the two above export directives.
This will build and install both the static library and the DLL as well.

Important notice #2: in order to get ./configure support you must absolutely download the .tar.gz, because the .zip doesn‘t supports it.

Step 5) building libtiff

libtiff is a popular library supporting the TIFF image format.
Depends on: libz, libjpeg
Required by: libgaiagraphics

Building under Windows is absolutely a plain and easy task.

• download the latest sources: tiff-3.9.5.zip
• uncompress this zip-file
• then open an MSYS shell

cd tiff-3.9.5
export "CFLAGS=-I/usr/local/include"
export "LDFLAGS=-L/usr/local/lib"
./configure --host=x86_64-w64-mingw32
make
make install-strip

Important notice: you have to properly set the shell environment in order to retrieve the already installed libz; this is the duty of the two above export directives.

This will build and install both the static library and the DLL as well.

Important notice: MinGW 64 seems to generate absolutely crazy .la files.
So you have to manually apply the following patch to avoid any possible further issue.
You are now required to manually edit the /usr/local/lib/libtiffxx.la file as follows:

• search for a line starting with: dependency_libs=
• you‘ll find within the associated value a crazy path like:
  /c/bb/vista64-mingw32/mingw-x86-x86_64/build/build/root/x86_64-w64-mingw32/lib/../lib/libstdc++.la
  -L/c/bb/vista64-mingw32/mingw-x86-x86_64/build/build/gcc/obj/x86_64-w64-mingw32/libstdc++-v3/src
  -L/c/bb/vista64-mingw32/mingw-x86-x86_64/build/build/gcc/obj/x86_64-w64-mingw32/libstdc++-v3/src/.libs
  -L/c/bb/vista64-mingw32/mingw-x86-x86_64/build/build/root/x86_64-w64-mingw32/lib
  -L/c/bb/vista64-mingw32/mingw-x86-x86_64/build/build/root/mingw/lib
• simply replace all the above garbage with: C:/MinGW64/x86_64-w64-mingw32/lib/libstdc++.la
• save and exit

Step 6) building libproj

libproj is a library supporting coordinate‘s transformation between different Reference Systems [PROJ.4]
Depends on: nothing
Required by: libgeotiff, libspatialite, spatialite-tools

Building under Windows is an easy task.

• download the latest sources: proj-4.7.0.zip
• uncompress this zip-file
• then open an MSYS shell

cd proj-4.7.0
./configure --host=x86_64-w64-mingw32 --without-mutex
make
make install-strip

Important notice: may well be you‘ll get the following fatal errors:

in such an evenience you have to edit the -/src/pj_mutex.c source as follows:

Step 7) building libgeotiff

libgeotiff is a library supporting the GeoTIFF raster format
Depends on: libtiff, libproj
Required by: libgaiagraphics

Building under Windows is an easy task.

• download the latest sources: libgeotiff130.zip
• uncompress this zip-file
• then open an MSYS shell

cd libgeotiff-1.3.0
export "CFLAGS=-I/usr/local/include"
export "LDFLAGS=-L/usr/local/lib"
./configure --host=x86_64-w64-mingw32 --enable-incode-epsg
make
make install-strip

Important notice: it doesn‘t seem possible to build as a DLL using MinGW + MSYS. AFAIK, there is no way to do such a thing.
So you have to manually apply the following patch to circumvent this issue. Edit the /usr/local/lib/libgeotiff.la file as follows:

Step 8) building libgeos

libgeos is a library representing a C++ porting of JTS [Java Topology Suite].
Depends on: nothing
Required by: libspatialite, spatialite-tools

This library really is an huge and complex piece of software; building on Windows is an incredibly time consuming task.

• download the latest sources: geos-3.3.0.tar.bz2
• uncompress this bzip2-file
• then untar the tarball
• and finally open an MSYS shell

cd geos-3.3.0
./configure --host=x86_64-w64-mingw32

Important notice: before attempting to start compiling you are required to manually apply the following patch:
(not at all elegant, but fully effective); so edit the geos-3.3.0/include/geos/platform.h header:

and now you are relly ready to start building GEOS:

make
make install-strip

This will build and install both the static library and the DLL as well.

Important notice: we have already seen this about libtiff: MinGW 64 seems to generate absolutely crazy .la files.
So you have to manually apply the following patch to avoid any possible further issue.
You are now required to manually edit both /usr/local/lib/libgeos.la and /usr/local/lib/libgeos_c.la files as follows:

• search for a line starting with: dependency_libs=
• simply replace any crazy path with: C:/MinGW64/x86_64-w64-mingw32/lib/libstdc++.la
• save and exit

Step 9) building libexpat

libexpat is a well known standard library supporting XML parsing.
Depends on: nothing
Required by: libfontconfig, spatialite-tools, ...

Building under Windows really is a piece-of-cake.

• download the latest sources: expat-2.0.1.tar.gz
• uncompress this gzipped-file
• then untar the tarball
• and finally open an MSYS shell

cd expat-2.0.1
./configure --host=x86_64-w64-mingw32

Important notice: before attempting to start compiling you are required to manually apply the following patch:
(not at all elegant, but fully effective); so edit the C:\MinGW64\x86_64-w64-mingw32\include\process.h header:

and now you are really ready to start building expat (you can recover back again the above change once you‘ve terminated):

make
make install

This will build and install both the static library and the DLL as well.

Step 10) building libspatialite

libspatialite is the main core of SpatiaLite
Depends on: libiconv, libproj, libgeos
Required by: spatialite-tools, librasterlite

Building under Windows is an easy task.

• download the latest sources: libspatialite-amalgamation-3.0.0-beta.zip
• uncompress this zip-file
• then open an MSYS shell

cd libspatialite-amalgamation-3.0.0-beta
export "CFLAGS=-I/usr/local/include"
export "LDFLAGS=-L/usr/local/lib"
./configure --host=x86_64-w64-mingw32 --target=mingw32
make
make install-strip

This will build and install both the static library and the DLL as well.

Important notice: we have already seen this about libtiff: MinGW 64 seems to generate absolutely crazy .la files.
So you have to manually apply the following patch to avoid any possible further issue.
You are now required to manually edit both /usr/local/lib/libspatialite.la files as follows:

• search for a line starting with: dependency_libs=
• simply replace any crazy path with: C:/MinGW64/x86_64-w64-mingw32/lib/libstdc++.la
• save and exit

Step 11) building spatialite-tools

spatialite-tools the SpatiaLite command-line management tools
Depends on: libiconv, libproj, libgeos, libspatialite, libexpat
Building under Windows is an easy task.

• download the latest sources: spatialite-tools-3.0.0-beta.zip
• uncompress this zip-file
• then open an MSYS shell

First of all, you must check if you‘ve already installed pkg-config.exe
If not, please read the above instructions

And now you must set the PKG_CONFIG_PATH as appropriate:

export "PKG_CONFIG_PATH=/usr/local/lib/pkgconfig"

After this you are now ready to build as usual:

cd spatialite-tools-3.0.0-beta
export "CFLAGS=-I/usr/local/include"
export "LDFLAGS=-L/usr/local/lib"
./configure --host=x86_64-w64-mingw32 --target=mingw32
make
make install-strip

Please note: following the above method you‘ll get dynamically linked tools [i.e. depending on DLLs].
If you whish instead to build statically linked tools [i.e. self contained, not depending on DLLs], you must first
manually edit the Makefile-static-MinGW file as follows:

after this you are now ready to build your statically linked tools:

mkdir static_bin
make -f Makefile-static-MinGW
cp static_bin/* /usr/local/bin

Step 12) building wxWidgets MSW

wxWidgets is a popular widgets library, supporting GUI in a cross-platform fashion; MSW is the specific porting supporting Windows.
Depends on: nothing
Required by: spatialite-gui, spatialite-gis

This library really is an huge and complex piece of software; building on Windows is an incredibly time consuming task, but is quite plain and easy.

• download the latest sources: wxMSW-2.8.12.zip
• uncompress this zip-file
• then open an MSYS shell

export "CXXFLAGS=-fpermissive"     [this directive is absolutely required to skip some blocking errors]
cd wxMSW-2.8.12
mkdir msw_build
cd msw_build
../configure --host=x86_64-w64-mingw32 --disable-shared --disable-debug \
    --disable-threads --enable-monolithic --enable-unicode \
    --without-libjpeg --without-libpng --without-zlib\
    --without-libtiff --without-expat --without-regex

Please note: the wxMSW ./configure is highly configurable: you must apply exactly the above settings.
Anyway, when ./configure stops, it‘s a good practice to check if the final report looks exactly like this:

now, when ./configure stops, you have to continue as usual:

make
make install-strip

Important notice: wxWidgets is now configured for any further usage: but unhappily it assumes being on Win32, and this is obviously wrong.
So you must manually adjust the wx-config script (/usr/local/bin/wx-widgets) as follows:

• search for a line starting with: ldlibs_base=
• and on the corresponding value then simply delete: -lwctl3d32
  (this obsolete library doesn‘t exists any longer on Win64, and isn‘t actually required at all).
• now search for any occurrenct of the string: --define __WIN32__ --define __WIN95__ --define __GNUWIN32__
• and replace the above value with: --define WX_CPU_AMD64
  (this is required so to create 64 bit resource files)
• save and exit

Step 13) building libfreetype

libfreetype is a standard library supporting TrueType fonts.
Depends on: nothing
Required by: libcairo, ...

Building under Windows is an easy task.

• download the latest sources: freetype-2.4.4.tar.gz
• uncompress this gzipped-file
• then untar the tarball
• and finally open an MSYS shell

cd freetype-2.4.4
./configure --host=x86_64-w64-mingw32
make
make install

This will build and install both the static library and the DLL as well.

Step 14) building libfontconfig

libfontconfig is a standard library supporting font customization and configuration.
Depends on: libexpat, libfreetype, libiconv
Required by: libcairo, ...

Building under Windows is an easy task.

• download the latest sources: fontconfig-2.8.0.tar.gz
• uncompress this gzipped-file
• then untar the tarball
• and finally open an MSYS shell

cd fontconfig-2.8.0
export "CFLAGS=-I/usr/local/include"
export "LDFLAGS=-L/usr/local/lib"
./configure --host=x86_64-w64-mingw32 --disable-docs
make
make install-strip

This will build and install both the static library and the DLL as well.

Step 15) building libpixman

libpixman is the standard library implementing pixel manipulation for Cairo.
Depends on: nothing
Required by: libcairo, ...

Building under Windows is an easy task.
First of all, you must check if you‘ve already installed pkg-config.exe
If not, please read the above instructions

And now you must set the PKG_CONFIG_PATH as appropriate:

export "PKG_CONFIG_PATH=/usr/local/lib/pkgconfig"

All right, your system configuration is ready to build fontconfig, so you can now:

• download the latest sources: pixman-0.20.2.tar.gz
• uncompress this gzipped-file
• then untar the tarball
• and finally open an MSYS shell

cd pixman-0.20.2
./configure --host=x86_64-w64-mingw32
make
make install-strip

This will build and install both the static library and the DLL as well.

Step 16) building libcairo

libcairo is a very popular graphics library.
Depends on: libpixman, libfreetype, libfontconfig, libpng
Required by: libgaiagraphics, ...

Building under Windows is a little bit harder than usual.
First of all, you must check if you‘ve already installed pkg-config.exe
If not, please read the above instructions

And now you must set the PKG_CONFIG_PATH as appropriate:

export "PKG_CONFIG_PATH=/usr/local/lib/pkgconfig"

All right, your system configuration is ready to build libcairo, so you can now:

• download the latest sources: cairo-1.10.2.tar.gz
• uncompress this gzipped-file
• then untar the tarball
• and finally open an MSYS shell

cd cairo-1.10.2
export "CFLAGS=-I/usr/local/include"
export "LDFLAGS=-L/usr/local/lib"
./configure --host=x86_64-w64-mingw32 --disable-pthread
make
make install-strip

Important notice: you‘ll probably get a fatal error at some time during the compilation:
to resolve this issue you should manually edit the cairo-1.10.2/src/cairo.c source:

This will build and install both the static library and the DLL as well.

Step 17) building libgaiagraphics

libgaiagraphics is a common utility library supporting graphics rendendering
Depends on: libjpeg, libpng, libtiff, libgeotiff, libcairo

Required by: spatialite-gui [next-to-come releases of librasterlite and spatialite-gis]

Building under Windows is an easy task.
First of all, you must check if you‘ve already installed pkg-config.exe
If not, please read the above instructions

And now you must set the PKG_CONFIG_PATH as appropriate:

export "PKG_CONFIG_PATH=/usr/local/lib/pkgconfig"

All right, your system configuration is ready to build libgaiagraphics, so you can now:

• download the latest sources: libgaiagraphics-0.4.zip
• uncompress this zip-file
• then open an MSYS shell

cd libgaiagraphics-0.4
export "CFLAGS=-I/usr/local/include"
export "LDFLAGS=-L/usr/local/lib"
./configure --host=x86_64-w64-mingw32 --target=mingw32
make
make install-strip

This will build and install both the static library and the DLL as well.

Step 18) building spatialite_gui

spatialite_gui the SpatiaLite GUI user-friendly tool
Depends on: libspatialite, wxWidgets, libgaiagraphics
Building under Windows is an easy task.

• download the latest sources: spatialite_gui-1.5.0-beta.zip
• uncompress this zip-file
• then open an MSYS shell

First of all, you must check if you‘ve already installed pkg-config.exe
If not, please read the above instructions

And now you must set the PKG_CONFIG_PATH as appropriate:

export "PKG_CONFIG_PATH=/usr/local/lib/pkgconfig"

After this you are now ready to build as usual:

cd spatialite_gui-1.5.0-beta
export "CFLAGS=-I/usr/local/include"
export "LDFLAGS=-L/usr/local/lib"
./configure --host=x86_64-w64-mingw32
make
make install-strip

Please note: following the above method you‘ll get a dynamically linked GUI tool [i.e. depending on DLLs].
If you whish instead to build a statically linked GUI tool [i.e. self contained, not depending on DLLs], now type:

mkdir static_bin
make -f Makefile-static-MinGW
cp static_bin/* /usr/local/bin

Step 19) building OpenSSL

OpenSSL is a well known standard library supporting SSL, i.e. the encrypted HTTPS web protocol.
Depends on: nothing
Required by: libcurl

Building under Windows is a little bit difficult, and requires to pay close attention.
The configure script isn‘t at all a standard one: please read carefully the following instructions.

• download the latest sources: openssl-1.0.0d.tar.gz
• Important notice: you cannot use tools such as 7z to untar the tarball: this will cause fatal errors during compilation (broken links).
  You absolutely have to run all the following commands from the MSYS shell.

tar zxvf openssl-1.0.0d.tar.gz
cd openssl-1.0.0d
./Configure mingw64 --prefix=/usr/local shared no-asm

Several manual adjustments are now required; you must first edit openssl-1.0.0d/Makefile:

After applying the above patches you are now to build OpenSSL:

export "CROSS_COMPILE=x86_64-w64-mingw32-
make
make install

This will build and install both the static libraries and the DLLs as well.

Step 20) building libcurl

libcurl is a well known library supporting URLs (networking, web protocols)
Depends on: libz, OpenSSL
Required by: ?

Building under Windows is an easy task.

• download the latest sources: curl-7.21.7.zip
• uncompress this zip-file
• then open an MSYS shell

First of all, you must check if you‘ve already installed pkg-config.exe
If not, please read the above instructions

And now you must set the PKG_CONFIG_PATH as appropriate:

export "PKG_CONFIG_PATH=/usr/local/lib/pkgconfig"

After this you are now ready to build as usual:

cd curl-7.21.7
export "CFLAGS=-I/usr/local/include"
export "LDFLAGS=-L/usr/local/lib"
./configure --host=x86_64-w64-mingw32
make
make install-strip

Important notice: you‘ll probably get a fatal error at some time during the compilation:
to resolve this issue you should manually edit the curl-7.21.7/src/main.c source:

This will build and install both the static library and the DLL as well.

https://www.gaia-gis.it/spatialite-3.0.0-BETA/mingw64_how_to.html#open-ssl