Instalar o Godot e configurar projetos para Android

Este guia inclui as seguintes etapas:

  • Como selecionar uma versão do Godot
  • Como fazer o download e a instalação do Godot
  • Como configurar o Godot para desenvolvimento no Android
  • Como configurar o sistema para desenvolvimento e exportação em C# (versão Mono do Godot apenas)

Selecionar uma versão

Use a versão estável mais recente do Godot quando possível. Para desenvolvimento em Android, use a versão 3.3 ou mais recente.

Fazer o download do Godot e executá-lo

Acesse a página de download do Godot para fazer o download do mecanismo do jogo para seu ambiente preferido.

O Godot oferece duas versões na página de download: padrão e Mono. As duas podem ser usadas no desenvolvimento para Android. A versão Mono é necessária para o desenvolvimento em C#.

O Godot é distribuído como um aplicativo independente. Não é necessário um processo de instalação. Depois de extrair o arquivo de download, execute-o sem mudar nada.

Configurar a compatibilidade com o Android

Definir as configurações do SDK do Android Studio

  1. Faça o download da versão estável mais recente do Android Studio e instale-a, caso ainda não tenha feito isso.
  2. Inicie o Android Studio.
  3. Na janela de boas-vindas do Android Studio, abra o menu suspenso Configure e selecione SDK Manager.
  4. Na parte superior da janela, anote o Android SDK Location no seu computador. Você precisará especificar esse local no editor do Godot.
  5. Na guia SDK Platforms, localize a entrada da lista para Android 11.0 R. Se o item estiver desmarcado, marque-o.
  6. Na guia SDK Tools, localize os itens da lista para NDK (Side by side), Android SDK Command-line Tools e CMake. Marque-os se não estiverem marcados.
  7. Se o status de qualquer item da lista estiver definido como Update Available, ative a caixa de seleção para atualizar para a versão mais recente.
  8. Clique no botão OK. Confirme o download e aceite os termos de licença para concluir a instalação.

Criar um keystore de depuração

Os apps Android precisam ser assinados digitalmente para serem executados em um dispositivo. Em testes locais, um arquivo keystore de depuração pode ser usado para assinar apps. O Android Studio criará automaticamente um keystore de depuração padrão. Se você já tiver criado apps usando uma configuração de depuração com o Android Studio, um arquivo debug.keystore estará localizado no seguinte diretório:

  • Microsoft Windows: C:\Users\$username\.android\debug.keystore
  • Linux/macOS: ~\.android\debug.keystore

Se o arquivo debug.keystore não existir, crie um executando as seguintes etapas:

  1. Inicie o Android Studio.
  2. Na janela "Welcome to Android Studio", selecione a opção Import an Android Code Sample.
  3. Selecione o exemplo Ndk -> Hello GL2 na lista e clique no botão Next.
  4. Escolha um local para o projeto e clique no botão Finish.
  5. Aguarde o carregamento e a sincronização do projeto com o Gradle e selecione Build -> Make Project na barra de menus do Android Studio.
  6. Aguarde a conclusão do build e verifique se um arquivo debug.keystore foi criado no diretório adequado.

Definir o SDK do Android e depurar o local do keystore no editor do Godot

  1. Inicie o editor do Godot.
  2. Crie ou abra um projeto.
  3. Selecione Editor -> Editor Settings... na barra de menus do Editor.
  4. Na janela Editor Settings, selecione o item Export -> Android no painel à esquerda.
  5. No painel à direita, vá para a caixa de texto de Android Sdk Path e insira o caminho para o Android SDK.
  6. Na caixa de texto de Debug Keystore, digite o caminho para o arquivo debug.keystore.
Configuração de caminho do SDK do Android nas configurações do editor do Godot
Figura 1. O campo Android Sdk Path em Editor Settings

Configurar Mono

Instalar o MSBuild

A versão Mono do Godot requer que o MSBuild crie e exporte projetos que usam C#. Para instalar o MSBuild:

Linux e macOS

Microsoft Windows

Configurar um editor de C#

O Godot tem compatibilidade muito limitada para edição de código C#. É altamente recomendável usar um editor externo para arquivos C#. O Godot é compatível com os seguintes editores em C#:

  • Microsoft Visual Studio/Visual Studio para Mac
  • Microsoft Visual Studio Code
  • JetBrains Rider
  • MonoDevelop

Para configurar um editor externo em C#, abra um projeto no editor do Godot e execute as seguintes etapas:

  1. Selecione Editor -> Editor Settings… na barra de menus do editor.
  2. Na janela Editor Settings, selecione o item Mono -> Editor no painel à esquerda.
  3. Escolha o editor no menu suspenso External Editor.
Configuração de editor externo nas configurações do editor do Godot
Figura 2: o campo External Editor em Editor Settings

Plug-ins do editor de C# para Godot

  • Ferramentas C# para Godot (link em inglês): um plug-in para o Microsoft Visual Studio Code que inclui compatibilidade com depuração de C# e recursos de conclusão de código parcial.
  • Plug-in JetBrains Rider (link em inglês): adiciona compatibilidade com depuração de C#.