equal
deleted
inserted
replaced
16 dependencies must be installed: |
16 dependencies must be installed: |
17 |
17 |
18 * Python 2.7 (download from https://www.python.org/downloads/) |
18 * Python 2.7 (download from https://www.python.org/downloads/) |
19 * Microsoft Visual C++ Compiler for Python 2.7 |
19 * Microsoft Visual C++ Compiler for Python 2.7 |
20 (https://www.microsoft.com/en-us/download/details.aspx?id=44266) |
20 (https://www.microsoft.com/en-us/download/details.aspx?id=44266) |
21 * Python 3.5+ (to run the ``build.py`` script) |
21 * Python 3.5+ (to run the ``packaging.py`` script) |
22 |
22 |
23 Building |
23 Building |
24 ======== |
24 ======== |
25 |
25 |
26 The ``build.py`` script automates the process of producing an MSI |
26 The ``packaging.py`` script automates the process of producing an MSI |
27 installer. It manages fetching and configuring non-system dependencies |
27 installer. It manages fetching and configuring non-system dependencies |
28 (such as py2exe, gettext, and various Python packages). |
28 (such as py2exe, gettext, and various Python packages). |
29 |
29 |
30 The script requires an activated ``Visual C++ 2008`` command prompt. |
30 The script requires an activated ``Visual C++ 2008`` command prompt. |
31 A shortcut to such a prompt was installed with ``Microsoft Visual |
31 A shortcut to such a prompt was installed with ``Microsoft Visual |
35 ``Visual C++ 2008 64-bit Command Prompt``. |
35 ``Visual C++ 2008 64-bit Command Prompt``. |
36 |
36 |
37 From the prompt, change to the Mercurial source directory. e.g. |
37 From the prompt, change to the Mercurial source directory. e.g. |
38 ``cd c:\src\hg``. |
38 ``cd c:\src\hg``. |
39 |
39 |
40 Next, invoke ``build.py`` to produce an MSI installer. You will need |
40 Next, invoke ``packaging.py`` to produce an MSI installer. You will need |
41 to supply the path to the Python interpreter to use.:: |
41 to supply the path to the Python interpreter to use.:: |
42 |
42 |
43 $ python3 contrib\packaging\wix\build.py \ |
43 $ python3 contrib\packaging\packaging.py \ |
44 --python c:\python27\python.exe |
44 wix --python c:\python27\python.exe |
45 |
45 |
46 .. note:: |
46 .. note:: |
47 |
47 |
48 The script validates that the Visual C++ environment is active and |
48 The script validates that the Visual C++ environment is active and |
49 that the architecture of the specified Python interpreter matches the |
49 that the architecture of the specified Python interpreter matches the |
52 If everything runs as intended, dependencies will be fetched and |
52 If everything runs as intended, dependencies will be fetched and |
53 configured into the ``build`` sub-directory, Mercurial will be built, |
53 configured into the ``build`` sub-directory, Mercurial will be built, |
54 and an installer placed in the ``dist`` sub-directory. The final line |
54 and an installer placed in the ``dist`` sub-directory. The final line |
55 of output should print the name of the generated installer. |
55 of output should print the name of the generated installer. |
56 |
56 |
57 Additional options may be configured. Run ``build.py --help`` to see |
57 Additional options may be configured. Run ``packaging.py wix --help`` to |
58 a list of program flags. |
58 see a list of program flags. |
59 |
59 |
60 Relationship to TortoiseHG |
60 Relationship to TortoiseHG |
61 ========================== |
61 ========================== |
62 |
62 |
63 TortoiseHG uses the WiX files in this directory. |
63 TortoiseHG uses the WiX files in this directory. |