CentOS中C++项目如何打包配置

CentOS 中 C++ 项目的打包配置指南

一 方案总览

• 发行版安装包：优先使用 RPM，通过 SPEC 文件描述构建、安装与文件清单，适合在 CentOS 环境内部分发与上线，便于依赖管理与系统级安装。
• 便携运行包：将可执行文件与依赖库、配置、资源一起打包为目录或压缩包，配合启动脚本设置 LD_LIBRARY_PATH，适合离线部署与快速交付。
• 库产物打包：将项目输出为 静态库 .a 或 共享库 .so，供其他工程链接使用，需正确设置头文件路径与链接参数（-I、-L、-l）。

二 方案一 RPM 打包配置

• 准备构建环境
  • 安装工具链与打包工具：sudo yum groupinstall “Development Tools”；sudo yum install gcc-c++ cmake rpm-build。
• 组织目录与源码
  • 约定目录：项目根下构建出可执行文件（如 build/greeter），并准备配置与文档。
• 准备打包素材
  • 按最终安装结构在临时目录中摆放文件，例如：mkdir -p greeter-1.0/usr/bin greeter-1.0/etc greeter-1.0/usr/share/doc/greeter-1.0；cp build/greeter greeter-1.0/usr/bin/；echo “recipient = RPM User” > greeter-1.0/etc/greeter.conf；echo “Greeter App v1.0” > greeter-1.0/usr/share/doc/greeter-1.0/README.md。
  • 打包为源码包：tar -czvf greeter-1.0.tar.gz greeter-1.0；mv greeter-1.0.tar.gz ~/rpmbuild/SOURCES/。
• 编写 SPEC 文件（示例要点）
  • 基本信息：Name、Version、Release、Summary、License、URL、Source0。
  • 依赖与架构：Requires: libstdc++；BuildArch: x86_64（按实际）。
  • 构建安装：%prep 解压；%build 为空（预编译二进制场景）；%install 用 install -d -m 755 与 install -m 755/644 安装到 %{buildroot} 对应目录（如 %{_bindir}、%{_sysconfdir}、%{_docdir}）。
  • 文件清单：%files 声明文件与权限，配置建议 %config(noreplace) 避免升级覆盖用户修改；必要时用 %attr 明确权限。
  • 变更日志：%changelog。
• 构建与验证
  • 构建：rpmbuild -bb ~/rpmbuild/SPECS/greeter.spec；产物在 ~/rpmbuild/RPMS/x86_64/。
  • 校验：rpm -qip 包文件；rpm -qlp 包文件；安装运行：sudo yum localinstall 包文件；卸载：sudo yum remove greeter。

三 方案二 便携运行包配置

• 依赖收集脚本 pack.sh（将可执行文件依赖的共享库复制到发布目录）
  • 示例：
    • exe=“greeter”；des=“./release”
    • deplist=$(ldd “$exe” | awk ‘{if (match($3,“/”)) printf("%s ",$3)}’)
    • mkdir -p “$des” && cp $deplist “$des”
• 启动脚本 runner.sh（设置库搜索路径并启动）
  • 示例：
    • #!/bin/sh
    • appname=$(basename “$0” .sh)
    • dirname=$(dirname “$0”)
    • [ “${dirname%/}” != “/” ] && dirname=$PWD/$dirname
    • export LD_LIBRARY_PATH=$dirname:$LD_LIBRARY_PATH
    • exec “$dirname/$appname” “$@”
• 目录结构与打包
  • 将可执行文件、依赖库、配置、文档放入同一目录（如 release/），确保 runner.sh 与可执行文件同名（或调整脚本内 appname）。
  • 交付前本地验证：./runner.sh；跨机前确认架构与依赖一致，资源文件齐全。

四 方案三 库产物打包与链接配置

• 静态库 .a
  • 生成：gcc -c add.c sub.c；ar -rc libmylib.a add.o sub.o。
  • 使用：gcc main.c -I./include -L./lib -lmylib（链接阶段将库代码并入可执行文件）。
• 共享库 .so
  • 生成：gcc -fPIC -c add.c sub.c；gcc -shared -o libmylib.so add.o sub.o。
  • 使用：gcc main.c -I./include -L./lib -lmylib；运行期需确保动态库可被加载（如放置于系统库目录、设置 LD_LIBRARY_PATH 或 ldconfig 配置）。
• 使用要点
  • 链接选项：-I 指定头文件路径，-L 指定库路径，-l 指定库名（去掉 lib 与 .a/.so 后缀）。
  • 运行时库解析：动态库路径不在系统默认搜索路径时，使用 LD_LIBRARY_PATH 或系统库目录/缓存机制。

五 实践建议

• 构建效率：使用 CMake 管理工程，配合并行构建（make -jN / ninja -jN）与预编译头（PCH）提升速度；多编译器共存时，用 -DCMAKE_CXX_COMPILER 指定编译器路径，避免误用旧版工具链。
• 交付策略：面向内部分发优先 RPM（依赖清晰、可回滚）；面向客户或离线环境优先 便携运行包（部署简单、路径可控）；对外提供 SDK 时输出 .a/.so + 头文件 并附链接示例。