步骤 12:打包调试和发布

注意:此示例适用于单配置生成器,不适用于多配置生成器(如 Visual Studio)。

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

首先,我们希望确保用于调试和发布构建的库使用不同的名称进行安装。让我们使用 d 作为调试库的后缀。

在顶级 CMakeLists.txt 文件的开头附近设置 CMAKE_DEBUG_POSTFIX

CMakeLists.txt
set(CMAKE_DEBUG_POSTFIX d)

add_library(tutorial_compiler_flags INTERFACE)

以及 tutorial 可执行文件上的 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 中,设置 VERSIONSOVERSION 属性

MathFunctions/CMakeLists.txt
set_property(TARGET MathFunctions PROPERTY VERSION "1.0.0")
set_property(TARGET MathFunctions PROPERTY SOVERSION "1")

Step12 目录中,创建 debugrelease 子目录。布局将如下所示

- 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