Add Qt Android Studio Plugin Documentation

Add the page with all the info for the plugin. Add a link in on the
Qt for Android home page. The plugin UI help menu and IntelliJ market
website should link to this as the master.

Task-number: QTBUG-121447
Pick-to: 6.7 6.7.0
Change-Id: Icb27903c2c64f0b68e1479a394cd2f150c920a0b
Reviewed-by: Tinja Paavoseppä <tinja.paavoseppa@qt.io>

16 files changed, 234 insertions, 3 deletions

diff --git a/doc/images/android-studio-plugin/Android_Studio_Settings.png b/doc/images/android-studio-plugin/Android_Studio_Settings.png
new file mode 100644
index 000000000..bb0f0b3ad
--- /dev/null
+++ b/doc/images/android-studio-plugin/Android_Studio_Settings.png
diff --git a/doc/images/android-studio-plugin/CheckPluginInstall.png b/doc/images/android-studio-plugin/CheckPluginInstall.png
new file mode 100644
index 000000000..ea4c6abc7
--- /dev/null
+++ b/doc/images/android-studio-plugin/CheckPluginInstall.png
diff --git a/doc/images/android-studio-plugin/SettingsSet.png b/doc/images/android-studio-plugin/SettingsSet.png
new file mode 100644
index 000000000..54554b210
--- /dev/null
+++ b/doc/images/android-studio-plugin/SettingsSet.png
diff --git a/doc/images/android-studio-plugin/Settings_Qt.png b/doc/images/android-studio-plugin/Settings_Qt.png
new file mode 100644
index 000000000..0ac8278d0
--- /dev/null
+++ b/doc/images/android-studio-plugin/Settings_Qt.png
diff --git a/doc/images/android-studio-plugin/android_studio_select_run.png b/doc/images/android-studio-plugin/android_studio_select_run.png
new file mode 100644
index 000000000..d0f5a693b
--- /dev/null
+++ b/doc/images/android-studio-plugin/android_studio_select_run.png
diff --git a/doc/images/android-studio-plugin/create_new_Qt_project_1.png b/doc/images/android-studio-plugin/create_new_Qt_project_1.png
new file mode 100644
index 000000000..7a2d202b4
--- /dev/null
+++ b/doc/images/android-studio-plugin/create_new_Qt_project_1.png
diff --git a/doc/images/android-studio-plugin/create_new_Qt_project_2.png b/doc/images/android-studio-plugin/create_new_Qt_project_2.png
new file mode 100644
index 000000000..419ed613c
--- /dev/null
+++ b/doc/images/android-studio-plugin/create_new_Qt_project_2.png
diff --git a/doc/images/android-studio-plugin/import_qt_project.png b/doc/images/android-studio-plugin/import_qt_project.png
new file mode 100644
index 000000000..8478b8275
--- /dev/null
+++ b/doc/images/android-studio-plugin/import_qt_project.png
diff --git a/doc/images/android-studio-plugin/open_existing_project.png b/doc/images/android-studio-plugin/open_existing_project.png
new file mode 100644
index 000000000..58997e2cc
--- /dev/null
+++ b/doc/images/android-studio-plugin/open_existing_project.png
diff --git a/doc/images/android-studio-plugin/select_android_dir.png b/doc/images/android-studio-plugin/select_android_dir.png
new file mode 100644
index 000000000..e1ffdd5a0
--- /dev/null
+++ b/doc/images/android-studio-plugin/select_android_dir.png
diff --git a/doc/images/android-studio-plugin/select_example_project.png b/doc/images/android-studio-plugin/select_example_project.png
new file mode 100644
index 000000000..78b745c13
--- /dev/null
+++ b/doc/images/android-studio-plugin/select_example_project.png
diff --git a/doc/images/android-studio-plugin/select_gear_install_plugin.png b/doc/images/android-studio-plugin/select_gear_install_plugin.png
new file mode 100644
index 000000000..b440d9999
--- /dev/null
+++ b/doc/images/android-studio-plugin/select_gear_install_plugin.png
diff --git a/doc/images/android-studio-plugin/selectpluginjar.png b/doc/images/android-studio-plugin/selectpluginjar.png
new file mode 100644
index 000000000..e145dd8e1
--- /dev/null
+++ b/doc/images/android-studio-plugin/selectpluginjar.png
diff --git a/doc/src/external-resources.qdoc b/doc/src/external-resources.qdoc
index 7bc580dec..ea0a1bba6 100644
--- a/doc/src/external-resources.qdoc
+++ b/doc/src/external-resources.qdoc
@@ -433,6 +433,12 @@
     \externalpage https://qtcloudservices.com/
     \title Qt Cloud Services
 */
