qt_android_generate_deployment_settings
生成 androiddeployqt 所需的部署设置文件。
该命令定义在Qt6 包的Core 组件中,可按如下方式加载:
find_package(Qt6 REQUIRED COMPONENTS Core)该命令于 Qt 6.0 中引入。
警告: 自 Qt 6.5 起,此 命令已弃用。请改用qt_add_executable()。
注意: 仅当目标平台为 Android 时才应调用此 命令。
语法
qt_android_generate_deployment_settings(target)如果禁用了无版本号的命令,请改用qt6_android_generate_deployment_settings() 。它支持与本命令相同的参数集。
描述
androiddeployqt 工具需要一个部署设置文件作为输入。该命令会读取 CMake 变量以及目标(target )的属性,并在目标的二进制目录中生成此类文件。执行完成后,该文件的完整路径将存储在目标的QT_ANDROID_DEPLOYMENT_SETTINGS_FILE 属性中。
CMake 变量
生成部署设置文件时会用到若干变量。其中部分由 Qt 提供,部分由 CMake 或 Android NDK 提供。
- ANDROID_NDK_HOST_SYSTEM_NAME
- ANDROID_SDK_ROOT
CMAKE_ANDROID_ARCH_ABICMAKE_ANDROID_NDKCMAKE_SYSROOT- QT_ANDROID_APPLICATION_ARGUMENTS
- QT_HOST_PATH
目标属性
以下属性将从指定的 `target` 中读取。请注意,该命令是在目标最终化过程中调用的(参见`qt_finalize_target()`)。如果您使用`qt_add_executable()`创建目标,并且需要修改其中某些目标属性,则必须确保推迟目标最终化。 有关如何实现这一点,请参阅qt_add_executable()。
- QT_ANDROID_DEPLOYMENT_DEPENDENCIES
- QT_ANDROID_EXTRA_LIBS
- QT_ANDROID_EXTRA_PLUGINS
- QT_ANDROID_MIN_SDK_VERSION
- QT_ANDROID_PACKAGE_SOURCE_DIR
- QT_ANDROID_TARGET_SDK_VERSION
- QT_ANDROID_COMPILE_SDK_VERSION
- QT_ANDROID_PACKAGE_NAME
- QT_ANDROID_APP_NAME
- QT_ANDROID_APP_ICON
- QT_ANDROID_VERSION_NAME
- QT_ANDROID_VERSION_CODE
- QT_ANDROID_LEGACY_PACKAGING
- QT_QML_IMPORT_PATH
- QT_QML_ROOT_PATH
- QT_NO_ENTRYPOINT
返回后,QT_ANDROID_DEPLOYMENT_SETTINGS_FILE 目标属性将包含生成的部署设置文件的位置。
示例
qt_android_generate_deployment_settings(myapp)
qt_android_add_apk_target(myapp)© 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.