summaryrefslogtreecommitdiff
path: root/package/windows/README.rst
blob: 97c1d548a78d3062576c07aa1780b6a3e75bd405 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
Generate silx fat binary for Windows
====================================

Pre-requisites
--------------

- PyInstaller must be installed.
  It is best to use the development version to use package specific hooks up-to-date.
  Run either::
  
    pip install -r requirements-dev.txt

  or::

    pip install https://github.com/pyinstaller/pyinstaller/archive/develop.zip

- silx and all its dependencies must be INSTALLED::

    pip install silx[full]
 
  or from the source directory::

    pip install .[full]


Procedure
---------

- Go to the ``package/windows`` folder in the source directory
- Run ``pyinstaller pyinstaller.spec``.
  This generates a fat binary in ``package/windows/dist/silx/`` for the generic launcher ``silx.exe``.
- Run ``pyinstaller pyinstaller-silx-view.spec``.
  This generates a fat binary in ``package/windows/dist/silx-view/`` for the silx view command ``silx-view.exe``.
- Copy ``silx-view.exe`` and ``silx-view.exe.manifest`` to ``package/windows/dist/silx/``.
  This is a hack until PyInstaller supports multiple executables (see https://github.com/pyinstaller/pyinstaller/issues/1527).
- Zip ``package\windows\dist\silx`` to make the application available as a single zip file.