Building the Application

pyqtdeploy-build uses the project file created by pyqtdeploy to generate the target-specific source code, including the qmake .pro files, needed to create the application. The simplest invocation is:

pyqtdeploy-build pyqt-demo.pdy

The next step in the full build process would be to change to the build directory and run qmake. The final step is target-specific. For Linux, macOS and Windows targets it is only necessary to run make (or nmake in the case of Windows). For an Android target it is necessary to run make and Qt’s androiddeployqt utility. For an iOS target qmake generates an Xcode project file. Xcode is then used to perform the final build.

The demo’s build-demo.py script takes care of (almost) all of this process automatically.

The Command Line

The full set of command line options is:

-h, --help

This will display a summary of the command line options.

--build-dir DIR

DIR is the name of the directory where all the application source code will be placed. The default value is build- followed by a target-specific suffix.

--include-dir DIR

DIR is the name of the directory containing the target Python installation’s Python.h file. It overrides any value specified in the project file.

--interpreter EXECUTABLE

EXECUTABLE is the host Python interpreter used to compile all of the Python modules used by the application. It overrides any value specified in the project file.

--no-clean

Normally the build directory is deleted and re-created before starting a new build. Specifying this option leaves any existing build directory as it is before starting a new build.

--opt LEVEL

LEVEL is the level of optimisation performed when freezing Python source files:

0 - no optimisation is done

1 - assert statements are removed

2 - assert statements and docstrings are removed.

The default is 2.

--python-library LIB

LIB is the name of the target Python interpreter library. It overrides any value specified in the project file.

--resources NUMBER

NUMBER is the number of Qt .qrc resource files that are generated. On Windows, MSVC may not be able to cope with very large resource files and complains of a lack of heap space. If you run into this problem then try increasing the the number of resource files generated.

--source-dir DIR

DIR is the name of the directory containing the Python source code. It overrides any value specified in the project file.

--standard-library-dir DIR

DIR is the name of the directory containing the target Python interpreter’s standard library. It overrides any value specified in the project file.

--sysroot DIR

DIR is the name of the system image root directory. The SYSROOT environment variable is set to DIR during the build replacing any existing value. The default value is sysroot- followed by a target-specific suffix, but this is not set if the SYSROOT environment variable already has a value.

--target TARGET

TARGET is the target architecture. By default the host architecture is used. On Windows the default is determined by the target architecture of the currently configured compiler.

--quiet

This specifies that progress messages should be disabled.

--verbose

This specifies that additional progress messages should be enabled.

-V, --version

This specifies that the version number should be displayed on stdout. The program will then terminate.

project

project is the name of the project file created by pyqtdeploy.