Using the Android editor

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.

Nota

The Android editor is in early access, while we continue to refine the experience. See Limitations & known issues below.

Suporte de dispositivos Android

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

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: Permite que o editor instale APKs de projetos exportados.
RECORD_AUDIO: Requisitado quando a configuração de projeto audio/driver/enable_input está habilitada.

Input

Para a melhor experiência e alto nível de produtividade, recomenda-se conectar um teclado e mouse bluetooth para interagir com o editor Android. O editor Android oferece suporte a todos os atalhos e mapeamentos de teclas usuais.
Ao interagir com teclado e mouse, você pode diminuir o tamanho da barra de rolagem usando a configuração do editor interface/touchscreen/increase_scrollbar_touch_area <https://docs.godotengine.org/en/stable/classes/class_editorsettings.html#class-editorsettings-property-interface-touchscreen-increase-scrollbar-touch-area>.
Para projetos 2D, o plugin de block coding pode fornecer uma alternativa visual baseada em blocos para compor scripts quando não houver um teclado de hardware conectado.

Multi-tasking

Em dispositivos menores, habilitar e usar o modo picture-in-picture (PiP) permite transitar facilmente entre o Editor e a Janela de reprodução.
- O PiP pode ser ativado através da configuração do editor run/window_placement/play_window_pip_mode <https://docs.godotengine.org/en/latest/classes/class_editorsettings.html#class-editorsettings-property-run-window-placement-play-window-pip-mode>.
- A configuração do editor run/window_placement/android_window pode ser usada para especificar se a janela Play deve sempre ser iniciada no modo PiP.
- Observação: No modo PiP, a janela Play não tem acesso de entrada.

Projects sync

A sincronização de projetos via Git pode ser feita baixando um cliente Git para Android. Recomendamos o Termux terminal, um emulador de terminal para Android que fornece acesso a utilitários comuns de terminal, como Git e SSH.
- Nota: Para usar o Git com o terminal Termux, você precisará conceder permissão de ESCRITA ao terminal. Isso pode ser feito executando o seguinte comando dentro do terminal: termux-setup-storage

Plugins

Os plugins GDExtension funcionam conforme o esperado, mas exigem que o desenvolvedor do plugin forneça binários nativos do Android.

Aqui estão as limitações e problemas conhecidos do editor Android:

Sem suporte a C#/Mono.
Sem suporte para editores de script externos.
While available, the Forward+ renderer is not recommended due to severe performance issues.
UX not optimized for Android phones form-factor.
Dispositivos Android Go falta a permissão Acceso a todos os arquivos necessários para o acesso de leitura/gravação do dispositivo. Como solução alternativa, ao usar um dispositivo Android Go, recomenda-se criar novos projetos apenas nos diretórios Android Documents ou Downloads.
The editor doesn't properly resume when Don't keep activities is enabled in the Developer Options.
Há um bug com o teclado da Samsung que causa a inserção aleatória de entradas ao escrever scripts. Recomenda-se usar o teclado do Google (Gboard) em vez disso.

Ver também