Qt for Android 支持的版本选择指南

为了将支持的版本保持在 Qt 可维护性的水平,特别是对于预计将持续 3 年的 LTS 版本,Qt for Android 为给定的 Qt 版本提供了选择支持版本的指南。这使得选择清晰透明,并有助于形成对每个 Qt for Android 版本支持的正确预期。

最低支持版本

选择最低支持版本的指导原则是

  • 每年评估一次 Qt 秋季发布的最低版本,其中也包括 LTS 版本。
  • 在特定秋季版本的平台冻结截止日期时,目标至少为apilevels.com上列出的市场累计使用量的 90%。
  • 选择工作在平台冻结前 1 个月完成,届时我们会检查哪些版本符合 90% 的范围,并决定是否选择较新的最低版本,以及选择哪个新的最低版本。
  • 这些更改会在 Qt 开发邮件列表中发布,并反映在版本更改日志和 Qt for Android 文档中。
  • 在特殊情况下,如果需要对不符合上述标准的版本进行修改,则会在平台冻结截止日期前公布,并说明做出该决定的原因。

最低版本的更改将反映在我们的 CI 测试运行和构建系统(即 CMake 和 androiddeployqt)中,因此发布的库需要上述最低版本才能运行。如果要使用旧版本,则需要重新构建 Qt 并对构建系统进行适当修改。即使这样的构建可能适用于旧版本,但请注意,它们将超出 Qt 官方支持的范围。不过,官方的 Qt for Android 库可能会也可能不会适用于针对旧版本的构建,而不是发布的最低版本。

最大支持版本

在春季发布的 Qt 中,我们的目标是支持 Google 在前一年秋季发布的 Android 版本。这将成为 Qt 新的最大支持版本。

在 Qt LTS 补丁发布后的两年内,Qt LTS 版本还将支持新上市的 Android 版本。这允许用户针对较新的 Android 版本来遵守 Google Play 商店的目标 SDK 发布政策。实际上,在这两年内发布的新安卓版本将成为 Qt LTS 版本在下一个补丁发布中支持的最大版本。

自动测试中使用的目标设备

以下是 Qt for Android 版本自动测试中的 Android 设备列表,它包括但不限于这些设备:

设备操作系统版本架构外形
像素 2安卓 11(应用程序接口 30)arm64_v8a移动设备
像素 2 XL安卓 11 (API 30)arm64_v8a移动版
像素 4A安卓 12(应用程序接口 31)armv7、arm64_v8a手机
像素 6安卓 13(应用程序接口 33)arm64_v8a移动版
像素 6 Pro安卓 12 (API 31)arm64_v8a移动版
像素 6a安卓 14 (API 34)arm64_v8a移动版
像素 7安卓 13 (API 33)arm64_v8a移动版
Pixel 7 Pro安卓 13 (API 33)arm64_v8a移动版
像素 7a安卓 14 (API 34)arm64_v8a手机
三星 Galaxy S10安卓 9(应用程序接口 28)armv7、arm64_v8a移动版
三星 Galaxy S21安卓 12(应用程序接口 31)armv7、arm64_v8a移动版
三星 Galaxy Tab S4安卓 10(应用程序接口 29)armv7、arm64_v8a平板电脑
无手机 1安卓 14 [UP1A.231005.007] (API 34)arm64_v8a手机
摩托罗拉 Moto G5 Plus安卓 8 [UP1A.230519.001] (API 27)arm64_v8a手机
三星 Galaxy Tab A9+安卓 14 [UP1A.231005.007] (API 34)arm64_v8a平板电脑
像素 6a安卓 15 [AP3A.241105.007] (API 35)arm64_v8a手机
像素 8安卓 15 [AP3A.241105.007] (API 35)arm64_v8a手机
像素平板电脑安卓 15 [AP3A.241105.007] (API 35)arm64_v8a平板电脑

注: 上表仅在此 Qt 补丁发布时准确。它可能会在补丁发布周期内发生变化,只能作为 Qt 公司能快速重现错误的参考。

© 2025 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.