AuroraMiddleware/qt5base-lts
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

Add documentation for the Android Multi-ABI related variables

Browse Source 
Document:
  QT_ANDROID_BUILD_ALL_ABIS - cache variable
  QT_ANDROID_ABIS - cache variable
  QT_PATH_ANDROID_ABI_<ABI> - cache variables
  ANDROID_ABIS - new argument of qt6_add_executable function

Pick-to: 6.3
Task-number: QTBUG-99261
Change-Id: I7061065a6f329864ec9004ef41121f1225c5fc80
Reviewed-by: Alexandru Croitor <alexandru.croitor@qt.io>
Reviewed-by: Assam Boudjelthia <assam.boudjelthia@qt.io>
Reviewed-by: Leena Miettinen <riitta-leena.miettinen@qt.io>
This commit is contained in:
Alexey Edelev 2021-12-16 17:23:59 +01:00
parent fba863a87e
commit 4dc977d5ee
2 changed files with 95 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

76
src/corelib/doc/src/cmake/cmake-configure-variables.qdoc
View File

@ -102,6 +102,82 @@ out as part of the deployment settings for a target.
\sa{qt6_android_generate_deployment_settings}{qt_android_generate_deployment_settings()}
*/
/*!
\page cmake-variable-QT_ANDROID_BUILD_ALL_ABIS.html
\ingroup cmake-variables
\ingroup cmake-variables-qtcore
\title QT_ANDROID_BUILD_ALL_ABIS
\target cmake-variable-QT_ANDROID_BUILD_ALL_ABIS
\summary {Enables building multi-ABI packages using the autodetected Qt for Android SDK list.}
\preliminarycmakevariable
\cmakevariableandroidonly
The option automatically detects available ABIs of Qt for Android and uses them to
build a package. The automatic detection expects the default directory structure
supplied by the Qt installer, with the corresponding naming of the directories.
The typical directory structure looks as below:
\badcode
/path/to/Qt/6.x.x
    android_armv7
    android_arm64_v8a
    android_x86
    android_x86_64
    ...
\endcode
The auto-detected paths can be customized using one of \c{QT_PATH_ANDROID_ABI_<ABI>} variables.
The variable is set to FALSE by default.
\sa{QT_PATH_ANDROID_ABI_<ABI>}
*/
/*!
\page cmake-variable-QT_ANDROID_ABIS.html
\ingroup cmake-variables
\ingroup cmake-variables-qtcore
\title QT_ANDROID_ABIS
\target cmake-variable-QT_ANDROID_ABIS
\summary {List of ABIs that the project packages are built for.}
\preliminarycmakevariable
\cmakevariableandroidonly
This variable specifies a list of ABIs to be used to build the project packages. The
supported ABIs: \c{armeabi-v7a, arm64-v8a, x86, x86_64}. Each ABI should have the
corresponding Qt for Android either installed or user-built. It's possible to
specify the path to the Qt for Android ABI using the corresponding
\c{QT_PATH_ANDROID_ABI_<ABI>} variable.
\note: \c{QT_ANDROID_BUILD_ALL_ABIS} has the higher priority and ignores the
QT_ANDROID_ABIS logic.
\sa{QT_PATH_ANDROID_ABI_<ABI>}, {QT_ANDROID_BUILD_ALL_ABIS}
*/
/*!
\page cmake-variable-QT_PATH_ANDROID_ABI.html
\ingroup cmake-variables
\ingroup cmake-variables-qtcore
\title QT_PATH_ANDROID_ABI_<ABI>
\target cmake-variable-QT_PATH_ANDROID_ABI_<ABI>
\summary {Set of variables to specify the path to Qt for Android for the corresponding ABI.}
\preliminarycmakevariable
\cmakevariableandroidonly
Each variable can be used to specify the path to Qt for Android for the corresponding ABI.
The list of supported ABIs can be found in the \c{QT_ANDROID_ABIS} variable documentation.
\sa{cmake-variable-QT_ANDROID_ABIS}{QT_ANDROID_ABIS}
*/
/*!
\page cmake-variable-QT_HOST_PATH.html
\ingroup cmake-variables

19
src/corelib/doc/src/cmake/cmake-properties.qdoc
View File

@ -226,6 +226,25 @@ For more information, see \l{Android: App Versioning}{Android App Versioning}.
\sa{qt6_android_generate_deployment_settings}{qt_android_generate_deployment_settings()}
*/
/*!
\page cmake-target-property-QT_ANDROID_ABIS.html
\ingroup cmake-properties-qtcore
\ingroup cmake-target-properties-qtcore
\title QT_ANDROID_ABIS
\target cmake-target-property-QT_ANDROID_ABIS
\summary {List of ABIs that packages of a single target are built for.}
\preliminarycmakeproperty
\cmakepropertyandroidonly
By setting the \c{QT_ANDROID_ABIS} property for a target, it's possible to control
the list of ABIs that the single target packages are supposed to be built for.
\sa{cmake-variable-QT_ANDROID_ABIS}{QT_ANDROID_ABIS}, {QT_ANDROID_BUILD_ALL_ABIS}
*/
/*!
\page cmake-target-property-QT_QML_ROOT_PATH.html
\ingroup cmake-properties-qtcore