Qt4到Qt5迁移指南：KDE项目的经验与教训

"本文档主要讨论了将Qt4代码迁移到Qt5时遇到的挑战和解决策略，重点关注了插件加载和单元测试的迁移问题。在Qt5中，moc处理插件元数据的方式发生了变化，不再支持宏的嵌套，需要对使用K_EXPORT_PLUGIN的代码进行调整。对于单元测试，QTestLib的QSKIP宏参数数量的变化也需要适配。此外，文章还提到了Qt5移除了Qt3Support模块以及Qt4到Qt5迁移中需要更新的include路径和API替换。" 在进行Qt4到Qt5的迁移时，首要任务是确保代码能同时兼容两个版本，以便于逐步过渡和测试。首先，需要处理的是Qt3Support模块的移除。在Qt5中，许多旧的Qt3Support API已被废弃，因此需要寻找对应的Qt4或Qt5替代方案。例如，QWidget::setShown已被替换为QWidget::setVisible。在迁移过程中，必须删除或替换所有与Qt3Support相关的代码。 其次，Qt5的一个显著改动是将widgets从QtGui模块分离出来，创建了新的QtWidgets模块。这意味着在更新代码时，需要修改include语句，确保正确引用QtWidgets模块，以避免编译错误。此外，可能还需要更新构建系统，以适应Qt5的新结构。 关于插件加载，Qt5中moc处理插件元数据的方式有所改变，不再支持宏的嵌套。如果Qt4代码中使用了如K_EXPORT_PLUGIN这样的宏，可能需要将其直接暴露给moc，或者创建新的包装宏来适配Qt5。这可能涉及到对代码结构的修改，特别是当这些宏被其他宏包裹时。 在单元测试方面，QTestLib的QSKIP宏在Qt5中从两个参数减少到一个参数，这会导致编译错误。KDE采取的解决办法是创建一个包装宏，接收两个参数但在Qt5环境中只使用一个。然而，这种做法仅是临时的，长远来看，应逐步移除对旧宏的依赖，以保持与Qt5的兼容性。 在实际的迁移过程中，需要逐个检查和修改代码中的每一个细节，确保所有功能都能在Qt5环境中正常工作。同时，维护一个良好的测试框架至关重要，因为它可以帮助识别出由于迁移引入的新问题和旧有的bug。 Qt4到Qt5的迁移是一个涉及多个层面的过程，包括API的替换、构建系统的更新、插件加载机制的调整以及测试框架的适配。尽管Qt5在设计时考虑了向后兼容性，但仍然需要开发者仔细处理这些差异，以确保平稳过渡。