C
Renesas RA板上CMake手册
CMake构建工具简化了开发项目的构建过程。它自动生成构建系统，如Makefiles和Visual Studio项目文件。
CMake是一个第三方工具，它有自己的文档。本主题描述了在为Renesas RA板开发应用程序时如何使用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
构建配置
在为Renesas RA板开发应用程序时，请配置以下CMake变量。
设置EK-RA6M3G的开发环境
为EK-RA6M3G配置以下CMake变量。
| 变量 | 步骤 |
|---|---|
| Qul_ROOT | 将Qul_ROOT设置为Qt for MCUs SDK安装路径。-DQul_ROOT=$QUL_ROOT -DQul_ROOT=%QUL_ROOT% 注意：此CMake变量故意使用混合大小写，因为它需要与包名匹配。 |
| QUL_PLATFORM | 使用ek-ra6m3g-baremetal为EK-RA6M3G板设置平台。-DQUL_PLATFORM=ek-ra6m3g-baremetal |
FREERTOS_DIR | FreeRTOS源代码目录的绝对路径。仅适用于FreeRTOS目标。有关FreeRTOS平台的更多信息，请参阅FreeRTOS平台。-DFREERTOS_DIR=< FreeRTOS directory path > |
| CMAKE_TOOLCHAIN_FILE | 将CMAKE_TOOLCHAIN_FILE设置为Arm GCC或IAR工具链。-DCMAKE_TOOLCHAIN_FILE=$QUL_ROOT/lib/cmake/Qul/toolchain/armgcc.cmake -DCMAKE_TOOLCHAIN_FILE=%QUL_ROOT%\lib\cmake\Qul\toolchain\armgcc.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_COLOR_DEPTH | 使用QUL_COLOR_DEPTH来设置平台支持的颜色深度。EK-RA6M3G参考端口支持16bpp颜色深度。-DQUL_COLOR_DEPTH=16 注意：如果未设置此变量，则在配置平台时将使用默认颜色深度。 |
| QUL_BOARD_SDK_DIR | 将此变量设置为Renesas灵活软件包（FSP）的安装路径。 例如 -DQUL_BOARD_SDK_DIR=$QUL_TOOLS/Renesas/fsp-<version> -DQUL_BOARD_SDK_DIR=%QUL_TOOLS%\Renesas\fsp-<version> |
| JLINK_PATH | 将 JLINK_PATH CMake 缓存条目设置为 SEGGER J-Link 的安装路径，如果它没有安装在默认位置。例如 -DJLINK_PATH=/opt/SEGGER/JLink -DJLINK_PATH=C:\tools\SEGGER\JLink 注意事项
|
为 EK-RA8D1 设置开发环境
| 变量 | 步骤 |
|---|---|
| QUL_PLATFORM | 使用 ek-ra8dm1-baremetal 为 EK-RA8D1 板设置平台。-DQUL_PLATFORM=ek-ra8dm1-baremetal |
除了特定于板级的 QUL_PLATFORM 变量 (ek-ra8dm1-baremetal) 和对于 EK-RA8D1 无效的 FREERTOS_DIR 以外，EK-RA6M3G 的 CMake 值也对 EK-RA8D1 有效，因为 EK-RA8D1 只提供了裸金属平台适配。
注意：在 Qt Quick Ultralite 项目中，CMAKE_BUILD_TYPE 默认设置为 MinSizeRel。 MinSizeRel 是 Qt Quick Ultralite 随附预构建平台库所使用的构建类型。要更改构建类型（例如，设置为 Release），请使用 -DCMAKE_BUILD_TYPE=Release 选项调用 CMake。有关更多信息，请参阅 CMAKE_BUILD_TYPE。
在某些 Qt 许可证下可用。
了解更多信息。
