Cmake中文教程（十二）【2022.05.12】

第 12 步：打包调试和发布

注意：此示例对单配置生成器有效，不适用于多配置生成器（例如 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作为Tutorial可执行文件的属性：

CMakeLists.txt 
add_executable(Tutorial tutorial.cxx)
set_target_properties(Tutorial PROPERTIES DEBUG_POSTFIX ${CMAKE_DEBUG_POSTFIX})
​
target_link_libraries(Tutorial PUBLIC MathFunctions)

让我们还将版本编号添加到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