在CR项目中通过CMake集成时禁用FIPS模式的技术方案

背景介绍

CR项目是一个轻量级的C语言库，使用CMake作为构建系统。在通过CMake的FetchContent功能集成CR库时，开发者发现项目默认会尝试构建FIPS（Federal Information Processing Standards）相关组件，这在某些开发场景下可能不是必需的。

问题分析

当使用现代CMake的FetchContent_MakeAvailable命令集成CR库时，构建系统会自动尝试配置FIPS相关组件。这是因为CR项目的CMakeLists.txt文件中没有提供显式的选项来控制FIPS模式的启用或禁用。

这种设计会导致两个主要问题：

1. 在没有FIPS环境的系统上构建失败
2. 增加了不必要的构建依赖和构建时间

技术解决方案

临时解决方案

目前开发者可以使用较底层的FetchContent_Populate命令作为临时解决方案，但这会触发CMake的CMP0169策略警告，因为这种方式已被标记为过时：

block(SCOPE_FOR POLICIES)
    if(POLICY CMP0169)
        cmake_policy(SET CMP0169 OLD)
    endif()
    FetchContent_GetProperties(cr)
    if(NOT cr_POPULATED)
        FetchContent_Populate(cr)
    endif()
endblock()

推荐的长期方案

更优雅的解决方案是在CR项目的CMakeLists.txt中添加构建选项，允许用户显式控制是否构建测试和示例代码。这可以通过以下方式实现：

1. 在顶层CMakeLists.txt中添加选项：

option(CR_BUILD_TESTS "Build CR test programs" OFF)
option(CR_BUILD_EXAMPLES "Build CR example programs" OFF)

2. 有条件地包含测试和示例目录：

if(CR_BUILD_TESTS)
    add_subdirectory(tests)
endif()

if(CR_BUILD_EXAMPLES)
    add_subdirectory(examples)
endif()

实施建议

对于CR项目维护者，建议：

1. 将FIPS相关构建逻辑设为可选
2. 提供清晰的CMake选项控制构建组件
3. 保持与现代CMake实践的一致性
4. 在文档中明确说明构建选项及其影响

对于CR项目使用者，在等待官方更新前可以：

1. 使用临时解决方案（注意其过时性）
2. 考虑fork项目并自行添加构建选项
3. 关注项目更新，及时切换到官方解决方案

总结

在现代CMake项目中，提供灵活的构建选项是良好实践的重要组成部分。通过为CR项目添加构建选项，可以更好地满足不同用户的需求，同时保持与CMake生态系统的兼容性。这种改进将使CR项目更容易被集成到各种构建环境中，提升开发者的使用体验。