Differences between revisions 7 and 8
Revision 7 as of 2007-08-01 19:38:57
Size: 2647
Comment: tell to add patch.exe to the dist dir
Revision 8 as of 2007-08-01 21:33:13
Size: 3068
Comment: add asciidoc notice
Deletions are marked like this. Additions are marked like this.
Line 38: Line 38:

To build the html help files you need also:

asciidoc
      http://www.methods.co.nz/asciidoc/downloads.html

[Note: ''to configure it you have to adjust your path so the asciidoc.py file is found (I use a link to it from /bin in an msys install), and you have to change the CONF_DIR hardcoded into that file so the backend and help files are found (in my case it's changed to "C:/winp/msys/1.0/etc/asciidoc")'']

[Note: this page has been adapted from contrib/win32/win32-build.txt found in Mercurial's source tree]

The standalone Windows installer for Mercurial is built in a somewhat jury-rigged fashion.

Prerequisites

It has the following prerequisites, at least as I build it:

Python for Windows

MinGW

Python for Windows Extensions

mfc71.dll (just download, don't install)

patch.exe (from the gnuwin32 project or any other alternative)

The py2exe distutils extension

Inno Setup

ISTool (optional)

add_path (you need only add_path.exe in the zip file)

And, of course, Mercurial itself

To build the html help files you need also:

asciidoc

[Note: to configure it you have to adjust your path so the asciidoc.py file is found (I use a link to it from /bin in an msys install), and you have to change the CONF_DIR hardcoded into that file so the backend and help files are found (in my case it's changed to "C:/winp/msys/1.0/etc/asciidoc")]

Building Installer

Once you have all this installed and built, clone a copy of the Mercurial repository you want to package, and name the repo C:\hg\hg-release.

Open a command prompt window on C:\hg\hg-release, then build a standalone copy of the hg.exe program:

python setup.py build -c mingw32 
python setup.py py2exe -b 1

Note: the previously suggested combined command of "python setup.py build -c mingw32 py2exe -b 1" doesn't work correctly anymore as it doesn't include the extensions in the mercurial subdirectory.

Alternatively, you can create a file named setup.cfg in the root of the repository (C:\hg\hg-release) with the following contents:

[build]
compiler=mingw32

which would allow you to skip the first build step and just run:

python setup.py py2exe -b 1

Copy mfc71.dll, add_path.exe and patch.exe into the dist directory that just got created.

If Inno Setup is in your path you can run:

iscc contrib\win32\mercurial.iss

Or you can run ISTool, and open the C:\hg\hg-release\contrib\win32\mercurial.iss file. In ISTool, type Ctrl-F9 to compile the installer file.

The actual installer will be in the C:\hg\hg-release\Output directory.

To automate the steps above you may want to create a batchfile based on the following:

  echo [build] > setup.cfg
  echo compiler=mingw32 >> setup.cfg
  python setup.py py2exe -b 1
  iscc contrib\win32\mercurial.iss

and run it from the root of the hg repository (C:\hg\hg-release).

BuildingWindowsInstaller (last edited 2009-06-01 18:00:25 by PascalQuantin)