当前位置：首页 > article >正文

CMake中的变量: CTest，CPack，CMake内部定义的变量

article 2024/11/15 19:31:36

文章目录

cmake内部定义的变量
与CPack相关的变量
与CTest相关的变量

cmake内部定义的变量

变量名称	描述
CMAKE_HOME_DIRECTORY	源树顶部的路径。与CMAKE_SOURCE_DIR相同。这是一个内部缓存条目，用于在从构建树加载CMakeCache.txt时定位源目录。不应在项目代码中使用它。变量CMAKE_SOURCE_DIR具有相同的值，应优先使用。
CMAKE_INTERNAL_PLATFORM_ABI	一种可能发生变化的内部变量。这用于确定编译器ABI，并且可能会发生更改。
CMAKE COMPILER_ABI	一种可能发生变化的内部变量。这用于确定编译器ABI，并且可能会发生更改。
CMAKE COMPILER_ARCHITECTURE_ID	一种可能发生变化的内部变量。这用于根据编译器的目标体系结构识别其变体。对于某些编译器来说，这是确定正确用法所必需的。
CMAKE COMPILER_VERSION_INTERNAL	一种可能发生变化的内部变量。这用于根据内部版本号识别编译器的变体。对于某些编译器来说，这是确定正确用法所必需的。
CMAKE LINKER_PREFERENCE	一种可能发生变化的内部变量。链接器语言选择的首选项值。可执行文件、共享库和模块目标的“链接器语言”是编译器将调用链接器的语言。LINKER_LANGUAGE目标属性显式设置语言。否则，链接器语言是在编译并链接到目标中的语言中链接器首选项值最高的语言。另请参见CMAKE__LINKER_PREFERENCE_PROPAGATES变量。
CMAKE LINKER_PREFERENCE_PROPAGATES	一种可能发生变化的内部变量。如果CMAKE__LINKER_PREFERENCE在目标之间传播，则为True。当CMake为目标选择链接器语言时，会使用此选项。总是考虑直接编译到目标中的语言。如果此变量为true，则考虑编译到由目标链接的静态库中的语言。
CMAKE PLATFORM_ID	一种可能发生变化的内部变量。这用于确定平台，可能会发生变化。
CMAKE_NOT_USING_CONFIG_FLAGS	如果为true，则跳过_BUILD_TYPE标志。这是CMake中生成器使用的内部标志，用于告诉CMake跳过_BUILD_TYPE标志。
CMAKE_VS_INTEL_Fortran_PROJECT_VERSION	在安装“英特尔Fortran”插件的情况下为Visual Studio 9 2008或更高版本生成时，这会指定.vfproj项目文件格式版本。这是供CMake内部使用的，项目代码不应使用。

与CPack相关的变量

变量名称	描述
CPACK_ABSOLUTE_DESTINATION_FILES	使用绝对目的地路径安装的文件列表。
CPACK_COMPONENT_INCLUDE_TOPLEVEL_DIRECTORY	布尔切换以包括/排除顶级目录（组件案例）。
CPACK_CUSTOM_INSTALL_VARIABLES	CPack变量（通过例如CPack-D、CPackConfig.cmake或CPack_PROJECT_CONFIG_FILE脚本设置）在安装脚本中不直接可见。相反，可以在CPACK_CUSTOM_INSTALL_VARIABLES变量中传递varName=值对的列表。在安装时，每个列表项都将导致指定名称的变量（varName）设置为给定值。对于空值，可以省略=。
CPACK_ERROR_ON_ABSOLUTE_INSTALL_DESTINATION	要求CPack在遇到具有绝对INSTALL DESTINATION的文件时立即出错。
CPACK_INCLUDE_TOPLEVEL_DIRECTORY	布尔切换以包括/排除顶级目录。
CPACK_INSTALL_DEFAULT_DIRECTORY_PERMISSIONS	打包期间隐式创建的目录的默认权限。
CPACK_PACKAGING_INSTALL_PREFIX	生成的包中使用的前缀。
CPACK_SET_DESTDIR	布尔切换使CPack在打包时使用DESTDIR机制。
CPACK_WARN_ON_ABSOLUTE_INSTALL_DESTINATION	每次遇到具有绝对INSTALL DESTINATION的文件时，请CPack发出警告。当CPack运行CMAKE_INSTALL.CMAKE脚本时，此变量触发CMAKE_WARN_ON_ABSOLUTE_INSTALL_DESTINATION的定义。

与CTest相关的变量

