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

Usando o editor Android

Em 2023, adicionamos uma versão para Android do editor que pode ser usada para criar, desenvolver e exportar projetos 2D e 3D em dispositivos Android.

O aplicativo pode ser baixado na página de download do Godot ou na Google Play Store.

Nota

O editor para Android está em acesso antecipado enquanto continuamos a refinar a experiência. Veja Limitações e problemas conhecidos abaixo.

Suporte de dispositivos Android

O editor Android requer dispositivos executando Android 5 Lollipop ou superior, com suporte mínimo a OpenGL 3. Isso inclui (lista não exaustiva):

• Tablets Android, dobrável e grandes telefones

• Netbooks com Android

• Chromebooks com suporte a aplicativos Android

Permissões de execução

• Permissão de acesso a todos os arquivos: Permite ao editor criar, importar e ler arquivos de projeto em qualquer local do dispositivo. Sem essa permissão, o editor continua funcional, mas com acesso limitado aos arquivos e diretórios do dispositivo.

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

Dicas e truques

Input (Entrada)

• 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 reduzir o tamanho da barra de rolagem usando a configuração do editor 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.

Multitarefa

• 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 habilitado por meio da configuração do editor 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.

Sincronização de projetos

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

Limitações e problemas conhecidos

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

• Sem suporte a C#/Mono.

• Sem suporte para editores de script externos.

• Enquanto disponível, o renderizador Forward+ não é recomendado devido a problemas graves de desempenho.

• Experiência de Usuário(UX) não otimizada para o formato de telefones Android.

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

• O editor não retoma corretamente quando Não mantenha atividades está habilitado nas Opções do desenvolvedor.

• 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

Consulte a lista de problemas abertos no GitHub relacionados ao editor Android para ver os bugs conhecidos.