添加系统自省

原创已于 2023-10-19 12:27:14 修改 · 162 阅读

0 ·

CC 4.0 BY-SA版权

文章标签：

#c++ #开发语言 #cmake

于 2023-10-19 00:30:08 首次发布

cmake 专栏收录该内容

13 篇文章

订阅专栏

本文介绍了如何在CMake项目中进行基础构建，包括添加库、设置编译选项、使用CheckCXXSourceCompiles检测编译器特性，以及评估依赖项的可用性。还涉及了测试支持和项目安装等内容。

添加系统自省

温故知新
评估依赖项可用性
- CheckCXXSourceCompiles
- target_compile_definitions

下一篇：练习8 添加自定义命令和生成的文件，上一篇：练习6 添加对测试仪表板的支持，目录｜首页

温故知新

经过第一个练习，大家对于基本的使用应该已经掌握了，由于代码过多，在文档中详细介绍太过于啰嗦，大家可以自行下载代码参考

练习1 构建一个基本项目
- cmake_minimum_required()是一个用于指定构建特定项目所需的最低CMake版本的函数。
- project()函数用于定义一个项目，并指定项目的名称及相关属性。
- add_executable()用于指定生成一个可执行文件的目标。
- CMAKE_CXX_STANDARD用于指定项目中C++编译器要遵循的C++标准。
- CMAKE_CXX_STANDARD_REQUIRED用于指示是否要求编译器强制使用指定的C++标准。
- set()函数用于设置变量的值。
- <PROJECT-NAME>_VERSION_MAJOR通常用于访问项目的主要版本号。
- <PROJECT-NAME>_VERSION_MINOR通常用于访问项目的次要版本号。
- configure_file()用于在生成构建系统时复制文件并替换其中的变量值。
- target_include_directories()用于指定一个目标（通常是可执行文件或库）的头文件包含路径。
练习2 添加库
- add_library()用于创建和配置一个库目标。
- add_subdirectory()是用于将其他源代码目录（通常是子目录）添加到当前 CMake 项目中，并在这些子目录中构建其他 CMake 项目。
- target_link_libraries()用于为一个目标（通常是可执行文件或库）指定它所依赖的其他库。
- PROJECT_SOURCE_DIR它包含了当前 CMake 项目的根源代码目录的路径。
- if()用于根据条件的真假来执行不同的 CMake 代码块。
- option()命令用于定义用户可配置的选项。
- target_compile_definitions()用于为特定目标（通常是可执行文件或库）设置编译时宏定义（preprocessor definitions）。
练习3 添加库的使用要求
- target_compile_options()用于为特定目标（通常是可执行文件或库）设置编译选项（compiler options）
- target_link_directories()命令用于为特定目标（通常是可执行文件或库）指定链接目录，以帮助构建系统在链接目标时查找共享库或库文件的位置。
- target_link_options()是 CMake 中的一个命令，用于为特定目标（通常是可执行文件或库）设置链接器选项。
- target_precompile_headers()是 CMake 3.16 版本引入的一项功能，它用于为目标（通常是可执行文件或库）预编译头文件（precompiled headers）以提高构建性能。
- target_sources()用于向特定目标（通常是可执行文件或库）添加源文件，以便将这些源文件编译并链接到目标中。
- target_compile_features()是 CMake 中的一个命令，用于为特定目标（通常是可执行文件或库）设置编译器支持的 C++ 特性（C++ features）。
练习4 添加生成器表达式
- cmake-generator-expressions()（CMake 生成器表达式）是一种在 CMake 构建系统中用于生成构建文件的特殊表达式。
练习5 安装和测试
- install()用于指定在构建完成后如何安装项目的文件和目标（可执行文件、库、头文件等）。
- enable_testing()用于启用测试支持，允许你在项目中定义和运行测试。
- add_test()用于定义和创建测试。
- function()用于定义自定义函数（Custom Function）。
- set_tests_properties()用于配置已定义的测试的属性。
- ctest是 CMake 的测试驱动工具，用于运行和管理项目中定义的测试。
练习6 添加对测试仪表板的支持
- include()用于包含其他 CMake 文件中的内容，以便在当前 CMake 文件中重用和扩展配置。
- CTest是 CMake 的测试工具，用于管理和运行项目中定义的测试套件。

让我们考虑向我们的项目添加一些代码，这些代码取决于目标平台可能没有的功能。对于这个例子，我们将添加一些代码，具体取决于目标平台是否具有log和exp 功能。当然，几乎每个平台都有这些功能，但在本教程中假设它们并不常见。

下一篇：练习8 添加自定义命令和生成的文件，上一篇：练习6 添加对测试仪表板的支持，目录｜首页

评估依赖项可用性

下一篇：练习8 添加自定义命令和生成的文件，上一篇：练习6 添加对测试仪表板的支持，目录｜首页

CheckCXXSourceCompiles

CheckCXXSourceCompiles是 CMake 中的一个宏，用于检查给定的 C++源代码片段是否可以成功编译。这个宏通常用于测试编译器是否支持某些特定的C++特性或语法。

CheckCXXSourceCompiles 宏的基本语法如下：

CheckCXXSourceCompiles(code result_var)

code: 要检查的C++源代码片段。
result_var: 一个CMake变量，用于存储检查的结果。如果源代码能够成功编译，result_var 将被设置为 1，否则将被设置为 0。

下面是一个示例用法：

include(CheckCXXSourceCompiles)

set(test_code "#include <iostream>\nint main() { std::cout << \"Hello, World!\"; return 0; }")
CheckCXXSourceCompiles("${test_code}" CAN_COMPILE)

if (CAN_COMPILE)
    message("C++ code compiles successfully.")
else()
    message("C++ code compilation failed.")
endif()

在这个示例中，我们使用 CheckCXXSourceCompiles 宏来测试一个简单的C++代码片段，用于输出 “Hello, World!”。如果这段代码可以成功编译，CAN_COMPILE 变量将被设置为 1，否则将被设置为 0。

通常，CheckCXXSourceCompiles 宏用于检查编译器是否支持特定的C++语法或功能，以便在CMake配置中进行条件化处理。例如，你可以使用它来检查是否支持C++11或更高版本的标准，或者是否支持某些C++库或功能。

这个宏是CMake中的一个有用工具，可以在配置过程中检查编译器的功能，以确保项目的C++源代码可以正确编译。

下一篇：练习8 添加自定义命令和生成的文件，上一篇：练习6 添加对测试仪表板的支持，目录｜首页