本页内容

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 发布政策。 实际上,在此两年期间发布的新版 Android 系统,将成为 Qt LTS 版本后续补丁发布中该 LTS 版本所支持的最高版本。

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

以下是用于 Qt for Android 版本自动化测试的 Android 设备列表。该列表按 API 版本排序,每个版本内按字母顺序排列。该列表包括但不限于以下设备:

设备操作系统版本架构外形尺寸
三星 Galaxy Tab S4 (SM-T835)Android 10 (API 29)arm64-v8a, armeabi-v7a平板电脑
Pixel 2Android 11(API 30)arm64-v8a、armeabi-v7a手机
Pixel 2 XLAndroid 11(API 30)arm64-v8a、armeabi-v7a移动设备
Pixel 6 ProAndroid 12 (API 32)arm64-v8a、armeabi-v7a移动设备
三星 Galaxy S21 (SM-G990B2)Android 12 (API 31)arm64-v8a、armeabi-v7a移动设备
Pixel 4Android 13 (API 33)arm64-v8a、armeabi-v7a移动版
Pixel 4AAndroid 13(API 33)arm64-v8a、armeabi-v7a移动设备
Pixel 7 ProAndroid 13 (API 33)arm64-v8a移动
Nothing Phone 1 (A063)Android 14 (API 34)arm64-v8a、armeabi-v7a移动
三星 Galaxy Tab A9+ (SM-X210)Android 14 (API 34)arm64-v8a、armeabi-v7a平板电脑
Pixel 8Android 15(API 35)arm64-v8a手机
三星 Galaxy A26 (SM-A266B)Android 15 (API 35)arm64-v8a、armeabi-v7a平板电脑
Pixel 6aAndroid 16(API 36)arm64-v8a、armeabi-v7a手机
Pixel 6aAndroid 16 (API 36)arm64-v8a、armeabi-v7a移动端
Pixel 7Android 16(API 36)arm64-v8a移动端
Pixel 7aAndroid 16 (API 36)arm64-v8a移动
Pixel 8Android 16(API 36)arm64-v8a移动端
Pixel 平板电脑Android 16(API 36)arm64-v8a平板电脑
三星 Galaxy Tab 10 Lite (SM-X400)Android 16 (API 36)arm64-v8a, armeabi-v7a平板电脑
三星 Galaxy S21 (SM-G990B)Android 16(API 36)arm64-v8a、armeabi-v7a手机
Pixel 6aAndroid 17 Beta2 Cinnamonbun (API 36)arm64-v8a、armeabi-v7a移动端

注意:上表 仅在发布此 Qt 补丁时准确无误。该信息在补丁发布周期内可能会发生变化,仅应作为 Qt 公司能够快速复现缺陷的参考依据。

© 2026 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.