本主题解释了如何安装新的平台移植版本，以及如何在 Qt Creator 中使用它。

构建针对 Qt Quick Ultralite 平台移植的应用程序主要有两种方法

• 构建应用程序以平台移植的开发版本为目标。
• 将平台移植安装到自包含的位置。

如果移植版本仍在开发中，第一种方法比较实用，因为它可以帮助您快速在应用程序上测试更改。

QUL_ROOT 和 QUL_TOOLS 在下面的命令行示例中用作环境变量，如下所示

export QUL_ROOT=$HOME/Qt/QtMCUs/2.8.0
export QUL_TOOLS=$HOME/Qt/Tools/QtMCUs

set QUL_ROOT=C:\Qt\QtMCUs\2.8.0
set QUL_TOOLS=C:\Qt\Tools\QtMCUs

根据使用的工具链，您必须设置 QUL_TOOLCHAIN_FILE 为

export QUL_TOOLCHAIN_FILE=$QUL_ROOT/lib/cmake/Qul/toolchain/armgcc.cmake

export QUL_TOOLCHAIN_FILE=$QUL_ROOT/lib/cmake/Qul/toolchain/iar.cmake

set QUL_TOOLCHAIN_FILE=%QUL_ROOT%\lib\cmake\Qul\toolchain\armgcc.cmake

set QUL_TOOLCHAIN_FILE=%QUL_ROOT%\lib\cmake\Qul\toolchain\iar.cmake

QUL_TARGET_TOOLCHAIN_DIR 需要使用 cmake 缓存条目来提供使用工具链的位置。

要使用 nmake，运行位于“VC\Auxiliary\Build” Visual Studio 目录中的“vcvarsx86_amd64.bat” Windows 批处理文件。或者，您也可以运行“x86_x64 Cross Tools Command Prompt for VS 2017”或您 Visual Studio 版本对应的工具。

开发版本

要构建平台的开发版本，请运行以下命令

cmake $QUL_ROOT -DCMAKE_BUILD_TYPE=MinSizeRel -DCMAKE_TOOLCHAIN_FILE=$QUL_TOOLCHAIN_FILE -DQUL_TARGET_TOOLCHAIN_DIR=/path/to/the/toolchain -DQUL_GENERATORS=$QUL_ROOT/lib/cmake/Qul/QulGenerators.cmake -DQUL_PLATFORM=example-baremetal
nmake

cmake %QUL_ROOT% -G "NMake Makefiles" -DCMAKE_BUILD_TYPE=MinSizeRel -DCMAKE_TOOLCHAIN_FILE=%QUL_TOOLCHAIN_FILE% -DQUL_TARGET_TOOLCHAIN_DIR=C:\path\to\the\toolchain -DQUL_GENERATORS=%QUL_ROOT%\lib\cmake\Qul\QulGenerators.cmake -DQUL_PLATFORM=example-baremetal
nmake

已安装的构建

要安装平台构建，请使用 CMAKE_INSTALL_PREFIX 选项，除了开发版本的 CMake 选项之外。在下面的 CMake 命令中，将 CMAKE_INSTALL_PREFIX 设置为您想要安装移植版本的路徑

cmake $QUL_ROOT -DCMAKE_BUILD_TYPE=MinSizeRel -DCMAKE_TOOLCHAIN_FILE=$QUL_TOOLCHAIN_FILE -DQUL_TARGET_TOOLCHAIN_DIR=/path/to/the/toolchain -DQUL_GENERATORS=$QUL_ROOT/lib/cmake/Qul/QulGenerators.cmake -DQUL_PLATFORM=example-baremetal -DCMAKE_INSTALL_PREFIX=~/dev/qul-example-platform
nmake
nmake install

cmake %QUL_ROOT% -G "NMake Makefiles" -DCMAKE_BUILD_TYPE=MinSizeRel -DCMAKE_TOOLCHAIN_FILE=%QUL_TOOLCHAIN_FILE% -DQUL_TARGET_TOOLCHAIN_DIR=c:\path\to\the\toolchain -DQUL_GENERATORS=%QUL_ROOT%\lib\cmake\Qul\QulGenerators.cmake -DQUL_PLATFORM=example-baremetal -DCMAKE_INSTALL_PREFIX=C:\dev\qul-example-platform
nmake
nmake install

Qt Creator 集成

按照 Qt Creator 手册 > 连接到 MCU 主题中所述，设置您的 Qt Creator 开发环境，并使用 MCU 插件。

要为 Qt Creator 集成构建平台移植版本，设置这两个环境变量

• CMAKE_INSTALL_PREFIX 设置为 Qt for MCUs 安装目录。它应与 Qt Creator 中“编辑 > 首选项 > 设备 > MCU”选项中设置的 Qt for MCUs 版本相匹配。
• QUL_VERSION 设置为对应版本号。例如，如果 Qt Creator 配置为使用 C:\Qt\QtMCUs\<VERSION>，其中 <VERSION> 是包含您正在使用的 Qt Quick Ultralite 版本的目录（例如 2.8.0）。

设置这些变量后，使用以下命令配置和安装平台端口

export QUL_VERSION=<VERSION>
cmake $QUL_ROOT -G "NMake Makefiles" -DCMAKE_BUILD_TYPE=MinSizeRel -DCMAKE_TOOLCHAIN_FILE=$QUL_TOOLCHAIN_FILE -DQUL_TARGET_TOOLCHAIN_DIR=/path/to/the/toolchain -DQUL_GENERATORS=$QUL_ROOT/lib/cmake/Qul/QulGenerators.cmake -DQUL_PLATFORM=example-baremetal -DCMAKE_INSTALL_PREFIX=$QUL_ROOT -DQUL_VERSION=$QUL_VERSION -DQUL_BUILD_DEMOS=off -DQUL_BUILD_EXAMPLES=off
nmake
nmake install

set QUL_VERSION=<VERSION>
cmake %QUL_ROOT% -G "NMake Makefiles" -DCMAKE_BUILD_TYPE=MinSizeRel -DCMAKE_TOOLCHAIN_FILE=%QUL_TOOLCHAIN_FILE% -DQUL_TARGET_TOOLCHAIN_DIR=c:\path\to\the\toolchain -DQUL_GENERATORS=%QUL_ROOT%\lib\cmake\Qul\QulGenerators.cmake -DQUL_PLATFORM=example-baremetal -DCMAKE_INSTALL_PREFIX=%QUL_ROOT% -DQUL_VERSION=%QUL_VERSION% -DQUL_BUILD_DEMOS=off -DQUL_BUILD_EXAMPLES=off
nmake
nmake install

您可以禁用构建演示和示例，因为它们对于 Qt Creator 集成不是必需的。

如果您正在使用 Qt for MCUs evaluations 版本或不想重新构建框架，请在之前的命令中添加以下 CMake 选项

-DQul_ROOT=$QUL_ROOT -DQUL_BUILD_FRAMEWORK=OFF

-DQul_ROOT=%QUL_ROOT% -DQUL_BUILD_FRAMEWORK=OFF

安装完成后，使用 Qt Creator 中的 编辑 > 首选项 > 设备 > MCU 选项创建平台端口工具包。如果已为目标配置了工具包，则在创建新工具包之前请将其删除。

最后，您的平台工具包已准备好在 Qt Creator 中使用。如果您创建了一个 Mcu Support Application 项目，请使用新的工具包构建和链接 Qt Quick Ultralite 应用程序，使其针对您的平台库进行编译和链接。

假设您已按 入门指南 中所述设置闪存目标，则通过在 Qt Creator 中按 运行 按钮来在目标硬件上运行应用程序。