Doxygen项目构建源码包的正确方式

在使用Doxygen项目时，开发者有时需要构建源码包以便分发或打包。本文详细介绍了如何正确构建Doxygen的源码包，避免常见错误。

问题背景

许多开发者尝试在Doxygen项目目录内直接构建源码包时遇到了两个主要问题：

1. 生成的tarball文件异常庞大，因为包含了重复的文件和构建目录内容
2. 在不同位置解压后构建时出现CMake缓存路径不匹配的错误

正确构建方法

经过验证，正确的构建流程应该是完全在项目目录外进行：

mkdir /tmp/build
cd /tmp/build
cmake /path/to/doxygen/source
make -j package_source

这种方法生成的源码包大小合理且结构正确，各压缩格式的典型大小如下：

• .tar.Z: ~13.9MB
• .tar.xz: ~5.9MB
• .tar.gz: ~9.1MB
• .tar.bz2: ~7.3MB

常见错误分析

1. 在项目目录内构建：这会导致构建系统将整个构建目录打包进去，造成文件重复和体积膨胀
2. 保留构建目录：在不同位置解压后构建时，残留的CMake缓存会导致路径不匹配错误

最佳实践建议

1. 始终在独立目录中进行构建，与源码目录分离
2. 构建源码包前确保构建目录是全新的
3. 对于打包系统(如SlackBuild)，应在脚本中添加清理步骤，确保移除旧的构建目录

技术原理

CMake的package_source目标设计用于创建干净的源码分发包。当在项目目录内构建时，构建系统会将当前构建状态一并打包，这违背了源码包应只包含原始源码的原则。通过外部构建，可以确保生成的源码包只包含必要的项目文件。

对于需要频繁构建Doxygen源码包的开发者，建议将此流程脚本化，以确保每次都能获得一致的结果。