Planner on Windows

This page is about building Planner from source on Windows using MinGW.
If you are just looking for an installer, look in the download section.

The instructions on this page will help you set up an MSYS/MinGW environment on Windows specifically for building Planner. It uses some fixed paths to simplify the instructions.

There is also a build script that will do most of these steps for you. The build script requires a working wget in your PATH. The proper way to use the script is to perform steps 1 and 2, run the script from an MSYS shell (Start -> Programs -> MinGW -> MinGW Shell) and then perform all steps from 12 onwards.

Note: Lines starting with a dollar sign '$' show commands that you should execute. The '$' symbolizes the shell prompt and should not be included in the command.

step 1) Download the automated MinGW installer and install it to c:\MinGW. Make sure to select "MSYS Basic System" when asked to select optional components.
mingw-get-inst-20100909.exe @ http://sourceforge.net/projects/mingw/files/Automated%20MinGW%20Installer/mingw-get-inst/mingw-get-inst-20100909/mingw-get-inst-20100909.exe/download

step 2) Download and install Microsoft's HTML Help Compiler from http://www.microsoft.com/downloads/details.aspx?FamilyID=00535334-c8a6-452f-9aa0-d597d16580cc&DisplayLang=en. The name of the file to download is htmlhelp.exe.

Add the install directory (usually C:\Program Files\HTML Help Workshop) to your path, so hhc.exe can be run from anywhere.

step 3) Create the directory c:\MinGW\msys\1.0\dev

step 4) Download the following packages from http://ftp.gnome.org/pub/gnome/binaries/win32/dependencies/ and extract them all to c:\MinGW\msys\1.0\dev
The versions listed below are the ones I used when I set up these instructions. They just happened to be the latest versions at the time, so you don't need to have exactly those versions. However, if you want to create the planner automated installer, then make sure the versions of these packages match with what is contained in the GTK+ installer in step 17.

  • Package

    Used version *

    cairo and cairo-dev

    1.10.0-1

    expat

    2.0.1-1

    fontconfig and fontconfig-dev

    2.8.0-2

    freetype and freetype-dev

    2.4.2-1

    gettext-runtime and gettext-runtime-dev

    0.18.1.1-2

    gettext-tools and gettext-tools-dev

    0.18.1.1-2

    GNU libiconv (libiconv-1.9.1.bin.woe32.zip)

    1.9.1

    libpng and libpng-dev

    1.4.3-1

    libxml2 and libxml2-dev

    2.7.7-1

    pkg-config

    0.23-3

    zlib and zlib-dev

    1.2.5-2

    * last verified on 2010-10-19

step 5) Download the following packages from http://ftp.gnome.org/pub/gnome/binaries/win32/ and extract them all to c:\MinGW\msys\1.0\dev
The versions listed below are the ones I used when I set up these instructions. They just happened to be the latest versions at the time, so you don't need to have exactly those versions. However, if you want to create the planner automated installer, then make sure the versions of these packages match with what is contained in the GTK+ installer in step 17.

  • Package

    Used version *

    atk and atk-dev

    1.32.0-1

    gdk-pixbuf and gdk-pixbuf-dev

    2.22.0-1

    glib and glib-dev

    2.26.0-2

    gtk+ and gtk+-dev

    2.22.0-2

    libart_lgpl and libart_lgpl-dev

    2.3.21-1

    libglade and libglade-dev

    2.6.4-1

    libgnomecanvas and libgnomecanvas-dev

    2.30.1-1

    pango and pango-dev

    1.28.3-1

    * last verified on 2010-10-19

step 6) Download libxslt-1.1.26 from ftp://ftp.zlatkovic.com/libxml/ and extract it to c:\MinGW\msys\1.0\dev

step 7) Make a copy of c:\MinGW\msys\1.0\dev\bin\libxml2-2.dll and name it libxml2.dll
(This allows us to reuse the slightly incompatible prebuilt version of libxslt.)

step 8) Add the following lines at the end of c:\MinGW\msys\1.0\etc\profile: 

export PATH=$PATH:/dev/bin
export CC=gcc

step 9) Download libxml-2.0.pc and libexslt.pc and save them to c:\MinGW\msys\1.0\dev\lib\pkgconfig

step 10) Download docbook-xsl-1.76.0 from http://sourceforge.net/project/showfiles.php?group_id=21935&package_id=16608 and extract it into c:\MinGW\msys\1.0\dev\src
For now the path used in the Makefiles is hard-coded to /dev/src/docbook-xsl-1.76.0/.

step 11) Download docbook-xml from http://www.oasis-open.org/docbook/xml/4.1.2/docbkx412.zip and extract it into c:\MinGW\msys\1.0\dev\src\docbkx412
For now the path used in the Makefiles is hard-coded to /dev/src/docbkx412/.

step 12) Download and install git from http://code.google.com/p/msysgit/downloads/list. I used the full installer for official Git 1.6.3.2.

During installation make sure to select "Commit line endings as they are".

step 13) Optionally also install TortoiseGit to have a graphical interface to Git that nicely integrates with the Windows Explorer.

step 14) Check out the planner sources from Git to c:\MinGW\msys\1.0\dev\src\planner. The repository URL is git://git.gnome.org/planner.

step 15) Open a new MSYS shell prompt (Start->Programs->MinGW->MinGW Shell), go to /dev/src/planner and run: 

$ make -f Makefile.win32 install

All done!

Planner is now installed in ${HOME}/planner and can be run from that directory provided that /dev/bin is in your PATH.

If you want to create an installer for Planner, there are a few more steps to follow:

step 16) Download the Nullsoft scriptable install system and install it in the default location (C:\Program Files\NSIS).

step 17) Download the GTK+ for Windows Runtime Environment 2.22.0 (build date: 2010-10-21) from http://gtk-win.sourceforge.net/ and save it in C:\MinGW\msys\1.0\dev\src\planner\installer

step 18) In the MSYS shell, go to /dev/src/planner and run: 

$ make -f Makefile.win32 createinstaller

This will place a self-contained installer named something like planner-0.14.4.exe in c:\MinGW\msys\1.0\dev\src\planner\installer

Apps/Planner/Windows (last edited 2017-05-13 17:55:00 by AlexandreFranke)