CMake交叉编译时为何工具链文件被多次执行且后次变量丢失?
问题根本原因分析
为什么CMake会多次执行工具链与平台配置文件
CMake的交叉编译配置流程中,共有三类场景会触发工具链、平台文件的重复执行:
- 主配置进程初始化阶段:刚读取
CMAKE_TOOLCHAIN_FILE时,会完整执行一次工具链文件,完成基础交叉编译参数的设置 project()命令执行阶段:会根据已设置的CMAKE_SYSTEM_NAME,加载对应路径下的平台配置文件(即SDCC_PIC_16F877A.cmake),完成平台专属参数配置- 编译器检测的
try_compile子进程阶段:CMake确定编译器路径后,会启动一个完全独立的临时CMake配置实例(存放在CMakeFiles/CMakeTmp目录下),用来测试编译器是否可正常编译、链接。该临时实例为保持与主项目一致的交叉编译环境,会重新加载CMAKE_TOOLCHAIN_FILE与对应平台配置文件,这是第三轮执行的来源。
为什么最后一次执行时SDCC_ROOT变为空
这是CMake交叉编译的默认机制限制导致的:
try_compile创建的临时实例是完全独立的CMake配置进程,不会自动继承主项目的命令行参数,也不会直接读取主项目的CMakeCache.txt,只会继承CMake内置的、被标记为需要传递给编译测试的变量- 你自定义的
SDCC_ROOT属于用户自定义变量,默认不在CMake自动传递给try_compile的变量列表中。当临时子进程重新执行工具链文件时,既没有拿到你最初命令行传入的-DSDCC_ROOT=...参数,也没有从主项目缓存中获取到该值,因此变量为空触发报错。
除此之外,当前配置的两个设计缺陷放大了问题:
- 未在工具链文件中提前将sdcc指定为缓存级编译器:CMake默认的编译器查找逻辑会优先搜索宿主机系统路径下的编译器,未显式指定
CMAKE_C_COMPILER为sdcc,导致CMake找到了宿主机的GCC(/usr/bin/cc),触发了针对宿主机编译器的测试流程,进一步暴露了变量丢失的问题 - 拼写错误
FATA_ERROR应为FATAL_ERROR,不影响核心逻辑但会导致错误提示未正常终止流程
符合CMake规范的修正方案(无临时hack)
强制指定交叉编译器,阻止CMake搜索宿主机编译器
在toolchain.cmake中设置CMAKE_SYSTEM_NAME之后添加以下内容,将编译器配置写入缓存并强制覆盖默认查找结果:set(CMAKE_C_COMPILER sdcc CACHE FILEPATH "C compiler for SDCC" FORCE) # 若确认sdcc可正常工作,可跳过编译器测试流程,避免触发try_compile set(CMAKE_C_COMPILER_WORKS TRUE CACHE INTERNAL "Skip compiler validation" FORCE)显式指定需要传递给编译测试子进程的自定义变量
使用CMake官方提供的CMAKE_TRY_COMPILE_PLATFORM_VARIABLES机制,告知CMake将你的自定义变量传递给try_compile子进程,在toolchain.cmake中添加:list(APPEND CMAKE_TRY_COMPILE_PLATFORM_VARIABLES SDCC_ROOT MICROCHIP_FAMILY MICROCHIP_MODEL )将
CMAKE_SYSTEM_NAME设置为缓存变量
避免跨进程传递时丢失目标系统配置,修改工具链文件中的对应设置:set(CMAKE_SYSTEM_NAME SDCC_PIC_16F877A CACHE INTERNAL "Target system name")
内容的提问来源于stack exchange,提问作者Mat Gomes
相关产品推荐
相关产品推荐

