From 1956ca7d70c37c2efb6ff7930843a94aac36be71 Mon Sep 17 00:00:00 2001 From: Assam Boudjelthia Date: Thu, 3 Mar 2022 12:26:31 +0200 Subject: [PATCH] Document use of android:allowNativeHeapPointerTagging in the manifest Document the tag for more clarity on why it's needed, and for what platforms. Pick-to: 6.2 6.3 Task-number: QTBUG-97009 Task-number: QTBUG-91150 Change-Id: Ie4522fb582583be07270d3cdbf83992897b51669 Reviewed-by: Nicholas Bennett --- doc/global/externalsites/external-resources.qdoc | 4 ++++ .../doc/src/android-manifest-file-configuration.qdoc | 7 +++++++ 2 files changed, 11 insertions(+) diff --git a/doc/global/externalsites/external-resources.qdoc b/doc/global/externalsites/external-resources.qdoc index 6ba1e213804..1ef261caf6f 100644 --- a/doc/global/externalsites/external-resources.qdoc +++ b/doc/global/externalsites/external-resources.qdoc @@ -52,6 +52,10 @@ \externalpage https://developer.android.com/training/app-links/verify-site-associations \title Android: Verify Android App Links */ +/*! + \externalpage https://source.android.com/devices/tech/debug/tagged-pointers + \title Android: Tagged Pointers +*/ /*! \externalpage https://developer.apple.com/documentation/uikit/uiapplication/1622952-canopenurl \title iOS: canOpenURL: diff --git a/src/android/templates/doc/src/android-manifest-file-configuration.qdoc b/src/android/templates/doc/src/android-manifest-file-configuration.qdoc index 24faef4c7bf..64c2c82b440 100644 --- a/src/android/templates/doc/src/android-manifest-file-configuration.qdoc +++ b/src/android/templates/doc/src/android-manifest-file-configuration.qdoc @@ -108,6 +108,13 @@ Qt sets the following manifest configuration by default: \row \li android:requestLegacyExternalStorage \li Whether to use Android scoped storage. Default \c true. +\row + \li android:allowNativeHeapPointerTagging + \li Whether or not the app has the Heap pointer tagging feature enabled. + This has to be set to \c false when targeting Arm64 hardware with Android 11+ + because it can break QML's NaN-tagging scheme. + For more information, see \l {Android: Tagged Pointers}{Tagged Pointers}. + The default value is \c false. \row \li {1, 6} \l {Android: App Manifest }{} \li android:name