Home Explore Help
Sign In
godotengine
/
godot-docs
mirror of https://github.com/godotengine/godot-docs
Watch 1
Star 1
Fork 0
Files
Branch: 4.3
Branches Tags
godot-docs
/
tutorials
/
editor
/
using_the_android_editor.rst

using_the_android_editor.rst 2.6 KB
Permalink History Raw

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354 
  1. .. _doc_using_the_android_editor:
    2. 

  2. 

  3. Using the Android editor
    4. 

  4. ========================
    5. 

  5. 

  6. In 2023, `we added <https://godotengine.org/article/android_godot_editor_play_store_beta_release/>`__
    7. 

  7. an `Android port of the editor <https://godotengine.org/download/android/>`__
    8. 

  8. that can be used to work on new or existing projects on Android devices.
    9. 

  9. 

  10. .. note::
    11. 

  11. 

  12.     The Android editor is in early access, while we continue to refine the experience,
    13. 

  13.     and bring it up to parity with the Desktop version of the editor. See :ref:`doc_using_the_android_editor_limitations` below.
    14. 

  14. 

  15. Android devices support
    16. 

  16. -----------------------
    17. 

  17. 

  18. The Android editor requires devices running Android 5 Lollipop or higher, with at least OpenGL 3 support. This includes (not exhaustive):
    19. 

  19. 

  20. - Android tablets, foldables and large phones
    21. 

  21. - Android-powered netbooks
    22. 

  22. - Chromebooks supporting Android apps
    23. 

  23. 

  24. .. _doc_using_the_android_editor_limitations:
    25. 

  25. 

  26. Required Permissions
    27. 

  27. --------------------
    28. 

  28. 

  29. The Android editor requires the `All files access permission <https://developer.android.com/training/data-storage/manage-all-files#all-files-access>`__.
    30. 

  30. The permission allows the editor to create / import / read project files from any file locations on the device.
    31. 

  31. Without the permission, the editor is still functional, but has limited access to the device's files and directories.
    32. 

  32. 

  33. Limitations & known issues
    34. 

  34. --------------------------
    35. 

  35. 

  36. Here are the known limitations and issues of the Android editor:
    37. 

  37. 

  38. - No C#/Mono support
    39. 

  39. - No support for external script editors
    40. 

  40. - While available, the *Vulkan Forward+* renderer is not recommended due to severe performance issues
    41. 

  41. - No support for building and exporting an Android APK binary.
    42. 

  42.   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>`__
    43. 

  43. - No support for building and exporting binaries for other platforms
    44. 

  44. - UX not optimized for Android phones form-factor
    45. 

  45. - `Android Go devices <https://developer.android.com/guide/topics/androidgo>`__ lacks
    46. 

  46.   the *All files access* permission required for device read/write access.
    47. 

  47.   As a workaround, when using an Android Go device, it's recommended to create new projects only in the Android *Documents* or *Downloads* directories.
    48. 

  48. - The editor doesn't properly resume when *Don't keep activities* is enabled in the *Developer Options*
    49. 

  49. 

  50. .. seealso::
    51. 

  51. 

  52.     See the
    53. 

  53.     `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.
    54. 

  54.