This topic explains how to install the new platform port and use it in Qt Creator.
There are two main approaches to build applications against a platform port of Qt Quick Ultralite:
- Build the application against a developer build of the platform port.
- Install the platform port to a self-contained location.
The first one is practical if the port is still being developed, as it helps you test changes quickly against an application.
Assuming that you are using the ARM GCC toolchain, set the
ARMGCC_DIR environment variable to the ARM GCC toolchain location on your computer:
In addition, set the
QUL_SRC_DIR variable to the platform port location, and
QUL_GENERATORS_FILE to the Qt Quick Ultralite host tools'
QulGenerators.cmake file location.
QUL_TOOLCHAIN_FILE should be set to the location of the cmake file defining the toolchain being used.
QUL_SRC_DIR needs to be set to the directory which contains the root
CMakeLists.txt file for the Qt Quick Ultralite project.
set QUL_SRC_DIR=C:\path\to\qul\sources set QUL_GENERATORS_FILE=%QUL_SRC_DIR%\lib\cmake\Qul\QulGenerators.cmake set QUL_TOOLCHAIN_FILE=%QUL_SRC_DIR%\lib\cmake\Qul\toolchain\armgcc.cmake
To use nmake, run the "vcvarsx86_amd64.bat" Windows batch file, which is found in the "VC\Auxiliary\Build" Visual Studio directory. Alternatively, you can run "x86_x64 Cross Tools Command Prompt for VS 2017" or the equivalent for your version of Visual Studio.
To build the plaform as a developer build, run these commands:
cmake %QUL_SRC_DIR% -G "NMake Makefiles" -DCMAKE_BUILD_TYPE=Release -DCMAKE_TOOLCHAIN_FILE=%QUL_TOOLCHAIN_FILE% -DQUL_GENERATORS=%QUL_GENERATORS_FILE% -DQUL_PLATFORM=example-baremetal nmake
To install a platform build, use the
CMAKE_INSTALL_PREFIX option, in addition to the CMake options for the developer build. In the following CMake command, set the
CMAKE_INSTALL_PREFIX to the path where you want to install the port:
cmake %QUL_SRC_DIR% -G "NMake Makefiles" -DCMAKE_BUILD_TYPE=Release -DCMAKE_TOOLCHAIN_FILE=%QUL_TOOLCHAIN_FILE% -DQUL_GENERATORS=%QUL_GENERATORS_FILE% -DQUL_PLATFORM=example-baremetal -DCMAKE_INSTALL_PREFIX=C:\dev\qul-example-platform nmake nmake install
Ensure to set up your Qt Creator development environment with the MCU plugin as described in the Qt Creator Manual > Connecting MCUs topic.
Note: Qt Creator does not support custom toolchains yet, so for Qt Creator support one of the toolchains shipped with Qt Quick Ultralite in
lib\cmake\Qul\toolchain must be used.
To build the platform port for Qt Creator integration, set these two environment variables:
CMAKE_INSTALL_PREFIXto Qt for MCUs install directory. It should match the Qt for MCUs version set in the Tools > Options > Devices > MCU option in Qt Creator.
QUL_VERSIONto the corresponding version number. For example, if Qt Creator is configured to use
<VERSION>is the directory containing the Qt Quick Ultralite version you are using (for example 1.5).
After setting these variables, use the following commands to configure and install the platform port:
set QUL_VERSION=<VERSION> set QUL_INSTALL_PREFIX=C:\Qt\QtMCUs\%QUL_VERSION% cmake %QUL_SRC_DIR% -G "NMake Makefiles" -DCMAKE_BUILD_TYPE=Release -DCMAKE_TOOLCHAIN_FILE=%QUL_TOOLCHAIN_FILE% -DQUL_GENERATORS=%QUL_GENERATORS_FILE% -DQUL_PLATFORM=example-baremetal -DCMAKE_INSTALL_PREFIX=%QUL_INSTALL_PREFIX% -DQUL_VERSION=%QUL_VERSION% -DQUL_BUILD_DEMOS=off -DQUL_BUILD_EXAMPLES=off nmake nmake install
You can disable building of demos and examples, as they are not needed for the Qt Creator integration.
Once the installation is complete, create a kit for your platform port using the Tools > Options > Devices > MCU option in Qt Creator. If a kit is already configured for the target, remove it before creating the new one.
Finally, the kit for your platform is ready for use in Qt Creator. If you created an Mcu Support Application project, use the new kit to build and link the Qt Quick Ultralite application against your platform library.
Assuming that you have set up the flash targets as described in Getting started, run the application on the target hardware by pressing the Run button in Qt Creator.
Available under certain Qt licenses.
Find out more.