本页内容

qt_android_add_apk_target

定义了一个构建目标,该目标会运行 androiddeployqt 来生成 APK。

该命令定义在Qt6 包的Core 组件中,可按以下方式加载:

find_package(Qt6 REQUIRED COMPONENTS Core)

该命令于 Qt 6.0 中引入。

警告: 自 Qt 6.5 起,该命令 已弃用。请改用qt_add_executable()。

注意: 仅当目标平台为 Android 时才应调用此 命令。

语法

qt_android_add_apk_target(target)

如果禁用了无版本命令,请改用qt6_android_add_apk_target() 。它支持与本命令相同的参数集。

描述

由本命令创建的自定义目标<target>_make_apk 、<target>_make_aab 和<target>_make_aar 会读取一个 Android 部署设置文件,并通过运行androiddeployqt 分别生成 APK、AAB 和 AAR 包。设置文件的位置取自target 的QT_ANDROID_DEPLOYMENT_SETTINGS_FILE 属性。 该文件通常由qt_android_generate_deployment_settings() 生成。相应的 Android 包将生成在target 的 CMake 构建目录下的android-build 子目录中。

目标<target>_make_apk 、<target>_make_aab 和<target>_make_aar 将分别作为构建目标apk 、aab 和aar 的依赖项自动添加,这些构建目标也会自动创建。可以通过将变量QT_NO_GLOBAL_APK_TARGET 、QT_NO_GLOBAL_AAB_TARGET 和QT_NO_GLOBAL_AAR_TARGET 设置为TRUE 来禁用目标apk 、aab 和aar 的创建。

示例

qt_android_generate_deployment_settings(myapp)
qt_android_add_apk_target(myapp)

上述命令定义了myapp_make_apk 、myapp_make_aab 、myapp_make_aar 、apk 、aab 和aar 构建目标,它们分别可用于仅生成myapp 包,或生成项目中的所有 APK、AAB 和 AAR。

另请参阅 qt_android_generate_deployment_settings()、qt_finalize_target() 和qt_finalize_project()。

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