Android 版 Qt 的 CMake 配置

本页面列出了有关 CMake 以及 Qt 对 Android 平台支持的相关信息。

影响构建过程的变量

以下是影响构建过程（包括 Gradle 配置）的 CMake 变量或属性的列表：

QT_ANDROID_ABIS	单个目标的包所构建的 ABI 列表
QT_ANDROID_ABIS	项目包的构建目标 ABI 列表
QT_ANDROID_BUILD_ALL_ABIS	启用使用自动检测到的 Qt for Android SDK 列表构建多 ABI 包
QT_ANDROID_BUILD_DIR	目标的 Android 构建目录的只读路径
QT_ANDROID_COMPILE_SDK_VERSION	Android 目标的 SDK 版本
QT_ANDROID_DEPLOYMENT_DEPENDENCIES	覆盖添加到目标部署中的 Qt 依赖项
QT_ANDROID_DEPLOYMENT_SETTINGS_FILE	指定目标生成的部署设置文件的位置
QT_ANDROID_DEPLOYMENT_TYPE	强制或禁用发布包签名，无论构建类型如何
QT_ANDROID_EXTRA_LIBS	随目标一起部署的额外库
QT_ANDROID_EXTRA_PLUGINS	随目标一起部署的额外 Qt 插件
QT_ANDROID_GENERATE_JAVA_QTQUICKVIEW_CONTENTS	启用基于 QtQuickViewContent 的类生成
QT_ANDROID_GRADLE_MULTI_MODULE	从多模块 Gradle 项目构建 Android 包
QT_ANDROID_MIN_SDK_VERSION	Android SDK 的最低版本
QT_ANDROID_MULTI_ABI_FORWARD_VARS	允许在多ABI构建中共享CMake变量
QT_ANDROID_NO_DEPLOY_QT_LIBS	Qt共享库是否打包到Android的APK中
QT_ANDROID_PACKAGE_NAME	应用的包名
QT_ANDROID_PACKAGE_SOURCE_DIR	自定义 Android 打包模板的路径
QT_ANDROID_SDK_BUILD_TOOLS_REVISION	要使用的 Android 构建工具版本
QT_ANDROID_SIGN_AAB	使用指定的密钥库、别名和存储密码对 .aab 包进行签名
QT_ANDROID_SIGN_APK	使用指定的密钥库、别名和存储密码对包进行签名
QT_ANDROID_SYSTEM_LIBS_PREFIX	指定目标设备上 Qt 库的位置
QT_ANDROID_TARGET_SDK_VERSION	Android 目标 SDK 版本
QT_QML_GENERATE_ANDROID_JAVA_CLASS	将 QML 文件标记为用于生成 Java 代码

影响 Android 应用清单文件的变量

以下是一组 CMake 变量或属性，可通过 CMake 直接设置 Android 清单文件中的部分配置，而无需在清单中手动设置。

QT_ANDROID_APPLICATION_ARGUMENTS	传递给 Android 应用程序的参数列表
QT_ANDROID_APP_ICON	Android 应用的图标资源名称
QT_ANDROID_APP_NAME	Android 应用的名称
QT_ANDROID_CREATE_SYMLINKS_ONLY	仅在 Gradle 项目目录下为依赖项创建符号链接
QT_ANDROID_POST_BUILD_GRADLE_CLEANUP	在生成 Android 包后执行 Gradle 清理
QT_ANDROID_VERSION_CODE	Android 应用的内部版本号
QT_ANDROID_VERSION_NAME	易于理解的 Android 应用版本

环境变量支持 Google 表情符号字体政策

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