QOwnNotes项目构建系统迁移至CMake的技术实践

背景与挑战

QOwnNotes作为一款基于Qt框架的笔记应用，长期以来使用qmake作为其构建系统。随着项目发展，团队决定将构建系统迁移至CMake，这一过程涉及多个技术难点，包括Qt版本兼容性、第三方库集成以及NixOS环境适配等关键问题。

构建系统迁移的核心工作

1. Qt版本兼容处理

项目需要同时支持Qt5和Qt6两个主要版本。通过引入QON_QT6_BUILD编译开关，实现了构建系统的版本自适应能力。在CMake配置中，项目能够智能检测当前Qt版本并加载对应的模块配置。

2. 第三方库集成方案

项目中集成了多个关键第三方库，包括加密库Botan2和Markdown解析库md4c。这些库的集成方式需要特别处理：

• Botan2库：原配置尝试通过CMake的find_package机制查找，调整为优先使用pkg-config系统进行定位，提高了跨平台兼容性
• md4c库：解决了静态链接与动态链接的选择问题，最终确定采用静态链接方式集成到主项目中

3. 目录结构调整

为保持与原有发布包结构的兼容性，对项目目录进行了优化：

• 将CMake相关文件集中到src目录下
• 调整CMAKE_MODULE_PATH设置逻辑
• 确保构建系统既支持完整源码树也支持仅含src目录的发布包

NixOS环境适配

NixOS的特殊包管理机制带来了额外的挑战，团队通过以下方案解决：

1. 构建路径处理：修正源码路径引用方式，确保在Nix构建环境中能正确定位所有资源文件
2. 翻译文件安装：明确设置QT_TRANSLATIONS_DIR变量，解决翻译资源安装权限问题
3. 运行时依赖：完善动态库查找路径配置，确保应用在Nix环境中能够正确加载所有依赖

构建系统优化

新的CMake构建系统实现了多项改进：

1. 模块化配置：将各个组件分离为独立的CMake模块，提高可维护性
2. 安装规则完善：规范了头文件、库文件和资源文件的安装位置
3. 跨平台支持：通过CMake的跨平台特性，增强了在不同操作系统下的构建一致性

实施效果

经过上述改进，QOwnNotes成功实现了：

• 在Qt5和Qt6环境下的稳定构建
• 与NixOS包管理系统的完美集成
• 保持与原有发布结构的兼容性
• 提高构建系统的可维护性和扩展性

这一迁移工作为QOwnNotes后续的功能扩展和跨平台支持奠定了坚实基础，展示了现代CMake构建系统在复杂Qt项目中的优势和应用价值。