CPack中的组件打包：COMPONENT参数、组件依赖、组件分组、按组件安装
说实话，组件打包这个功能，是我在实际项目中用得最频繁的CPack特性之一。为什么？因为真实世界的软件很少是「一个二进制文件打天下」。你想想看，一个稍微像样点的项目，通常会有库文件、头文件、文档、示例代码、调试符号……这些东西如果一股脑全塞进一个安装包，用户会疯掉的。
我记得第一次接手一个大型C++项目时，那个CMakeLists.txt写得那叫一个「一锅炖」。所有东西都装到同一个目录下，用户想只装运行时库？没门。想只装开发头文件？也不行。后来我花了整整两天，把整个项目拆成了组件化的打包结构。嗯，从那以后，我再也没写过「一锅炖」的安装脚本。
什么是组件打包？
组件打包，说白了就是让用户按需选择安装哪些部分。CPack通过COMPONENT参数来实现这个机制。你可以在install()命令中指定每个文件属于哪个组件，然后CPack会根据这些组件信息生成对应的安装包。
举个例子，一个典型的库项目可能包含这些组件：
- runtime：运行时库文件（.so/.dll）
- development：头文件、静态库、CMake配置文件
- documentation：API文档、使用手册
- examples：示例代码
每个组件都可以独立安装，也可以组合安装。这在企业级部署中特别有用——运维人员只需要运行时组件，而开发人员则需要development组件。
COMPONENT参数的基本用法
先看一个最简单的例子。假设我们有一个数学库项目，包含动态库和头文件：
# 运行时组件：安装动态库
install(TARGETS mathlib
LIBRARY DESTINATION lib
COMPONENT runtime
)
# 开发组件：安装头文件
install(FILES mathlib.h
DESTINATION include
COMPONENT development
)
# 文档组件：安装说明文档
install(FILES README.md
DESTINATION share/doc/mathlib
COMPONENT documentation
)这样定义之后，CPack就知道项目有三个组件了。用户可以通过--components参数指定要安装哪些组件：
# 只安装运行时组件
cpack -G DEB --components runtime
# 安装运行时和开发组件
cpack -G DEB --components runtime;developmentruntime_libs、dev_headers。这样在命令行里输入时不容易出错。
组件依赖：组件之间的「血缘关系」
组件之间往往不是孤立的。比如，你要装development组件，那runtime组件肯定也得装上，不然头文件引用的库文件找不到，编译会报错。CPack提供了COMPONENT_DEPENDS属性来处理这种依赖关系。
设置组件依赖有两种方式。第一种是在install()命令中直接指定：
install(TARGETS mathlib
LIBRARY DESTINATION lib
COMPONENT runtime
)
install(FILES mathlib.h
DESTINATION include
COMPONENT development
# development组件依赖runtime组件
COMPONENT_DEPENDS runtime
)第二种方式，是用set_property单独设置：
set_property(TARGET mathlib
PROPERTY COMPONENT_DEPENDS runtime
)我在项目中遇到过一个问题：组件依赖写成了循环依赖。比如A依赖B，B又依赖A。CPack检测到这种情况会直接报错。所以写依赖关系时，一定要保证是有向无环图。
组件分组：把组件组织成「文件夹」
当组件数量多起来之后，光靠依赖关系还不够。你想想看，一个项目可能有十几个组件，用户在选择安装时看到一长串列表，体验很差。这时候就需要组件分组。
CPack的组件分组通过COMPONENT_GROUP属性实现。你可以把相关的组件归到一个组里，用户安装时按组选择，清晰很多。
# 定义组件组
set(CPACK_COMPONENT_GROUP_RUNTIME "Runtime Components")
set(CPACK_COMPONENT_GROUP_DEVELOPMENT "Development Components")
set(CPACK_COMPONENT_GROUP_DOCS "Documentation")
# 把组件分配到组里
set(CPACK_COMPONENT_RUNTIME_GROUP "RUNTIME")
set(CPACK_COMPONENT_DEVELOPMENT_GROUP "DEVELOPMENT")
set(CPACK_COMPONENT_DOCUMENTATION_GROUP "DOCS")在NSIS安装包中，组件分组会显示为树形结构。用户展开「Runtime Components」组，就能看到里面的具体组件。这种组织方式，说白了就是给用户一个「安装目录树」。
我建议分组不要太细，3到5个组比较合适。组太多反而失去了分组的意义。比如：
| 组名 | 包含组件 | 说明 |
|---|---|---|
| Runtime | runtime, plugins | 运行程序必需的文件 |
| Development | headers, static_libs, cmake_config | 二次开发所需的文件 |
| Tools | cli_tools, gui_tools | 辅助工具和脚本 |
| Documentation | api_docs, user_manual, examples | 文档和示例代码 |
按组件安装：让用户自己「点菜」
前面讲了怎么定义组件、设置依赖、分组。最后一步，就是让用户真正能按组件安装。CPack支持多种方式来实现这个功能。
最直接的方式，是在命令行指定组件：
# 安装所有组件（默认行为）
cpack -G NSIS
# 只安装指定组件
cpack -G NSIS --components runtime;development
# 排除某些组件
cpack -G NSIS --components all --exclude-components documentation;examples对于NSIS和IFW这种交互式安装器，CPack会生成一个组件选择界面。用户可以在安装过程中勾选或取消勾选组件。这个界面默认是英文的，但你可以通过设置CPACK_COMPONENT_XXX_DISPLAY_NAME来定制显示名称。
set(CPACK_COMPONENT_RUNTIME_DISPLAY_NAME "运行时库")
set(CPACK_COMPONENT_DEVELOPMENT_DISPLAY_NAME "开发头文件")
set(CPACK_COMPONENT_DOCUMENTATION_DISPLAY_NAME "API文档")对于DEB和RPM这种包管理器格式，组件会被打包成独立的子包。比如：
mathlib（主包，包含runtime组件）mathlib-dev（子包，包含development组件）mathlib-doc（子包，包含documentation组件）
用户通过包管理器安装时，可以单独安装子包：
# 只安装运行时
sudo apt install mathlib
# 安装运行时和开发包
sudo apt install mathlib mathlib-dev一个完整的组件打包示例
说了这么多，我们来写一个完整的CMakeLists.txt。这个项目是一个简单的图像处理库，包含运行时库、开发头文件、示例程序和文档。
cmake_minimum_required(VERSION 3.16)
project(ImageProc VERSION 1.0.0)
# 添加库
add_library(imageproc SHARED src/core.cpp src/filter.cpp)
# 添加示例程序
add_executable(showimage examples/showimage.cpp)
target_link_libraries(showimage PRIVATE imageproc)
# 安装运行时组件
install(TARGETS imageproc
LIBRARY DESTINATION lib
COMPONENT runtime
)
# 安装开发组件
install(FILES include/imageproc.h include/filter.h
DESTINATION include
COMPONENT development
COMPONENT_DEPENDS runtime
)
# 安装示例组件
install(TARGETS showimage
RUNTIME DESTINATION bin
COMPONENT examples
COMPONENT_DEPENDS runtime
)
install(FILES examples/README.md
DESTINATION share/imageproc/examples
COMPONENT examples
)
# 安装文档组件
install(FILES README.md LICENSE
DESTINATION share/doc/imageproc
COMPONENT documentation
)
# CPack配置
set(CPACK_PACKAGE_NAME "ImageProc")
set(CPACK_PACKAGE_VERSION "1.0.0")
set(CPACK_PACKAGE_VENDOR "MyCompany")
# 组件分组
set(CPACK_COMPONENT_GROUP_RUNTIME "运行时")
set(CPACK_COMPONENT_GROUP_DEVELOPMENT "开发")
set(CPACK_COMPONENT_GROUP_EXAMPLES "示例")
set(CPACK_COMPONENT_GROUP_DOCS "文档")
set(CPACK_COMPONENT_RUNTIME_GROUP "RUNTIME")
set(CPACK_COMPONENT_DEVELOPMENT_GROUP "DEVELOPMENT")
set(CPACK_COMPONENT_EXAMPLES_GROUP "EXAMPLES")
set(CPACK_COMPONENT_DOCUMENTATION_GROUP "DOCS")
# 组件描述
set(CPACK_COMPONENT_RUNTIME_DESCRIPTION "运行时库文件")
set(CPACK_COMPONENT_DEVELOPMENT_DESCRIPTION "开发头文件和CMake配置")
set(CPACK_COMPONENT_EXAMPLES_DESCRIPTION "示例程序和说明")
set(CPACK_COMPONENT_DOCUMENTATION_DESCRIPTION "API文档和许可证")
# 生成器配置
set(CPACK_GENERATOR "NSIS;DEB")
include(CPack)这个配置生成后，用户可以通过NSIS安装器选择安装哪些组件，也可以通过DEB包管理器单独安装子包。每个组件都有清晰的描述和分组，用户一看就知道该选什么。
组件打包的核心逻辑
下面这张图展示了组件打包的整体流程：
从这张图可以看出，组件打包的核心就是分层定义。先定义文件属于哪个组件，再定义组件之间的关系和分组，最后CPack根据这些信息生成不同格式的安装包。每一层都清晰明了，出了问题也容易定位。
好了，组件打包的内容就讲到这里。记住一句话：好的组件结构，能让用户安装时少掉一半头发。下次写CMakeLists.txt时，不妨先想想你的项目应该拆成几个组件。