wiki:Building/Preparation/Windows/MSYS2

Version 31 (modified by monoidal, 5 years ago) (diff)

add pacman-key and cabal update

Building GHC on msys2

This page documents the instructions for setting up a Windows build using msys2, which is a fairly complete build of MinGW + the msys tools. It is self contained and fixes several pesky bugs with the traditional implementation. It's also smaller and has a convenient package manager, pacman.

This guide should get you running in ~5 minutes, modulo download speeds.

msys2 setup

Download and run the msys2 installer (64-bit), or the 32-bit version. Open a mingw64 shell.

IMPORTANT: the msys2 installer creates multiple shortcuts, "MSYS2 Shell", "MinGW-w64 Win32 Shell" and "MinGW-w64 Win64 Shell". You need the latter one. The MSYS2 shell is set up for building applications with Cygwin which provides a POSIX compatibility layer, while MinGW is set up for building native Windows applications, which is what we need for GHC.

An easy way to check that you are running the right shell is to check the output of "echo $PATH". The first item of the list should be /mingw64/bin.

Installing packages & tools

The msys2 package uses pacman (the venerable ArchLinux package manager) to manage packages. Once you're set up, upgrade everything, and install system dependencies required for building GHC:

pacman -Syu
pacman -S git curl tar binutils autoconf make libtool automake mingw-w64-x86_64-gcc

(Problems with PGP keys? Try pacman-key --init and pacman-key --populate msys2)

If you want to run tests, you will need to install a Windows version of Python 2. Python is only used by the test runner though and is not necessary for building GHC.

Host GHC setup

A host GHC binary is required for bootstrapping. Let's download and install a prebuilt GHC into /usr/local:

curl http://www.haskell.org/ghc/dist/7.8.3/ghc-7.8.3-$(uname -m)-unknown-mingw32.tar.xz | tar -xJ -C /tmp &&
mkdir -p /usr/local &&
mv /tmp/ghc-7.8.3/* /usr/local &&
rmdir /tmp/ghc-7.8.3

Cabal setup

Building ghc requires Alex and Happy. It is easiest to install them using cabal. We will also put them in /usr/local to make sure that they end up on $PATH.

curl http://www.haskell.org/cabal/release/cabal-install-1.20.0.3/cabal-1.20.0.3-i386-unknown-mingw32.tar.gz | tar -xz -C /usr/local/bin &&
cabal update &&
cabal install -j --prefix=/usr/local alex happy

A Quick Build

You should now be able to build GHC:

cd ~ &&
git clone --recursive git://git.haskell.org/ghc.git &&
cd ghc &&
git clone git://git.haskell.org/ghc-tarballs.git ghc-tarballs &&
./boot &&  # Consider setting up mk/build.mk here.
./configure &&
make -j5

Alternatively, just run:

./validate