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. Load the package with:

find_package(Qt6 COMPONENTS Core REQUIRED)

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.

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.

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().

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