qt_android_generate_deployment_settings | Qt Core 6.4.3

- Qt 6.4
- Qt Core
- CMake Commands in Qt6 Core
- qt_android_generate_deployment_settings
- Qt 6.4.3 Reference Documentation

# qt_android_generate_deployment_settings

Generates the deployment settings file needed by androiddeployqt.

The command is defined in the `Core` component of the `Qt6` package, which can be loaded like so:

     find_package(Qt6 REQUIRED COMPONENTS Core)

This command was introduced in Qt 6.0.

Note: This command is in technology preview and may change in future releases.

Note: This command should only be called if targeting the Android platform.

## Synopsis

     qt_android_generate_deployment_settings(target)

If versionless commands are disabled, use `qt6_android_generate_deployment_settings()` instead. It supports the same set of arguments as this command.

## Description

The `androiddeployqt` tool expects a deployment settings file as input. This command reads CMake variables and properties of the `target` to generate such a file in the target's binary directory. Upon return, the full path to this file is available in the target's `QT_ANDROID_DEPLOYMENT_SETTINGS_FILE` property.

### CMake Variables

A number of variables are used while generating the deployment settings file. Some are provided by Qt, others by CMake or the Android NDK.

- ANDROID_NDK_HOST_SYSTEM_NAME
- ANDROID_SDK_ROOT
- `CMAKE_ANDROID_ARCH_ABI`
- `CMAKE_ANDROID_NDK`
- `CMAKE_SYSROOT`
- QT_ANDROID_APPLICATION_ARGUMENTS
- QT_HOST_PATH

### Target Properties

The properties below will be read from the specified `target`. Note that this command is called as part of target finalization (see qt_finalize_target()). If you are using qt_add_executable() to create the target and you need to modify some of these target properties, you need to ensure that target finalization is deferred. See qt_add_executable() for how to accomplish this.

- 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_VERSION_NAME
- QT_ANDROID_VERSION_CODE
- QT_QML_IMPORT_PATH
- QT_QML_ROOT_PATH
- qt_no_entrypoint

Upon return, the `QT_ANDROID_DEPLOYMENT_SETTINGS_FILE` target property will contain the location of the generated deployment settings file.

## Example

     qt_android_generate_deployment_settings(myapp)
     qt_android_add_apk_target(myapp)

See also qt_android_add_apk_target() and qt_finalize_target().