CMake手册 使用CMake入门

C

CMake手册用于瑞萨RH板

CMake构建工具简化了开发项目的构建过程。它自动生成构建系统，如Makefiles和Visual Studio项目文件。

CMake是一个第三方工具，它有自己的文档。本主题描述了如何在为瑞萨RH板开发应用程序时使用CMake与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

构建配置

设置RH850/D1M1A的开发环境

开发RH850/D1M1A应用程序时，配置以下CMake变量。

变量程序
Qul_ROOT将Qul_ROOT设置为Qt for MCUs SDK的安装路径。
-DQul_ROOT=$QUL_ROOT
-DQul_ROOT=%QUL_ROOT%

注意：此CMake变量故意使用混合大小写，因为它需要与包名匹配。

QUL_PLATFORM平台名称必须指明要针对的板和操作系统。它是已选择板的名称与要针对的操作系统的一种组合。以下示例中的平台名称表示目标为RH850/D1M1A上的baremetal。
-DQUL_PLATFORM=rh850-d1m1a-baremetal

注意：如果您想针对其他板或操作系统，请查阅支持的平台以获取更多信息。

CMAKE_TOOLCHAIN_FILE将CMAKE_TOOLCHAIN_FILE设置为GHS工具链。
-DCMAKE_TOOLCHAIN_FILE=$QUL_ROOT/lib/cmake/Qul/toolchain/ghs.cmake
-DCMAKE_TOOLCHAIN_FILE=%QUL_ROOT%\lib\cmake\Qul\toolchain\ghs.cmake
QUL_TARGET_TOOLCHAIN_DIR使用QUL_TARGET_TOOLCHAIN_DIR设置工具链的位置。
-DQUL_TARGET_TOOLCHAIN_DIR=/path/to/the/toolchain
-DQUL_TARGET_TOOLCHAIN_DIR=C:\path\to\the\toolchain

注意：位于指定QUL_TARGET_TOOLCHAIN_DIR中的工具链必须与CMAKE_TOOLCHAIN_FILE中指定的工具链匹配。

QUL_COLOR_DEPTH使用QUL_COLOR_DEPTH来设置平台支持的颜色深度。RH850/D1M1A的参考端口支持32bpp颜色深度。
-DQUL_COLOR_DEPTH=32

注意：如果没有设置此变量，则在配置平台时将使用默认颜色深度。

PROBE_TYPE使用PROBE_TYPE来选择瑞萨Flash Programmer在烧写二进制文件时所需使用的瑞萨调试器类型。E1、E2和E20是支持的工具类型。
-DPROBE_TYPE=E2

注意： 若未设置此变量，则 Renesas Flash Programmer 将使用默认的探针类型（《E1》）。

QUL_BOARD_SDK_DIR将 QUL_BOARD_SDK_DIR 的 CMake 缓存条目设置为 Renesas 图形库的安装路径。例如： 
-DQUL_BOARD_SDK_DIR=$HOME/Renesas_Electronics/D1x_RGL/rgl_ghs_D1Mx_obj_V2.1.0a
-DQUL_BOARD_SDK_DIR=C:\Renesas_Electronics\D1x_RGL\rgl_ghs_D1Mx_obj_V2.1.0a
针对 RH850/D1M1A 的可选配置
RENESAS_FLASH_PROGRAMMER_PATH将可选的 RENESAS_FLASH_PROGRAMMER_PATH CMake 缓存条目设置为 Renesas Flash Programmer 的安装路径。例如： 
-DRENESAS_FLASH_PROGRAMMER_PATH="$HOME/Renesas Electronics/Renesas Flash Programmer"
-DRENESAS_FLASH_PROGRAMMER_PATH="C:\Program Files (x86)\Renesas Electronics\Renesas Flash Programmer"

注意： 如果在系统中找到 Renesas Flash Programmer 软件包，将创建闪存目标。

注意： 在 Qt Quick Ultralite 项目中，默认将 CMAKE_BUILD_TYPE 设置为 MinSizeRel。 MinSizeRel 用于 Qt Quick Ultralite 随附的预构建平台库的构建。要更改构建类型（例如设置为 Release），请使用带有 -DCMAKE_BUILD_TYPE=Release 选项的 CMake。有关更多信息，请参阅 CMAKE_BUILD_TYPE。

CMake 手册 使用 CMake 入门

受特定 Qt 许可证保护。
了解更多信息。