Drogon项目中CMake构建系统的优化实践

背景介绍

在现代C++项目开发中，CMake作为跨平台构建工具被广泛使用。Drogon作为一个高性能的C++ Web应用框架，其构建系统同样基于CMake。在实际使用过程中，开发者发现了一些可以优化的CMake配置细节，这些优化能够提升构建过程的整洁性和兼容性。

问题分析

1. find_package的QUIET属性失效问题

在Drogon的CMake模块中，FindJsoncpp.cmake文件存在一个设计细节问题：当用户使用find_package(Jsoncpp QUIET)时，期望不输出任何信息，但实际上该模块仍然会输出jsoncpp的版本信息。这是因为模块中直接使用了message(STATUS ...)命令，而没有考虑QUIET参数的影响。

2. CMake版本兼容性警告

随着CMake 3.31.0及更高版本的发布，Drogon构建系统中ParseAndAddDrogonTests.cmake文件触发了兼容性警告。警告指出，该文件设置的CMake最低版本要求(3.5)已经过时，建议更新最低版本要求或使用版本范围后缀。

解决方案

对于find_package问题

优化后的FindJsoncpp.cmake应当尊重QUIET参数，可以通过检查Jsoncpp_FIND_QUIETLY变量来实现：

if(NOT Jsoncpp_FIND_QUIETLY)
    message(STATUS "jsoncpp version:" ${jsoncpp_ver})
endif()

这种修改确保了当用户请求静默模式时，构建系统不会输出不必要的信息。

对于CMake版本警告

ParseAndAddDrogonTests.cmake文件中的cmake_minimum_required命令可以更新为：

cmake_minimum_required(VERSION 3.10)

或者使用版本范围表示法：

cmake_minimum_required(VERSION 3.5...3.25)

这种修改既保持了向后兼容性，又避免了新版本CMake的警告信息。

实施效果

经过这些优化后，Drogon的构建系统将具有以下改进：

1. 更好的构建输出控制：用户可以通过QUIET参数真正控制jsoncpp查找过程中的信息输出
2. 更干净的构建日志：消除了不必要的CMake版本兼容性警告
3. 更好的未来兼容性：为后续CMake版本升级做好准备

最佳实践建议

对于CMake模块开发者，建议注意以下几点：

1. 始终考虑find_package的QUIET和REQUIRED参数的影响
2. 定期更新cmake_minimum_required版本要求
3. 在输出信息前检查相应的控制变量
4. 考虑使用版本范围表示法来提高兼容性

这些实践不仅适用于Drogon项目，对于任何基于CMake的C++项目都具有参考价值。通过遵循这些原则，可以构建出更健壮、更用户友好的构建系统。