变量名称	描述
CTEST_BINARY_DIRECTORY	在CTest面板客户端脚本中指定CTest BuildDirectory设置。
CTEST_BUILD_COMMAND	在CTest面板客户端脚本中指定CTest MakeCommand设置。
CTEST_BUILD_NAME	在CTest面板客户端脚本中指定CTest BuildName设置。
CTEST_BZR_COMMAND	在CTest面板客户端脚本中指定CTest BZR命令设置。
CTEST_BZR_UPDATE_OPTIONS	在CTest仪表板客户端脚本中指定CTest BZRUpdateOptions设置。
CTEST_CHANGE_ID	在CTest仪表板客户端脚本中指定CTest ChangeId设置。
CTEST_CHECKOUT_COMMAND	告诉ctest_start()命令如何签出或初始化ctest仪表板客户端脚本中的源目录。
CTEST_CONFIGURATION_TYPE	在CTest面板客户端脚本中指定CTest DefaultCTestConfigurationType设置。
CTEST_CONFIGURE_COMMAND	在CTest面板客户端脚本中指定CTest ConfigureCommand设置。
CTEST_COVERAGE_COMMAND	在CTest面板客户端脚本中指定CTest CoverageCommand设置。
CTEST_COVERAGE_EXTRA_FLAGS	在CTest面板客户端脚本中指定CTest CoverageExtraFlags设置。
CTEST_CURL_OPTIONS	在CTest面板客户端脚本中指定CTest CurlOptions设置。
CTEST_CUSTOM_COVERAGE_EXCLUDE	正则表达式的列表，该列表将用于按路径从ctest_coverage()命令输出的覆盖率中排除文件。
CTEST_CUSTOM_ERROR_EXCEPTION	ctest_build()命令在生成输出中检测到错误消息时将用于排除的正则表达式列表。
CTEST_CUSTOM_ERROR_MATCH	ctest_build()命令将用于检测生成输出中的错误消息的正则表达式列表。
CTEST_CUSTOM_ERROR_POST_CONTEXT	ctest_build()命令在错误消息之后要包含为上下文的行数。默认值为10。
CTEST_CUSTOM_ERROR_PRE_CONTEXT	ctest_build()命令在错误消息之前作为上下文包含的行数。默认值为10。
CTEST_CUSTOM_MAXIMUM_FAILED_TEST_OUTPUT_SIZE	保存失败测试的输出时，这是ctest_test()命令将收集的最大大小（以字节为单位）。默认值为307200（300 KiB）。有关可能的截断模式，请参阅CTEST_CUSTOM_TEST_OUTPUT_TRUNCATION。
CTEST_CUSTOM_MAXIMUM_NUMBER_OF_ERRORS	单个生成步骤中将检测到的最大错误数。之后，ctest_test()命令将截断输出。默认值为50。
CTEST_CUSTOM_MAXIMUM_NUMBER_OF_WARNINGS	单个生成步骤中将检测到的最大警告数。之后，ctest_test()命令将截断输出。默认值为50。
CTEST_CUSTOM_MAXIMUM_PASSED_TEST_OUTPUT_SIZE	保存通过测试的输出时，这是ctest_test()命令将收集的最大大小（以字节为单位）。默认值为1024（1 KiB）。有关可能的截断模式，请参阅CTEST_CUSTOM_TEST_OUTPUT_TRUNCATION。
CTEST_CUSTOM_MEMCHECK_IGNORE	ctest_memcheck()命令期间用于排除测试的正则表达式列表。
CTEST_CUSTOM_POST_MEMCHECK	ctest_memcheck()命令末尾要运行的命令列表。
CTEST_CUSTOM_POST_TEST	ctest_test()命令末尾要运行的命令列表。
CTEST_CUSTOM_PRE_MEMCHECK	ctest_memcheck()命令开始时要运行的命令列表。
CTEST_CUSTOM_PRE_TEST	ctest_test()命令开始时要运行的命令列表。
CTEST_CUSTOM_TEST_OUTPUT_TRUNCATION	设置测试输出截断模式，以防通过CTEST_CUSTOM_maximum_PASSED_test_output_size或CTEST_CUSTOM-maximum_FAILED_test_output_size变量配置最大大小。默认情况下，输出的尾部将被截断。其他可能的值是middle和head。
CTEST_CUSTOM_TESTS_IGNORE	要从ctest_test()命令运行的测试集中排除的测试名称列表。
CTEST_CUSTOM_WARNING_EXCEPTION	ctest_build命令在生成输出中检测到警告消息时将用于排除的正则表达式列表。
CTEST_CUSTOM_WARNING_MATCH	ctest_build()命令将用于检测生成输出中的警告消息的正则表达式列表。
CTEST_CVS_CHECKOUT	已弃用。请改用CTEST_CHECKOUT_COMMAND。
CTEST_CVS_COMMAND	在CTest仪表板客户端脚本中指定CTest CVS命令设置。
CTEST_CVS_UPDATE_OPTIONS	在CTest仪表板客户端脚本中指定CTest CVSUpdateOptions设置。
CTEST_DROP_LOCATION	在CTest面板客户端脚本中指定CTest DropLocation设置。
CTEST_DROP_METHOD	在CTest面板客户端脚本中指定CTest DropMethod设置。
CTEST_DROP_SITE	在CTest面板客户端脚本中指定CTest DropSite设置。
CTEST_DROP_SITE_CDASH	在CTest仪表板客户端脚本中指定CTest IsCDash设置。
CTEST_DROP_SITE_PASSWORD	在CTest面板客户端脚本中指定CTest DropSitePassword设置。
CTEST_DROP_SITE_USER	在CTest面板客户端脚本中指定CTest DropSiteUser设置。
CTEST_EXTRA_COVERAGE_GLOB	正则表达式的列表，用于查找ctest_coverage()命令应覆盖的文件。
CTEST_GIT_COMMAND	在CTest面板客户端脚本中指定CTest GIT命令设置。
CTEST_GIT_INIT_SUBMODULES	在CTest仪表板客户端脚本中指定CTest GITInitSubmodules设置。
CTEST_GIT_UPDATE_CUSTOM	在CTest仪表板客户端脚本中指定CTest GITUpdateCustom设置。
CTEST_GIT_UPDATE_OPTIONS	在CTest仪表板客户端脚本中指定CTest GITUpdateOptions设置。
CTEST_HG_COMMAND	在CTest面板客户端脚本中指定CTest HGCommand设置。
CTEST_HG_UPDATE_OPTIONS	在CTest仪表板客户端脚本中指定CTest HGUpdateOptions设置。
CTEST_LABELS_FOR_SUBPROJECTS	在CTest面板客户端脚本中指定CTest LabelsForSubprojects设置。
CTEST_MEMORYCHECK_COMMAND	在CTest面板客户端脚本中指定CTest MemoryCheckCommand设置。
CTEST_MEMORYCHECK_COMMAND_OPTIONS	在CTest面板客户端脚本中指定CTest MemoryCheckCommandOptions设置。
CTEST_MEMORYCHECK_SANITIZER_OPTIONS	在CTest面板客户端脚本中指定CTest MemoryCheckSanitizerOptions设置。
CTEST_MEMORYCHECK_SUPPRESSIONS_FILE	在CTest面板客户端脚本中指定CTest MemoryCheckSuppressionFile设置。
CTEST_MEMORYCHECK_TYPE	在CTest面板客户端脚本中指定CTest MemoryCheckType设置。有效值为Valgrind、Purify、BoundsChecker、DrMemory、CudaSanitizer、ThreadManitizer、AddressSanitizer，LeakSanitizer和MemoryManitizer以及UndefinedBehaviorManitizer。
CTEST_NIGHTLY_START_TIME	在CTest面板客户端脚本中指定CTest NightlyStartTime设置。
CTEST_P4_CLIENT	在CTest面板客户端脚本中指定CTest P4Client设置。
CTEST_P4_COMMAND	在CTest面板客户端脚本中指定CTest P4Command设置。
CTEST_P4_OPTIONS	在CTest面板客户端脚本中指定CTest P4Options设置。
CTEST_P4_UPDATE_OPTIONS	在CTest仪表板客户端脚本中指定CTest P4UpdateOptions设置。
CTEST_RESOURCE_SPEC_FILE	在CTest面板客户端脚本中指定CTest ResourceSpecFile设置。
CTEST_RUN_CURRENT_SCRIPT	将其设置为0可防止ctest在调用ctest-S到达脚本运行结束时再次运行。
CTEST_SCP_COMMAND	传统选项。未使用。
CTEST_SCRIPT_DIRECTORY	包含顶级CTest脚本的目录。该概念类似于CMAKE_SOURCE_DIR。
CTEST_SITE	在CTest面板客户端脚本中指定CTest站点设置。
CTEST_SOURCE_DIRECTORY	在CTest面板客户端脚本中指定CTest SourceDirectory设置。
CTEST_SUBMIT_INACTIVITY_TIMEOUT	在CTest面板客户端脚本中指定CTest SubmitInactivityTimeout设置。
CTEST_SUBMIT_URL	在CTest面板客户端脚本中指定CTest SubmitInactivityTimeout设置。
CTEST_SVN_COMMAND	在CTest面板客户端脚本中指定CTest SVNCommand设置。
CTEST_SVN_OPTIONS	在CTest面板客户端脚本中指定CTest SVNOptions设置。
CTEST_SVN_UPDATE_OPTIONS	在CTest面板客户端脚本中指定CTest SVNUpdateOptions设置。
CTEST_TEST_LOAD	在CTest面板客户端脚本的CTest测试步骤中指定TestLoad设置。这将设置ctest_TEST()命令的TEST_LOAD选项的默认值。
CTEST_TEST_TIMEOUT	在CTest面板客户端脚本中指定CTest超时设置。
CTEST_TRIGGER_SITE	传统选项。未使用。
CTEST_UPDATE_COMMAND	在CTest仪表板客户端脚本中指定CTest UpdateCommand设置。
CTEST_UPDATE_OPTIONS	在CTest仪表板客户端脚本中指定CTest UpdateOptions设置。
CTEST_UPDATE_VERSION_ONLY	在CTest仪表板客户端脚本中指定CTest UpdateVersionOnly设置。
CTEST_UPDATE_VERSION_OVERRIDE	在CTest仪表板客户端脚本中指定CTest UpdateVersionOverride设置。
CTEST_USE_LAUNCHERS	在CTest面板客户端脚本中指定CTest UseLaunchers设置。