Merge pull request #7439 from m4gr3d/update_android_section

tutorials/editor/index.rst

@@ -24,6 +24,20 @@ in other sections where appropriate. For example, the :ref:`animation editor
    default_key_mapping
    customizing_editor
 
+Android editor
+--------------
+
+Godot offers a native port of the editor running entirely on Android devices.
+The Android port can be downloaded from the `Android Downloads page <https://godotengine.org/download/android/>`__.
+While we strive for feature parity with the Desktop version of the editor,
+the Android port has a certain amount of caveats you should be aware of.
+
+.. toctree::
+   :maxdepth: 1
+   :name: toc-android-editor
+
+   using_the_android_editor
+
 Web editor
 ----------
 

tutorials/editor/using_the_android_editor.rst

@@ -0,0 +1,55 @@
+.. _doc_using_the_android_editor:
+
+Using the Android editor
+========================
+
+In 2023, `we added <https://godotengine.org/article/android_godot_editor_play_store_beta_release/>`__
+a `Android port of the editor <https://godotengine.org/download/android/>`__
+that can be used to work on new or existing projects on Android devices.
+
+.. note::
+
+    The Android editor is in beta testing stage, while we continue to refine the experience,
+    and bring it up to parity with the Desktop version of the editor. See :ref:`doc_using_the_android_editor_limitations` below.
+
+Android devices support
+-----------------------
+
+The Android editor requires devices running Android 5 Lollipop or higher, with at least OpenGL 3 support. This includes (not exhaustive):
+
+- Android tablets, foldables and large phones
+- Android-powered netbooks
+- Chromebooks supporting Android apps
+
+.. _doc_using_the_android_editor_limitations:
+
+Required Permissions
+--------------------
+
+The Android editor requires the `All files access permission <https://developer.android.com/training/data-storage/manage-all-files#all-files-access>`__.
+The permission allows the editor to create / import / read project files from any file locations on the device.
+Without the permission, the editor is still functional, but has limited access to the device's files and directories.
+
+Limitations & known issues
+--------------------------
+
+Here are the known limitations and issues of the Android editor:
+
+- No C#/Mono support
+- No GDExtension support
+- No support for external script editors
+- While available, the *Vulkan Forward+* renderer is not recommended due to severe performance issues
+- No support for building and exporting an Android APK binary.
+  As a workaround, you can generate and export a `Godot PCK or ZIP file <https://docs.godotengine.org/en/stable/tutorials/export/exporting_projects.html#pck-versus-zip-pack-file-formats>`__
+- No support for building and exporting binaries for other platforms
+- Performance and stability issues when using the *Vulkan Mobile* renderer for a project
+- UX not optimized for Android phones form-factor
+- `Android Go devices <https://developer.android.com/guide/topics/androidgo>`__ lacks
+  the *All files access* permission required for device read/write access.
+  As a workaround, when using a Android Go device, it's recommended to create new projects only in the Android *Documents* or *Downloads* directories.
+- The editor doesn't properly resume when *Don't keep activities* is enabled in the *Developer Options*
+
+.. seealso::
+
+    See the
+    `list of open issues on GitHub related to the Android editor <https://github.com/godotengine/godot/issues?q=is%3Aopen+is%3Aissue+label%3Aplatform%3Aandroid+label%3Atopic%3Aeditor>`__ for a list of known bugs.