打包调试和发布

打包调试和发布

• 温故知新

---

上一篇：练习11 添加导出配置，目录｜首页

温故知新

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

• 练习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 的测试工具，用于管理和运行项目中定义的测试套件。
• 练习7 添加系统自省
  • CheckCXXSourceCompiles是 CMake 中的一个宏，用于检查给定的 C++源代码片段是否可以成功编译。
• 练习8 添加自定义命令和生成的文件
• 练习9 打包安装程序
• 练习10 选择静态或共享库
• 练习11 添加导出配置

**注意：**此示例对单配置生成器有效，不适用于多配置生成器（例如 Visual Studio）。

默认情况下，CMake 的模型是构建目录仅包含单个配置，无论是 Debug、Release、MinSizeRel 还是 RelWithDebInfo。但是，可以设置 CPack 来捆绑多个构建目录并构建一个包含同一项目的多个配置的包。

首先，我们要确保调试和发布版本对将安装的库使用不同的名称。让我们使用d作为调试库的后缀。

放CMAKE_DEBUG_POSTFIX靠近顶级 CMakeLists.txt文件的开头：

• CMakeLists.txt

set(CMAKE_DEBUG_POSTFIX d)

add_library(tutorial_compiler_flags INTERFACE)

还有DEBUG_POSTFIX教程可执行文件的属性：

• CMakeLists.txt

add_executable(Tutorial tutorial.cxx)
set_target_properties(Tutorial PROPERTIES DEBUG_POSTFIX ${CMAKE_DEBUG_POSTFIX})

target_link_libraries(Tutorial PUBLIC MathFunctions tutorial_compiler_flags)

我们还将版本编号添加到MathFunctions库中。在 中 MathFunctions/CMakeLists.txt，设置VERSION和 SOVERSION特性：

• MathFunctions/CMakeLists.txt

set_property(TARGET MathFunctions PROPERTY VERSION "1.0.0")
set_property(TARGET MathFunctions PROPERTY SOVERSION "1")

从Step12目录中创建debug子目录release 。布局将如下所示：

- Step12
   - debug
   - release

现在我们需要设置调试和发布版本。我们可以用 CMAKE_BUILD_TYPE设置配置类型：

cd debug
cmake -DCMAKE_BUILD_TYPE=Debug ..
cmake --build .
cd ../release
cmake -DCMAKE_BUILD_TYPE=Release ..
cmake --build .

现在调试和发布版本都已完成，我们可以使用自定义配置文件将两个版本打包到单个版本中。在该 Step12目录中，创建一个名为MultiCPackConfig.cmake. 在此文件中，首先包含由 cmake可执行的。

接下来，使用该CPACK_INSTALL_CMAKE_PROJECTS变量指定要安装的项目。在本例中，我们想要同时安装调试和发布。

• MultiCPackConfig.cmake

include("release/CPackConfig.cmake")

set(CPACK_INSTALL_CMAKE_PROJECTS
    "debug;Tutorial;ALL;/"
    "release;Tutorial;ALL;/"
    )

从Step12目录中运行cpack使用以下选项指定我们的自定义配置文件config：

cpack --config MultiCPackConfig.cmake

---

上一篇：练习11 添加导出配置，目录｜首页