Show More
@@ -1,61 +1,61 b'' | |||||
1 | Requirements |
|
1 | Requirements | |
2 | ============ |
|
2 | ============ | |
3 |
|
3 | |||
4 | Building the Inno installer requires a Windows machine. |
|
4 | Building the Inno installer requires a Windows machine. | |
5 |
|
5 | |||
6 | The following system dependencies must be installed: |
|
6 | The following system dependencies must be installed: | |
7 |
|
7 | |||
8 | * Python 2.7 (download from https://www.python.org/downloads/) |
|
8 | * Python 2.7 (download from https://www.python.org/downloads/) | |
9 | * Microsoft Visual C++ Compiler for Python 2.7 |
|
9 | * Microsoft Visual C++ Compiler for Python 2.7 | |
10 | (https://www.microsoft.com/en-us/download/details.aspx?id=44266) |
|
10 | (https://www.microsoft.com/en-us/download/details.aspx?id=44266) | |
11 | * Inno Setup (http://jrsoftware.org/isdl.php) version 5.4 or newer. |
|
11 | * Inno Setup (http://jrsoftware.org/isdl.php) version 5.4 or newer. | |
12 | Be sure to install the optional Inno Setup Preprocessor feature, |
|
12 | Be sure to install the optional Inno Setup Preprocessor feature, | |
13 | which is required. |
|
13 | which is required. | |
14 | * Python 3.5+ (to run the ``packaging.py`` script) |
|
14 | * Python 3.5+ (to run the ``packaging.py`` script) | |
15 |
|
15 | |||
16 | Building |
|
16 | Building | |
17 | ======== |
|
17 | ======== | |
18 |
|
18 | |||
19 | The ``packaging.py`` script automates the process of producing an |
|
19 | The ``packaging.py`` script automates the process of producing an | |
20 | Inno installer. It manages fetching and configuring the |
|
20 | Inno installer. It manages fetching and configuring the | |
21 | non-system dependencies (such as py2exe, gettext, and various |
|
21 | non-system dependencies (such as py2exe, gettext, and various | |
22 | Python packages). |
|
22 | Python packages). | |
23 |
|
23 | |||
24 | The script requires an activated ``Visual C++ 2008`` command prompt. |
|
24 | The script requires an activated ``Visual C++ 2008`` command prompt. | |
25 | A shortcut to such a prompt was installed with ``Microsoft Visual C++ |
|
25 | A shortcut to such a prompt was installed with ``Microsoft Visual C++ | |
26 | Compiler for Python 2.7``. From your Start Menu, look for |
|
26 | Compiler for Python 2.7``. From your Start Menu, look for | |
27 | ``Microsoft Visual C++ Compiler Package for Python 2.7`` then launch |
|
27 | ``Microsoft Visual C++ Compiler Package for Python 2.7`` then launch | |
28 | either ``Visual C++ 2008 32-bit Command Prompt`` or |
|
28 | either ``Visual C++ 2008 32-bit Command Prompt`` or | |
29 | ``Visual C++ 2008 64-bit Command Prompt``. |
|
29 | ``Visual C++ 2008 64-bit Command Prompt``. | |
30 |
|
30 | |||
31 | From the prompt, change to the Mercurial source directory. e.g. |
|
31 | From the prompt, change to the Mercurial source directory. e.g. | |
32 | ``cd c:\src\hg``. |
|
32 | ``cd c:\src\hg``. | |
33 |
|
33 | |||
34 | Next, invoke ``packaging.py`` to produce an Inno installer. You will |
|
34 | Next, invoke ``packaging.py`` to produce an Inno installer. You will | |
35 | need to supply the path to the Python interpreter to use.:: |
|
35 | need to supply the path to the Python interpreter to use.:: | |
36 |
|
36 | |||
37 |
$ py |
|
37 | $ py -3 contrib\packaging\packaging.py \ | |
38 | inno --python c:\python27\python.exe |
|
38 | inno --python c:\python27\python.exe | |
39 |
|
39 | |||
40 | .. note:: |
|
40 | .. note:: | |
41 |
|
41 | |||
42 | The script validates that the Visual C++ environment is |
|
42 | The script validates that the Visual C++ environment is | |
43 | active and that the architecture of the specified Python |
|
43 | active and that the architecture of the specified Python | |
44 | interpreter matches the Visual C++ environment and errors |
|
44 | interpreter matches the Visual C++ environment and errors | |
45 | if not. |
|
45 | if not. | |
46 |
|
46 | |||
47 | If everything runs as intended, dependencies will be fetched and |
|
47 | If everything runs as intended, dependencies will be fetched and | |
48 | configured into the ``build`` sub-directory, Mercurial will be built, |
|
48 | configured into the ``build`` sub-directory, Mercurial will be built, | |
49 | and an installer placed in the ``dist`` sub-directory. The final |
|
49 | and an installer placed in the ``dist`` sub-directory. The final | |
50 | line of output should print the name of the generated installer. |
|
50 | line of output should print the name of the generated installer. | |
51 |
|
51 | |||
52 | Additional options may be configured. Run |
|
52 | Additional options may be configured. Run | |
53 | ``packaging.py inno --help`` to see a list of program flags. |
|
53 | ``packaging.py inno --help`` to see a list of program flags. | |
54 |
|
54 | |||
55 | MinGW |
|
55 | MinGW | |
56 | ===== |
|
56 | ===== | |
57 |
|
57 | |||
58 | It is theoretically possible to generate an installer that uses |
|
58 | It is theoretically possible to generate an installer that uses | |
59 | MinGW. This isn't well tested and ``packaging.py`` and may properly |
|
59 | MinGW. This isn't well tested and ``packaging.py`` and may properly | |
60 | support it. See old versions of this file in version control for |
|
60 | support it. See old versions of this file in version control for | |
61 | potentially useful hints as to how to achieve this. |
|
61 | potentially useful hints as to how to achieve this. |
@@ -1,71 +1,71 b'' | |||||
1 | WiX Installer |
|
1 | WiX Installer | |
2 | ============= |
|
2 | ============= | |
3 |
|
3 | |||
4 | The files in this directory are used to produce an MSI installer using |
|
4 | The files in this directory are used to produce an MSI installer using | |
5 | the WiX Toolset (http://wixtoolset.org/). |
|
5 | the WiX Toolset (http://wixtoolset.org/). | |
6 |
|
6 | |||
7 | The MSI installers require elevated (admin) privileges due to the |
|
7 | The MSI installers require elevated (admin) privileges due to the | |
8 | installation of MSVC CRT libraries into the Windows system store. See |
|
8 | installation of MSVC CRT libraries into the Windows system store. See | |
9 | the Inno Setup installers in the ``inno`` sibling directory for installers |
|
9 | the Inno Setup installers in the ``inno`` sibling directory for installers | |
10 | that do not have this requirement. |
|
10 | that do not have this requirement. | |
11 |
|
11 | |||
12 | Requirements |
|
12 | Requirements | |
13 | ============ |
|
13 | ============ | |
14 |
|
14 | |||
15 | Building the WiX installers requires a Windows machine. The following |
|
15 | Building the WiX installers requires a Windows machine. The following | |
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 ``packaging.py`` script) |
|
21 | * Python 3.5+ (to run the ``packaging.py`` script) | |
22 |
|
22 | |||
23 | Building |
|
23 | Building | |
24 | ======== |
|
24 | ======== | |
25 |
|
25 | |||
26 | The ``packaging.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 | |
32 | C++ Compiler for Python 2.7``. From your Start Menu, look for |
|
32 | C++ Compiler for Python 2.7``. From your Start Menu, look for | |
33 | ``Microsoft Visual C++ Compiler Package for Python 2.7`` then |
|
33 | ``Microsoft Visual C++ Compiler Package for Python 2.7`` then | |
34 | launch either ``Visual C++ 2008 32-bit Command Prompt`` or |
|
34 | launch either ``Visual C++ 2008 32-bit Command Prompt`` or | |
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 ``packaging.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 |
$ py |
|
43 | $ py -3 contrib\packaging\packaging.py \ | |
44 | wix --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 | |
50 | Visual C++ environment. An error is raised otherwise. |
|
50 | Visual C++ environment. An error is raised otherwise. | |
51 |
|
51 | |||
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 ``packaging.py wix --help`` to |
|
57 | Additional options may be configured. Run ``packaging.py wix --help`` to | |
58 | see 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. | |
64 |
|
64 | |||
65 | The code for building TortoiseHG installers lives at |
|
65 | The code for building TortoiseHG installers lives at | |
66 | https://bitbucket.org/tortoisehg/thg-winbuild and is maintained by |
|
66 | https://bitbucket.org/tortoisehg/thg-winbuild and is maintained by | |
67 | Steve Borho (steve@borho.org). |
|
67 | Steve Borho (steve@borho.org). | |
68 |
|
68 | |||
69 | When changing behavior of the WiX installer, be sure to notify |
|
69 | When changing behavior of the WiX installer, be sure to notify | |
70 | the TortoiseHG Project of the changes so they have ample time |
|
70 | the TortoiseHG Project of the changes so they have ample time | |
71 | provide feedback and react to those changes. |
|
71 | provide feedback and react to those changes. |
General Comments 0
You need to be logged in to leave comments.
Login now