使用 Android 编辑器

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.

备注

The Android editor is in early access, while we continue to refine the experience. See 局限性与已知问题 below.

Android 设备支持

Android 编辑器需要运行在 Android 5 Lollipop 或更高版本的设备上,并且至少支持 OpenGL 3。 这些设备包括(并非详尽无遗):

  • Android 平板、折叠机、大屏手机

  • Android 上网本

  • 支持 Android 应用的 Chromebook

Runtime Permissions

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.

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.

局限性与已知问题

以下是 Android 编辑器的已知局限性和问题:

  • No gradle build support.

  • No support for Android plugins as they require gradle build support. GDExtensions plugins are supported.

  • 不支持 C#/Mono。

  • 不支持外部脚本编辑器。

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

  • UX not optimized for Android phones form-factor.

  • Android Go 设备缺少设备读写访问所需的全部文件访问权限。作为变通方法,在使用 Android Go 设备时建议只在 Android 的 DocumentsDownloads 目录中创建新项目。

  • 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.

参见

请参阅GitHub 上与 Android 编辑器有关的问题列表来了解已知 Bug 列表。