QT 5升级到 Qt 6 使用 Clazy 检查将 C++ 应用程序移植到 Qt 6

本文介绍了两种将Qt 5应用程序升级到Qt 6的方法：一是使用Clazy框架提供的专用检查工具（如qt6-deprecated-api-fixes等），这些工具能帮助识别和修复Qt 5到Qt 6的兼容性问题；二是建议先将应用程序更新至Qt 5.15，并通过定义QT_DISABLE_DEPRECATED_UP_TO宏来禁用已废弃的API，以减少移植难度。两种方法均需注意API变更和兼容性处理，确保顺利迁移到Qt 6。

我这里是摘抄了QT官网的内容，给出了引用的网址，这都是官方权威的信息：

我在QT官网看到有如何将C++应用程序升级到QT 6的工具：

使用 Clazy 检查将 C++ 应用程序移植到 Qt 6

我们在 Clazy 框架内实施了一些检查和修复，以帮助您将应用程序从 Qt 5 移植到 Qt 6。用他们自己的话说"Clazy 是一个编译器插件，它允许 clang 理解 Qt 语义。请获取 Clazy(https://invent.kde.org/sdk/clazy) 并继续阅读，以便更顺利地移植到 Qt 6。

Clazy 检查可在编译过程中作为插件运行，也可使用clazy-standalone 通过 JSON 编译数据库运行。修正会在稍后应用，使用clang-apply-replacements 。

专用于 Qt 6 移植的 Clazy 检查
以下检查专门用于简化从 Qt 5 到 Qt 6 的移植。

qt6-deprecated-api-fixes
qt6-header-fixes
qt6-qhash-signature
qt6-fwd-fixes
missing-qobject-macro
这些检查必须在 Qt 5 中运行。修正后的代码只能在 Qt 6 中编译。因此，必须一次性运行上述检查。Clazy 建议一次只运行一个测试，以避免在应用修复时发生冲突。

网址

https://doc.qt.io/qt-6/zh/porting-to-qt6-using-clazy.html

移植到 Qt 6

从上一版本 Qt 5 到 Qt 6，Qt 有许多变化。在升级到 Qt 6 之前，请确保您的 Qt 5 应用程序已更新到 Qt 5.15。在移植到 Qt 6 时，最新的 Qt 5 版本变化最少。不过，Qt 5.15 中标记为过时或废弃的 API 可能已在 Qt 6 中删除。

如果您要将 Qt 5 应用程序移植到 Qt 6，应检查以下事项。

禁用在 Qt 5.15 中被弃用的 C++ API
使用 Qt 中已废弃的 API 通常会以编译器警告的形式出现。您也可以通过在构建系统中定义QT_DISABLE_DEPRECATED_UP_TO C++ 宏，使使用成为错误。要禁用任何在 5.15 或更旧 Qt 版本中被弃用的 API，请将宏定义为0x050F00 ，即用十六进制数字编码的 “5.15.0”。

例如，在 qmake 项目文件中，定义宏为：

DEFINES += QT_DISABLE_DEPRECATED_UP_TO=0x050F00

在 CMake 中，可以使用 add_compile_definitions：

add_compile_definitions(QT_DISABLE_DEPRECATED_UP_TO=0x050F00)

Qt 5.15 过时的 C++ 类
Qt 5.15 过时的 QML 类型
Qt 6 过时的 C++ 类
Qt 6 过时的 QML 类型

网址：

https://doc.qt.io/qt-6/zh/portingguide.html