Android: Add limitations and few frequent questions

Task-number: QTBUG-80391
Change-Id: I9485665baf7ebec1d87b9196c8e270d1e15f3543
Reviewed-by: Leena Miettinen <riitta-leena.miettinen@qt.io>

2 files changed, 41 insertions, 0 deletions

diff --git a/doc/src/external-resources.qdoc b/doc/src/external-resources.qdoc
index da9d4476..5d44e4b4 100644
--- a/doc/src/external-resources.qdoc
+++ b/doc/src/external-resources.qdoc
@@ -251,6 +251,10 @@
     \title Android: Build Configuration Files
 */
 /*!
+    \externalpage https://developer.android.com/reference/android/app/Activity
+    \title Android: Activity
+*/
+/*!
     \externalpage https://developer.android.com/studio/build/dependencies
     \title Android: Add build dependencies
 */
@@ -263,6 +267,10 @@
     \title Android: Accessing original files
 */
 /*!
+    \externalpage https://developer.android.com/guide/components/fragments
+    \title Android: Fragments
+*/
+/*!
     \externalpage https://bugreports.qt.io/browse/QTBUG-81461
     \title QTBUG-81461
 */
@@ -271,6 +279,10 @@
     \title QTBUG-78009
 */
 /*!
+    \externalpage https://bugreports.qt.io/browse/QTBUG-72086
+    \title QTBUG-72086
+*/
+/*!
     \externalpage http://strawberryperl.com
     \title Perl
 */
diff --git a/doc/src/platforms/android/android-platform-notes.qdoc b/doc/src/platforms/android/android-platform-notes.qdoc
index 96878ea5..6dc339ff 100644
--- a/doc/src/platforms/android/android-platform-notes.qdoc
+++ b/doc/src/platforms/android/android-platform-notes.qdoc
@@ -120,4 +120,33 @@
     language like Japanese, with Gboard, only a QWERTY keyboard is displayed.
     This environment variable is queried each time the keyboard is displayed,
     so it's possible to toggle the workaround on and off, as necessary.
+
+    \section1 Limitations
+
+    Some of the Qt modules might have features that are not supported on Android
+    or have limitations. For more information, see \l{QTBUG-72086}.
+
+    \section1 Frequently Asked Questions
+
+    \list
+        \li Should I use \c QtActivity or \l{Android: Activity}{Android Activity}
+            to create a custom Activity?
+
+        \c QtActivity extends \c Activity and implements the logic needed to load
+        the Qt libraries or handle events and native calls between Android and Qt.
+        In general, extending \c QtActivity is needed if you are using any native
+        calls. Otherwise, extending \c Activity should work.
+
+        \li Should I use \c QtService or \l{Android: Service}{Android Service}?
+
+        The same reasoning as \c QtActivity applies here. Unless you are using
+        features that require the Qt libraries to be loaded, like native calls.
+
+        \li Can \l{Android: Fragments}{Android Fragments} be used with Qt? What is
+            the equivalent for Fragment in Qt?
+
+        Android Fragments cannot be used with Qt. However, Qt offers it's own modular
+        components and views with QML. You can combine multiple components in one
+        QML view. For more information, see \l{Qt QML}.
+    \endlist
 */