【Qt】Qt编译是出现Warning QT_DEVICE_PIXEL_RATIO is deprecated

`QT_DEPRECATED_SINCE` 是 Qt 提供的一个宏，用于标记某个类、函数或方法在某个特定版本中**已被弃用（deprecated）**。它的作用是帮助开发者识别哪些 API 已经过时，应该避免使用，并提示使用替代的新 API。 --- ## ✅ 宏定义与用途 ```cpp QT_DEPRECATED_SINCE(x, y, z) ``` 该宏通常用于标记某个函数或类从 Qt 版本 `x.y.z` 开始被弃用。 例如： ```cpp QT_DEPRECATED_SINCE(5, 15, 0) void oldFunction(); ``` 表示 `oldFunction()` 函数从 **Qt 5.15.0** 开始被弃用。 --- ## ✅ 使用方式 你可以在函数声明或类定义中使用该宏，以提醒开发者此函数已被弃用： ### 示例：函数弃用 ```cpp #include <QtGlobal> class MyClass { public: void newFunction() { qDebug() << "Use newFunction instead."; } QT_DEPRECATED_SINCE(6, 0, 0) void oldFunction() { newFunction(); // 调用新函数 } }; ``` ### 示例：类弃用 ```cpp class QT_DEPRECATED_SINCE(5, 15, 0) OldClass { public: void doSomething() { qDebug() << "This class is deprecated."; } }; ``` --- ## ✅ 编译器警告 使用 `QT_DEPRECATED_SINCE` 后，当你调用被弃用的函数或创建被弃用的类对象时，编译器会发出警告（取决于编译器支持和 Qt 的配置）。 例如： ``` warning: 'void oldFunction()' is deprecated: This function was deprecated in Qt 6.0.0. ``` --- ## ✅ 与其它 Qt 弃用宏的区别 | 宏 | 说明 | |----|------| | `QT_DEPRECATED_SINCE(major, minor, patch)` | 标记从某个具体版本开始弃用 | | `QT_DEPRECATED_X("reason")` | 弃用并建议使用替代项，`reason` 为替代说明 | | `QT_DEPRECATED` | 标记为弃用，不指定具体版本 | | `Q_DECL_DEPRECATED` | 旧版本宏，用于标记函数为弃用 | --- ## ✅ 示例：结合 QT_DEPRECATED_X 使用 ```cpp QT_DEPRECATED_X("Use newFunction()") void oldFunction(); ``` 编译器会提示： ``` warning: 'void oldFunction()' is deprecated: Use newFunction() ``` --- ## ✅ 实际应用示例 假设你有一个绘图类，旧的绘图方法已被弃用： ```cpp class Painter { public: void drawCircle(int x, int y, int radius) { qDebug() << "Drawing circle at (" << x << "," << y << ") with radius " << radius; } QT_DEPRECATED_SINCE(6, 2, 0) QT_DEPRECATED_X("Use drawCircle(int x, int y, int radius)") void drawCircleOld(int x, int y, int radius) { drawCircle(x, y, radius); } }; ``` --- ## ✅ 为什么需要弃用机制？ 1. **维护兼容性**：不立即删除旧 API，避免破坏现有代码。 2. **鼓励使用新 API**：通过弃用提示，引导开发者使用更安全、更高效的新接口。 3. **清理代码库**：在后续版本中逐步删除已弃用的 API，保持 Qt 的轻量化和现代化。 --- ## ✅ 总结 - `QT_DEPRECATED_SINCE(x, y, z)` 用于标记某个函数或类从指定 Qt 版本开始弃用。 - 使用它可以提高代码可维护性，避免使用过时 API。 - 配合 `QT_DEPRECATED_X()` 可以提供替代建议。 - 在开发库时，应合理使用弃用宏，引导用户迁移到新接口。 --- ##