发布到 Google Play
Qt for Android 为开发、构建和打包 Android 应用程序提供了完整的解决方案。其中大部分任务,尤其是打包和部署,都由Qt Creator 处理,为开发人员提供了丰富的体验。
每次使用Qt Creator 运行应用程序时,都会创建一个 Android 应用程序包(APK)并部署到您选择的目标(设备或模拟器)上。只需对打包设置稍作修改,即可在 Google Play 上发布应用程序。
构建应用程序
应用程序开发完成后,如果您想将其发布到 Google Play,请按照以下说明创建可在 Google Play 上运行的.apk
或.aab
:
- 通过Qt Creator 打开项目,选择
Release Build
。 - 选择Projects >Build >Build Android APK >Create Templates 来创建 Android 软件包模板文件,如
AndroidManifest.xml
,这是这里主要关注的文件。 - 检查
AndroidManifest.xml
中的以下设置:- 设置Application name 和Application icon 。
- 使用
android:label
在清单的application
部分设置应用程序的名称。 - 通过 CMake 的属性QT_ANDROID_VERSION_NAME和QT _ ANDROID _VERSION_ CODE,设置应用程序的版本代码和名称。对于 qmake,请使用ANDROID_VERSION_NAME和ANDROID_VERSION_CODE。对于 qmake,我们将在下文中使用ANDROID_VERSION_CODE,以便发布多ABIs 应用程序。
- 根据应用程序的需要设置
minimum
和target
SDK 版本。这可以使用 CMake 属性QT_ANDROID_TARGET_SDK_VERSION 和QT_ANDROID_MIN_SDK_VERSION。或qmake
ANDROID_TARGET_SDK_VERSION ANDROID_MIN_SDK_VERSION。 - 设置密钥库以签署软件包。如果没有,可以创建一个新的密钥库。有关更多信息,请参阅为软件包指定设置。
- 找到生成的软件包:
- 对于 APK 软件包,请在
.apk
找到软件包:<build_path>/android-build/build/outputs/apk/release/android-build-release.apk
注意: 在Qt Creator 中,选择Projects >Build >Build Steps >Build Android APK >Open package location after build 以构建应用程序的
.apk
并打开包含软件包的目录。 - 对于 AAB 软件包,选择Projects >Build >Build Steps >Build Android APK >Build .aab (Android App Bundle) forQt Creator 生成
.aab
文件,然后在以下位置找到软件包:<build_path>/android-build/build/outputs/bundle/release/android-build-release.aab
- 对于 APK 软件包,请在
将应用程序上传到 Google Play 商店
登录Google Play 开发者控制台并上传.aab
文件,以及与应用程序使用情况类似的说明和屏幕截图。
多ABI软件包
对于支持构建多ABI 捆绑包的 Qt 版本,上传一个包含所有支持架构的.aab
即可。Qt 6.9仅支持使用 CMake 构建多ABI 捆绑程序。有关详细信息,请参阅QT_ANDROID_ABIS。
单 ABI 捆绑程序
然而,对于不支持多ABI 构建的 Qt 版本,发布应用程序需要额外的步骤。Qt 6.9 中的qmake
构建就属于这一类。
要发布使用单一 ABI 工具包构建的应用程序,您需要确保每个 ABI 使用不同的内部版本代码。版本代码是应用程序发布的内部非公开标识符。构建您要支持的每一种架构,并为每种 ABI 设置不同的版本代码。qmake 的操作如下:
ANDROID_VERSION_CODE = <unique_version>
应用程序开发人员可以为版本代码使用特定的方案。例如,代码中可以包含平台、ABI 和实际版本的分块。这样,一个示例方案就是<Platform><ABI><AppVersion>
:
- 平台:
- 1 表示 Arm
- 2 代表英特尔
- 架构:
- 32 用于 32 位
- 64 用于 64 位
对于 arm64-v8a ABI,1.0 版的版本代码为16410
。
更多信息,请参阅 Google 有关应用程序版本控制的文档。
下面的截图显示了一个应用程序使用 4 种 ABI 的示例,每个软件包都使用唯一的版本代码,与作为公共版本字符串的版本名称不同。
另请参阅 在 Android 上部署应用程序。
© 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.