Attention: Here be dragons

This is the latest (unstable) version of this documentation, which may document features not available in or compatible with released stable versions of Godot.

Checking the stable version of the documentation...

Verwendung des Android-Editors

In 2023, we added an Android port of the editor that can be used to create, develop, and export 2D and 3D projects on Android devices.

The app can be downloaded from the Godot download page or from the Google Play Store.

Bemerkung

The Android editor is in early access, while we continue to refine the experience. See Beschränkungen und bekannte Probleme below.

Unterstützung von Android-Geräten

Der Android-Editor erfordert Geräte mit Android 5 Lollipop oder höher, die mindestens OpenGL 3 unterstützen. Dies beinhaltet folgende Geräte (eine Auswahl):

• Android-Tablets, faltbare Geräte und große Smartphones

• Netbooks mit Android-Betriebssystem

• Chromebooks mit Unterstützung für Android-Anwendungen

Runtime Permissions

• All files access permission: Enables the editor to create, import, and read project files from any file locations on the device. Without this permission, the editor is still functional, but has limited access to the device's files and directories.

• REQUEST_INSTALL_PACKAGES: Enables the editor to install exported project APKs.

• RECORD_AUDIO: Requested when the audio/driver/enable_input project setting is enabled.

Tips & Tricks

Input

• For the best experience and high level of productivity, connecting a bluetooth keyboard & mouse is recommended to interact with the Android editor. The Android editor supports all of the usual shortcuts and key mappings.

• When interacting with keyboard & mouse, you can decrease the size of the scrollbar using the interface/touchscreen/increase_scrollbar_touch_area editor setting.

• For 2D projects, the block coding plugin can provide a block-based visual alternative to composing scripts when lacking a connected hardware keyboard.

Multi-tasking

• On smaller devices, enabling and using picture-in-picture (PiP) mode provides the ability to easily transition between the Editor and the Play window.

  • PiP can be enabled via the run/window_placement/play_window_pip_mode editor setting.

  • The run/window_placement/android_window editor setting can be used to specify whether the Play window should always launch in PiP mode.

  • Note: In PiP mode, the Play window does not have input access.

Projects sync

• Syncing projects via Git can be done by downloading an Android Git client. We recommend the Termux terminal, an Android terminal emulator which provides access to common terminal utilities such Git and SSH.

  • Note: To use Git with the Termux terminal, you'll need to grant WRITE permission to the terminal. This can be done by running the following command from within the terminal: termux-setup-storage

Plugins

• GDExtension plugins work as expected, but require the plugin developer to provide native Android binaries.

Beschränkungen und bekannte Probleme

Hier sind die bekannten Einschränkungen und Probleme des Android-Editors:

• Keine C#/Mono Unterstützung.

• Keine Unterstützung für externe Skript-Editoren.

• While available, the Forward+ renderer is not recommended due to severe performance issues.

• UX not optimized for Android phones form-factor.

• Android Go-Geräten fehlt die Berechtigung All files access, die für den Lese-/Schreibzugriff auf das Gerät erforderlich ist. Als Abhilfe wird bei der Verwendung eines Android Go-Geräts empfohlen, neue Projekte nur in den Android-Verzeichnissen Documents oder Downloads zu erstellen.

• The editor doesn't properly resume when Don't keep activities is enabled in the Developer Options.

• There is a bug with the Samsung keyboard that causes random input to be inserted when writing scripts. It's recommended to use the Google keyboard (Gboard) instead.

Siehe auch

Siehe die Liste der offenen Issues auf GitHub im Zusammenhang mit dem Android-Editor für eine Liste der bekannten Fehler.