零基础学习CMake--第七章：打包与发布——CPack的魔法7.1 为什么需要打包？生成安装包（deb/rpm/msi/exe）
第七章：打包与发布——CPack的魔法
7.1 为什么需要打包？生成安装包（deb/rpm/msi/exe）
从“代码”到“可交付物”：打包的核心价值
在完成项目的构建（cmake --build .）后，我们得到的是散落在build目录中的二进制文件、库和可执行文件。这些文件无法直接分发给用户——用户需要的是“一键安装”的体验，而非手动复制文件、配置环境变量。
打包的本质：将项目的二进制成果、依赖、配置文件整合成符合操作系统规范的安装包，让用户通过包管理器（如apt/yum/msiexec）或双击安装程序，快速完成部署。
一、为什么必须打包？——4大核心原因
1. 简化用户安装流程
-
直接分发
build目录？用户需要手动复制文件到/usr/local、设置PATH、处理依赖……容易出错。 -
打包后，用户只需运行
sudo apt install myapp.deb（Ubuntu）或双击myapp.msi（Windows），一步到位。
2. 适配操作系统包管理机制
不同操作系统有自己的包管理工具：
-
Debian/Ubuntu：
dpkg/apt→ 需要.deb包； -
RedHat/CentOS/Fedora：
rpm/yum/dnf→ 需要.rpm包； -
Windows：
msiexec→ 需要.msi包； -
macOS：
brew→ 需要.pkg或.dmg包（CPack暂不直接支持，但可通过脚本转换）。
CPack能生成符合这些机制的包，确保包能被系统正确识别和安装。
3. 自动处理依赖关系
项目的运行依赖（如OpenSSL、Boost）需要随包一起安装。CPack可以：
-
自动检测项目的依赖（通过
find_package引入的库）； -
在包元数据中声明依赖，让包管理器自动安装所需库。
4. 版本控制与分发
-
打包时可以指定版本号（如
1.0.0），方便用户识别更新； -
源码包（
.tar.gz）可用于分发源代码，让用户自行编译； -
二进制包（
.deb/.rpm/.msi）用于分发预编译成果，节省用户编译时间。
二、CPack是什么？——CMake自带的打包引擎
CPack是CMake项目的标准打包工具，无需额外安装（随CMake一起发布）。它的核心功能是：
-
根据项目配置生成多种格式的安装包；
-
自动收集项目的二进制文件、头文件、依赖；
-
生成包元数据（名称、版本、描述、依赖）。
CPack的工作流程
-
配置CPack：在
CMakeLists.txt中设置包的基本信息（名称、版本、描述）； -
生成CPack配置文件：运行
cmake ..时，CMake会生成CPackConfig.cmake； -
运行CPack：执行
cpack命令，根据CPackConfig.cmake生成指定格式的包。
三、生成常见安装包：deb/rpm/msi/exe
下面以文件加密工具项目为例，演示如何用CPack生成不同格式的包。
3.1 前置准备：项目配置
在父CMakeLists.txt中添加CPack支持：
# 启用CPack
include(CPack)
# 设置包的基本信息（全局有效）
set(CPACK_PACKAGE_NAME "FileEncryptor") # 包名
set(CPACK_PACKAGE_VERSION "1.0.0") # 版本号
set(CPACK_PACKAGE_DESCRIPTION "A tool to encrypt files using OpenSSL") # 描述
set(CPACK_PACKAGE_CONTACT "your-email@example.com") # 作者信息
# 设置二进制目录（CPack会从这里收集文件）
set(CPACK_BINARY_DIR "${CMAKE_BINARY_DIR}/cpack_output")3.2 生成.deb包（Debian/Ubuntu）
.deb是Debian系系统的标准包格式，用dpkg安装。
步骤1：配置deb包的依赖
在CMakeLists.txt中添加：
# 设置deb包的依赖（自动检测项目依赖）
set(CPACK_DEBIAN_PACKAGE_DEPENDS "libssl-dev (>= 1.1.1), libboost-filesystem-dev (>= 1.75.0), libboost-system-dev (>= 1.75.0)")步骤2：运行CPack生成deb包
# 在build目录中
cpack -G DEB # -G指定生成格式为DEB生成的包位于build/cpack_output：FileEncryptor_1.0.0-Linux.deb。
安装测试
sudo dpkg -i FileEncryptor_1.0.0-Linux.deb3.3 生成.rpm包（RedHat/CentOS）
.rpm是RedHat系系统的标准包格式，用yum/dnf安装。
步骤1：配置rpm包的依赖
# 设置rpm包的依赖
set(CPACK_RPM_PACKAGE_REQUIRES "openssl >= 1.1.1, boost-filesystem >= 1.75.0, boost-system >= 1.75.0")步骤2：生成rpm包
cpack -G RPM # -G指定生成格式为RPM生成的包：FileEncryptor-1.0.0-1.x86_64.rpm。
安装测试
sudo dnf install FileEncryptor-1.0.0-1.x86_64.rpm3.4 生成.msi包（Windows）
.msi是Windows的标准安装包格式，用msiexec安装。
步骤1：配置Windows包信息
# 设置Windows包的升级代码（唯一标识）
set(CPACK_WIX_UPGRADE_CODE "{12345678-1234-1234-1234-1234567890AB}")步骤2：生成msi包
# 需要在Windows环境下运行，或在Linux/macOS用Wine
cpack -G WIX # -G指定生成格式为WIX（对应.msi）生成的包：FileEncryptor_1.0.0_x64.msi。
安装测试
双击.msi文件，按向导安装；或用命令行：
msiexec /i FileEncryptor_1.0.0_x64.msi3.5 生成.exe安装包（Windows便携版）
.exe是Windows的可执行安装包，无需安装程序即可运行（绿色软件）。
步骤1：配置exe包
# 设置exe包的输出目录
set(CPACK_EXE_OUTPUT_DIRECTORY "${CMAKE_BINARY_DIR}/exe_output")步骤2：生成exe包
cpack -G NSIS # -G指定生成格式为NSIS（Nullsoft Scriptable Install System）生成的包：FileEncryptor-1.0.0.exe。
安装测试
双击.exe文件，选择安装目录即可。
3.6 生成源码包（.tar.gz）
源码包用于分发项目的源代码，让用户自行编译。
生成源码包
cpack -G TGZ # -G指定生成格式为TGZ（对应.tar.gz）生成的包：FileEncryptor-1.0.0.tar.gz。
解压编译
tar -zxvf FileEncryptor-1.0.0.tar.gz
cd FileEncryptor-1.0.0
mkdir build && cd build
cmake .. && make四、CPack的高级配置
4.1 自定义安装路径
默认情况下，CPack会将包安装到系统的标准目录（如/usr/local）。可以通过CPACK_INSTALL_PREFIX修改：
set(CPACK_INSTALL_PREFIX "/opt/FileEncryptor") # 安装到/opt目录4.2 添加自定义文件
比如将README.md和LICENSE加入包：
# 添加额外文件到deb包
set(CPACK_DEBIAN_PACKAGE_FILES
"${CMAKE_SOURCE_DIR}/README.md"
"${CMAKE_SOURCE_DIR}/LICENSE"
)4.3 生成校验和
CPack可以生成包的SHA256校验和，确保文件完整性：
set(CPACK_GENERATE_SHA256_SUMMARY ON) # 生成SHA256摘要五、总结：CPack的“打包魔法”
CPack的核心价值是将CMake项目的构建成果转化为符合各平台规范的安装包，解决了“如何分发项目”的关键问题。通过简单的配置，就能生成：
-
.deb（Debian/Ubuntu）； -
.rpm（RedHat/CentOS）； -
.msi/.exe（Windows）； -
.tar.gz（源码包）。
下一章预告：调试技巧——GDB与LLDB高级用法，解决加密算法中的运行时问题！
（打包示例仓库：GitHub链接，包含CPack配置的具体用例～）
本节要点：
-
打包的核心价值：简化安装、适配系统、处理依赖；
-
CPack的作用：CMake自带的打包引擎，生成多种格式包；
-
常见包格式：deb/rpm/msi/exe/源码包的生成方法；
-
高级配置：自定义安装路径、添加文件、生成校验和。
更多推荐
16
0- 0
已为社区贡献1条内容
所有评论(0)