Artifact ca2228e45cc358d06234c477281875a1f3e6a83c1479eab2a869fb2185b33d27:

File README-WINDOWS.md — part of check-in [c553a24d31] at 2015-02-01 11:37:12 on branch trunk — README-WINDOWS.md: Complete rewrite for MSYS2
MSYS2 is currently the best way to use MinGW on Windows and also the
best way to keep it up to date. It offers Win64 support as well and can
be used to install a lot of useful tools, for example Git, and usually
has quite recent versions of all packages. (user: js, size: 2496) [annotate] [blame] [check-ins using]

ObjFW on Windows

This file contains instructions on how to get a working build environment to compile and use ObjFW on Windows.

Getting MSYS2

The first thing to install is MSYS2 to provide a basic UNIX-like environment for Windows. Unfortunately, the binaries are not signed and there is no way to verify their integrity, so only download this from a trusted connection. Everything else you will download using MSYS2 later will be cryptographically signed.

Updating MSYS2

The first thing to do is updating MSYS2. It is important to update things in a certain order, as pacman (the package manager MSYS2 uses, which comes from ArchLinux) does not know about a few things that are special on Windows.

First, update the mirror list:

$ pacman -Sy pacman-mirrors

Then proceed to update the msys2-runtime itself, bash and pacman:

$ pacman -S msys2-runtime bash pacman

Now close the current window and restart MSYS2, as the current window is now defunct. In a new MSYS2 window, update the rest of MSYS2:

$ pacman -Su

Now you have a fully updated MSYS2. Whenever you want to update MSYS2, proceed in this order. Notice that the first pacman invocation includes -y to actually fetch a new list of packages.

Installing MinGW-w64 using MSYS2

Now it's time to install MinGW-w64. If you want to build 32 bit binaries:

$ pacman -S mingw-w64-i686-gcc-objc

For 64 bit binaries:

$ pacman -S mingw-w64-x86_64-gcc-objc

There is nothing wrong with installing them both, as MSYS2 has created two entries in your start menu: MinGW-w64 Win32 Shell and MinGW-w64 Win64 Shell. So if you want to build for 32 or 64 bit, you just start the correct shell.

Finally, install a few more things needed to build ObjFW:

$ pacman -S autoconf automake git make

Getting, building and installing ObjFW

Start the MinGW-w64 Win32 or Win64 Shell (depening on what version you want to build) and check out ObjFW:

$ git clone https://webkeks.org/git/objfw.git

You can also download a release tarball if you want. Now go to the newly checked out repository and build and install it:

$ ./autogen.sh && ./configure && make -j16 install