+
+/*!
+    \externalpage http://doc.qt.io/qtcreator/creator-configuring.html
+    \title Qt Creator
+*/
+
 /*!
     \externalpage http://doc.qt.io/qtcreator/creator-configuring.html
     \title Configuring Qt Creator
@@ -658,6 +664,11 @@
 */
 
 /*!
+    \externalpage https://www.qt.io/product/ui-design-tools
+    \title \QDS
+*/
+
+/*!
     \externalpage https://doc.qt.io/qtforpython-6/tutorials/index.html
     \title Qt for Python Tutorials
 */
diff --git a/doc/src/platforms/android/android-studio-tools-plugin.qdoc b/doc/src/platforms/android/android-studio-tools-plugin.qdoc
new file mode 100644
index 000000000..f2b082991
--- /dev/null
+++ b/doc/src/platforms/android/android-studio-tools-plugin.qdoc
@@ -0,0 +1,211 @@
+// Copyright (C) 2024 The Qt Company Ltd.
+// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR GFDL-1.3-no-invariants-only
+
+
+/*!
+    \page qt-tools-for-android-studio.html
+    \title \QtTAS
+    \brief Provides an overview and getting started guide for the plugin.
+
+    \section1 Overview
+
+    What you need to know about the plugin:
+
+    \section2 Features
+
+    The plugin allows you to import new or existing Qt QML projects to a new or
+    existing Android Studio project.
+
+    \section2 Supported configurations
+
+    You can find what is supported here.
+
+    \section3 Host environments
+
+    The \l{Supported Platforms}{host environment limitations} for building
+    Qt applications also exist for the plugin. The plugin has been tested on
+    the following operating systems:
+    \list
+        \li Linux (Ubuntu 22.04)
+        \li Windows (10, 11)
+        \li macOS ARM (Xcode version 15.2)
+    \endlist
+
+    \section3 Android Studio
+
+    Android Studio Giraffe (2022.3.1) to Iguana (2023.2.1) is supported.
+
+    \section3 Qt for Android
+
+    \l{Qt for Android} version 6.7 or later is required.
+
+    \section3 Android SDK
+
+    \include supported-platforms.qdocinc android
+
+    \section3 Tools
+
+    The \l{Getting started with CMake}{CMake} and Ninja versions that are
+    supported are packaged with the version of Qt you are installing.
+
+    \section2 Licensing
+
+    This plugin is covered by the \l{Qt Licensing Overview}{Qt Community Edition}
+    license.
+
+    \section1 Getting started
+
+    Here we cover installing the plugin, installing all the minimum required
+    Qt dependencies for using the plugin, runs through importing an example
+    Qt for Android project, and building and running the project on a target device.
+    There is also information on the plugin features and UI.
+
+    \section2 Installing dependencies
+
+    \list
+        \li Qt for Android installation (6.7 or later)
+        \li Google's Android Studio IDE
+        \li The \l{Android Development Prerequisites}{Android SDK}
+    \endlist
+
+    \section3 Install Qt for Android
+
+    There are two ways to get Qt for Android, but for most users, we recommended
+    the following way:
+
+    \section4 With the \QOI
+
+    To download and install Qt for Android, follow the instructions on the
+    \l{Get and Install Qt} page, and do a custom install that includes at
+    least the minimum requirements:
+
+    \list
+        \li Qt for Android
+        \li CMake
+        \li Ninja
+    \endlist
+
+    The following instructions assume you don't want to install \l{\QDS} and
+    \l{Qt Creator}. These would normally be installed by default but the instructions
+    here explicitly deselect these and anything not required.
+
+    \list 1
+        \li Select custom install. If you change the location make sure to note
+        this as you will need it later.
+        \li Deselect \uicontrol{\QDS}.
+        \li Expand \uicontrol{Qt 6.7} or later and select \uicontrol{Qt for Android}.
+        \li Deselect \uicontrol{Developer and Designer Tools}.
+        \li Select \uicontrol{CMake} and \uicontrol{Ninja}.
+        \li Select any optional Qt modules you might need.
+        \li Proceed to install.
+    \endlist
+
+    \section4 Clone, build and install Qt yourself
+
+    This method should only be used by developers who are working with unreleased
+    or modified Qt builds. It won't be covered here.
+
+    See \l{Qt for Android - Building from Source}.
+
+    \section3 Install Android Studio and the plugin
+
+    This plugin is installed like any other IntelliJ plugin.
+
+    \list 1
+        \li\l{https://developer.android.com/studio}{Download} and install Android
+        Studio version Hedgehog or later.
+        \li Head to the plugin's Intellij marketplace page.
+            to download the plugin's jar file.
+        \li Start Android Studio.
+        \li On top-right corner select \uicontrol{Settings(gear-icon)->Install Plugins From Disk}
+        \image android-studio-plugin/select_gear_install_plugin.png
+        \li Select file and select \uicontrol{OK}.
+        \image android-studio-plugin/selectpluginjar.png
+        \li Check that the plugin is installed.
+        \image android-studio-plugin/CheckPluginInstall.png
+    \endlist
+
+    \section3 Configure the plugin
+
+    The plugin needs to know where certain parts of the Qt toolchain are.
+
+    \list 1
+        \li On top-left corner select \uicontrol{File -> Settings}.
+        \image android-studio-plugin/Android_Studio_Settings.png
+        \li Expand \uicontrol{Build,Execution,Deployment} and Select \uicontrol{Qt}.
+        \image android-studio-plugin/Settings_Qt.png
+        \li On this page, you need to set the path to the \b{qt-cmake} script,
+        located in\c{[Qt Folder Path]/<qt version>/android_<architecture>/bin}.
+        Make sure to select the right architecture for the platform you are
+        targeting.
+        \image android-studio-plugin/SettingsSet.png
+        \list
+            \li For a windows host select \c{qt-qmake.bat}.
+            \li For other operating systems select \c{qt-cmake}.
+        \endlist
+    \endlist
+
+    \note The \uicontrol {Additional CMake flags} field allows you to modify
+    your projects CMake call.
+
+    \section3 Install the Android SDK
+
+    Use Android Studio's SDK manager to install the correct API, platform, and
+    tools for this version of Qt. See \l{Android SDK}.
+
+    \section2 Running the example
+
+    Test your development setup by running the examples shipped with
+    the Qt installation. You'll need to know your Qt folder path first.
+    When using the \QOI, the default install locations for the Qt folder are:
+    \list
+         \li Windows: C:/Qt
+         \li macOS: ~/Qt
+         \li Linux: ~/Qt
+    \endlist
+
+    The example projects are located under your Qt installation directory
+    in \c{Qt/Examples/<qt version>/qtdeclarative/examples/platforms/android/}.
+    To test the examples:
+    \list 1
+      \li From Android Studio's welcome screen, select \uicontrol{Open}.
+      \image android-studio-plugin/open_existing_project.png
+      \li Select the Qt project example you want.
+      \image android-studio-plugin/select_example_project.png
+   \endlist
+
+    \section2 Compiling and deploying to a target device or emulator
+
+    To compile and deploy, select \uicontrol Run.
+
+    \image android-studio-plugin/android_studio_select_run.png
+
+    This will build the Qt project and the Android Studio project and run it.
+
+    \note Selecting \uicontrol{Make Project} will not build the Qt project.
+
+    \section2 Debugging
+
+    Debugging QML or C++ is not possible with the plugin. For that,
+    see \l{Qt Creator}.
+
+    \section1 Writing your first application from scratch
+
+    \list 1
+    \li From Android Studio top-left select \uicontrol{File -> New -> New Qt Project}.
+    \image android-studio-plugin/create_new_Qt_project_1.png
+    \li Set the \uicontrol{name} for the project, select the projects folder,
+    select the \c{Qt version} and select \uicontrol OK.
+    \image android-studio-plugin/create_new_Qt_project_2.png
+    \li Start writing your first Qt QML application!
+    \endlist
+
+    If you are a returning user or just getting started with QML, the
+    \l{The QML Reference}{QML Reference} has what you need.
+
+    \section1 Integrating QML in an Android application
+
+    The \l{embedded_qml_target}{API documentation} for embedding QML in Android
+    applications has specific implementation details and insights into this.
+
+*/
diff --git a/doc/src/platforms/android/android.qdoc b/doc/src/platforms/android/android.qdoc
index f6bcaf769..140e2b483 100644
--- a/doc/src/platforms/android/android.qdoc
+++ b/doc/src/platforms/android/android.qdoc
@@ -11,9 +11,18 @@
     Qt for Android enables you to develop Qt applications for Android devices,
     and supports a wide range of features and use-cases.
 
-    To download and install Qt for Android, follow the instructions on the
-    \l{Getting Started with Qt for Android} page. To build Qt from source,
-    see \l{Qt for Android - Building from Source}{Building from Source}.
+    To start your Qt for Android application, download and install Qt for Android
+    and use the Qt Creator IDE, follow the instructions on the
+    \l{Getting Started with Qt for Android} page.
+
+    If you have an existing Android application try Qt's \l{\QtTAS}{plugin}
+    for Google's Android Studio. Find it on the IntelliJ marketplace to download.
+    The plugin allows you use the \l{Qt Quick View Android Class} to add
+    Qt Quick content to your Android app as a
+    \l{https://developer.android.com/reference/android/view/View}{view}.
+
+     To build Qt from source, see
+     \l{Qt for Android - Building from Source}{Building from Source}.
 
     \target android-supported-configurations
     \section1 Supported Configurations