构建工具开发工具CLI【免费下载链接】CMakeMirror of CMake upstream repository项目地址https://gitcode.com/gh_mirrors/cm/CMake点击查看免费下载导读CMP0178 是 CMake 3.31 引入的兼容性策略核心变化是由add_test()、ExternalData_Add_Test()、gtest_add_tests()/gtest_discover_tests()添加的测试其命令行中的空参数empty arguments将不再被静默丢弃。具体涉及TEST_LAUNCHER、CROSSCOMPILING_EMULATOR两个目标属性中的空列表项以及 GoogleTest 系列命令EXTRA_ARGS关键字后的空元素。读完本文你将掌握该策略的触发场景、NEW/OLD 行为差异、cmake_policy设置方法以及底层cmTestGenerator的实现原理从而在升级 CMake 时正确处理空参数测试场景。策略概述与引入版本CMP0178 在 CMake 3.31 中引入官方定义见 CMP0178.rst其策略名称为Test command lines preserve empty arguments测试命令行保留空参数。在策略注册表中它的记录位于 cmPolicies.h注册参数为3, 31, 0, WARN即引入于 CMake 3.31默认WARN级别——当策略未显式设置时CMake 发出警告并使用OLD行为。SELECT(POLICY, CMP0178, Test command lines preserve empty arguments., 3, 31, 0, WARN)影响范围三种添加测试的途径该策略影响以下三种添加测试命令的途径add_test()命令ExternalData模块中的ExternalData_Add_Test()命令GoogleTest模块中的gtest_add_tests()或gtest_discover_tests()命令。对于gtest_add_tests()和gtest_discover_tests()EXTRA_ARGS关键字之后传递的值中的空元素同样受此策略影响。OLD 与 NEW 行为对比OLD 行为旧版默认OLD行为会静默丢弃以下场景中的空列表项TEST_LAUNCHER目标属性中的空列表项CROSSCOMPILING_EMULATOR目标属性中的空列表项gtest_add_tests()和gtest_discover_tests()命令EXTRA_ARGS之后给出的空元素。NEW 行为新版推荐NEW行为保留上述所有空列表项保留TEST_LAUNCHER目标属性中的空列表项保留CROSSCOMPILING_EMULATOR目标属性中的空列表项保留gtest_add_tests()和gtest_discover_tests()命令EXTRA_ARGS之后的空元素。简单地说NEW 让空参数原样进入最终生成的测试命令行OLD 则将其当作不存在。为什么要保留空参数在实际项目中空参数并非无意义。考虑以下典型场景测试启动器launcher带空槽位例如TEST_LAUNCHER被设置为launcher;arg1;;arg3中间的空元素可能代表一个占位符需要在运行时被工具解析如某些脚本约定参数索引位置交叉编译模拟器emulator参数拼接CROSSCOMPILING_EMULATOR用于在交叉编译时模拟运行测试目标如qemu-arm其中某些参数列表的空项影响命令行解析结果GoogleTest 扩展参数EXTRA_ARGS之后传入的空字符串可能对应某个必须以位置对齐的测试参数。OLD 行为将此类空项静默剔除会导致生成的测试命令与开发者意图不一致且没有任何提示难以排查。CMP0178 的 NEW 行为通过保留空项修复了这一问题。策略设置方法与其他 CMake 策略一样CMP0178 可通过cmake_policy或cmake_minimum_required设置官方说明见 STANDARD_ADVICE.rst该策略在 CMake 3.31 中引入可通过cmake_policy或cmake_minimum_required设置。若未设置CMake 发出警告并使用OLD行为。典型设置方式# 方法一在调用受影响命令之前显式开启 NEW 行为 cmake_policy(SET CMP0178 NEW) # 方法二通过 cmake_minimum_required 声明最低版本 # 若声明的版本 3.31则该目录内 CMP0178 自动为 NEW cmake_minimum_required(VERSION 3.31)需要注意的是OLD行为按定义已被弃用见 DEPRECATED.rst并可能在未来的 CMake 版本中被移除因此新项目应直接使用NEW行为。源码级实现原理策略状态的读取与记录在 cmAddTestCommand.cxx 中add_test()命令解析时读取当前策略状态并把它记录到测试对象上// 旧式签名add_test(name command ...) cmPolicies::PolicyStatus cmp0178 mf.GetPolicyStatus(cmPolicies::CMP0178); ... test-SetCMP0178(cmp0178);// 新式签名add_test(NAME name COMMAND command ...) cmPolicies::PolicyStatus cmp0178 mf.GetPolicyStatus(cmPolicies::CMP0178); ... test-SetCMP0178(cmp0178);这里通过cmMakefile::GetPolicyStatus(cmPolicies::CMP0178)读取策略状态并通过cmTest::SetCMP0178()将状态与测试绑定供后续生成阶段使用。测试命令行的生成launcher 与 emulator 的拼接真正决定空参数是否保留的代码位于 cmTestGenerator.cxx 的GenerateCommand()函数中约 第 230-288 行。核心逻辑如下auto addLauncher { cmValue launcher target-GetProperty(propertyName); if (!cmNonempty(launcher)) { return; } auto const propVal ge.Parse(*launcher)-Evaluate(this-LG, config); cmList launcherWithArgs(propVal, cmList::ExpandElements::Yes, cmp0178 cmPolicies::NEW ? cmList::EmptyElements::Yes : cmList::EmptyElements::No); ... };可以看到解析 launcher 属性时是否保留空元素完全取决于策略状态cmp0178 NEW→cmList::EmptyElements::Yes保留空项否则OLD→cmList::EmptyElements::No丢弃空项。两个属性按以下顺序被处理// Prepend with the test launcher if specified. addLauncher(TEST_LAUNCHER); // Prepend with the emulator when cross compiling if required. if (cmp0158 ! cmPolicies::NEW || this-LG-GetMakefile()-IsOn(CMAKE_CROSSCOMPILING)) { addLauncher(CROSSCOMPILING_EMULATOR); }即先拼接TEST_LAUNCHER再在交叉编译场景下拼接CROSSCOMPILING_EMULATOR最终依次输出 launcher 可执行文件、launcher 参数、emulator、emulator 参数、测试可执行文件及其参数。WARN 模式下的兼容性警告当策略状态为WARN时即未显式设置且按OLD行为运行代码会对比丢弃空项与保留空项两种解析结果若两者不一致则发出 CMP0178 警告if (cmp0178 cmPolicies::WARN) { cmList argsWithEmptyValuesPreserved( propVal, cmList::ExpandElements::Yes, cmList::EmptyElements::Yes); if (launcherWithArgs ! argsWithEmptyValuesPreserved) { this-LG-GetMakefile()-IssuePolicyWarning( cmPolicies::CMP0178, cmStrCat(The , propertyName, property of target , target-GetName(), contains empty list items. Those empty items are being silently discarded to preserve backward compatibility.)); } }警告信息明确提示目标某属性包含空列表项为保持向后兼容这些空项将被静默丢弃。这帮助用户在升级到 3.31 后第一时间发现空参数丢失问题。测试对象的策略绑定cmTest类保存策略状态相关定义见 cmTest.h 与 cmTest.cxx。当add_test()以旧式签名调用时若命令中携带内部关键字__CMP0178位于参数末尾则直接依据其后的NEW/OLD/其他值确定策略状态否则回落到mf.GetPolicyStatus(cmPolicies::CMP0178)见 cmAddTestCommand.cxx 第 40-58 行。该机制是生成器表达式求值后cmTestGenerator生成 CTest 脚本时读取策略的依据。典型场景示例示例 1TEST_LAUNCHER 中的空参数cmake_minimum_required(VERSION 3.31) # CMP0178 自动为 NEW add_executable(my_app main.c) # launcher 列表中存在空项第二个位置为空 set_property(TARGET my_app PROPERTY TEST_LAUNCHER wrap.py;;--modefast) add_test(NAME my_test COMMAND my_app --do-something)在NEW行为下生成的测试命令行等价于wrap.py --modefast /path/to/my_app --do-something空参数会被保留并作为独立参数传递给测试启动器而在OLD行为下该空项会被丢弃命令行变成wrap.py --modefast /path/to/my_app --do-something对于依赖参数位置例如wrap.py期望第二个参数是空占位符的启动器两种行为会产生截然不同的运行结果。示例 2交叉编译模拟器cmake_minimum_required(VERSION 3.31) add_executable(firmware main.c) # 交叉编译时用 qemu 模拟运行模拟器参数中带空项 set_property(TARGET firmware PROPERTY CROSSCOMPILING_EMULATOR qemu-arm;-L;--;)启用NEW后空项会被保留模拟器命令行与开发者设定的参数列表完全一致而在OLD行为下空项被剔除可能导致模拟器参数错位。示例 3GoogleTest 的 EXTRA_ARGSinclude(GoogleTest) gtest_add_tests( TARGET my_unit_tests EXTRA_ARGS --gtest_filterSuite.* --shuffle )NEW行为保留EXTRA_ARGS之后的空元素测试过滤器后的空参数会原样传给测试可执行文件OLD行为则会将其丢弃。策略设置建议与注意事项新项目直接使用cmake_minimum_required(VERSION 3.31)或cmake_policy(SET CMP0178 NEW)让空参数语义始终明确存量项目升级若测试涉及TEST_LAUNCHER、CROSSCOMPILING_EMULATOR或 GoogleTestEXTRA_ARGS升级到 3.31 后应关注 WARN 模式下的 CMP0178 警告确认旧行为是否依赖空项被丢弃这一隐含语义设置位置cmake_policy必须在调用add_test()、ExternalData_Add_Test()、gtest_add_tests()、gtest_discover_tests()之前设置策略按目录作用域生效未来兼容性OLD行为已被弃用可能在后续版本中被移除参见 DEPRECATED.rst建议尽早迁移到NEW。总结CMP0178 是 CMake 3.31 中一项行为修正型策略它结束了TEST_LAUNCHER、CROSSCOMPILING_EMULATOR属性及 GoogleTestEXTRA_ARGS中空参数被静默丢弃的历史通过cmTestGenerator在生成 CTest 测试脚本时按策略状态决定cmList是否保留空元素并在 WARN 模式下给出明确提示。对依赖参数位置语义的测试启动器、交叉编译模拟器以及 GTest 参数对齐场景本策略直接决定了生成的测试命令行是否符合开发者预期。升级至 CMake 3.31 后建议统一启用NEW行为以获取清晰、可预期的空参数传递语义。赞分享构建工具开发工具CLI【免费下载链接】CMakeMirror of CMake upstream repository项目地址https://gitcode.com/gh_mirrors/cm/CMake点击查看免费下载相关推荐CMake GUI 命令行参考cmake-gui 的参数、预设与使用全指南CMake GUI 命令行参考cmake gui 的参数、预设与使用全指南 导读 本文以 CMake 仓库中的官方手册 Help/manual/cmake g构建工具开发工具CLItaskbook单元测试策略确保命令行工具的稳定性taskbook单元测试策略确保命令行工具的稳定性 作为一款命令行任务管理工具taskbook需要在各种终端环境下保持稳定运行。本文将从单元测试框架选型、核开发工具Angular-Samples中的RxJS实战打造响应式Log Tail与数据流管理Angular Samples中的RxJS实战打造响应式Log Tail与数据流管理 Angular Samples项目是学习Angular框架的优质资源库上一篇终极指南如何在Windows上免费安装ViGEmBus虚拟手柄驱动解决游戏兼容性问题下一篇Rerun TextDocument Archetype 详解在独立文本框中记录纯文本与 Markdown 文档创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考