libharu项目静态库构建问题分析与解决方案

静态库构建问题现象

在使用libharu 2.4.4版本时，开发者发现虽然项目提供了构建静态库的选项，但在实际构建过程中这些选项似乎被忽略了。开发者尝试使用以下CMake参数组合来同时构建共享库和静态库：

-DBUILD_SHARED_LIBS=ON 
-DBUILD_STATIC_LIBS=ON 
-DLIBHPDF_SHARED=ON 
-DLIBHPDF_STATIC=ON

然而，这些参数并未产生预期的效果，静态库未能成功构建。

问题根源分析

经过项目维护者的检查，发现libharu的CMake构建系统存在以下问题：

1. 变量定义混乱：CMake文件中存在多个重复或未使用的变量定义，特别是关于库类型(Build Shared/Static)的控制变量过多且不一致。

2. 逻辑冲突：BUILD_SHARED_LIBS和BUILD_STATIC_LIBS这两个变量在CMake逻辑中存在冲突，导致构建系统无法正确处理同时构建两种库类型的请求。

3. 变量未正确使用：一些控制静态库构建的变量(LIBHPDF_STATIC)虽然在CMake中定义，但并未在实际构建逻辑中使用。

解决方案

项目维护者已经对CMake文件进行了清理和优化，简化了库类型控制的逻辑。现在要构建静态库，只需使用以下CMake参数：

-DBUILD_SHARED_LIBS=OFF

这个修改带来了以下改进：

1. 简化配置：移除了冗余的控制变量，使用标准的CMake变量BUILD_SHARED_LIBS来控制库类型。

2. 明确行为：当BUILD_SHARED_LIBS设为OFF时，CMake将默认构建静态库，这是CMake的标准行为。

3. 提高兼容性：新的配置方式更符合CMake的最佳实践，与其他项目的构建方式保持一致。

构建静态库的最佳实践

对于希望使用libharu静态库的开发者，建议遵循以下步骤：

1. 创建构建目录：

   mkdir build && cd build
   

2. 配置CMake：

   cmake .. -DBUILD_SHARED_LIBS=OFF
   

3. 执行构建：

   cmake --build .
   

4. 安装库文件（可选）：

   cmake --install .
   

技术背景知识

在CMake构建系统中，库的类型控制通常遵循以下原则：

1. BUILD_SHARED_LIBS：这是CMake的标准变量，用于控制是否构建共享库(动态库)。当设为ON时构建共享库，OFF时构建静态库。

2. 单一类型构建：大多数CMake项目设计为一次构建只生成一种类型的库（共享或静态），这是为了避免符号冲突和简化依赖管理。

3. 现代CMake实践：新的CMake项目倾向于使用target-based的配置方式，通过add_library()命令显式指定库类型，而不是依赖全局变量。

libharu项目的这次修改使其构建系统更加符合现代CMake的最佳实践，提高了项目的可维护性和用户体验。