Como Exportar Jogo Godot para Android: SDK, Keystore, APK e AAB

Exportar Godot para Android é uma daquelas tarefas que parece simples no menu e vira uma tarde inteira de erro vermelho na primeira vez. Não porque o Godot complica, mas porque o build Android depende de coisas que vivem fora da engine: JDK, Android SDK, keystore de assinatura. Se qualquer uma estiver faltando ou apontando pro lugar errado, o export falha com mensagens que não ajudam muito.

A boa notícia: a configuração é chata uma única vez. Depois que o ambiente está montado, exportar vira dois cliques, e testar no celular vira um clique só. Esse tutorial cobre o caminho completo no Godot 4.x: instalar as dependências, configurar os caminhos no editor, gerar o APK de teste, assinar com keystore de release e produzir o AAB que a Google Play exige.

O que você precisa instalar antes

O Godot não compila o pacote Android sozinho. Ele orquestra ferramentas do ecossistema Android, e são três peças:

JDK 17. O Godot 4 pede OpenJDK 17. Versões mais novas podem dar incompatibilidade com o build, então não pegue a última só porque é a última. O Adoptium (Eclipse Temurin) é a fonte que eu uso: instalador direto, sem conta, sem enrolação.

Android SDK. Dois caminhos:

• Android Studio (recomendado pra quem está começando): instala o SDK, o platform-tools (que inclui o adb) e gerencia atualizações por interface gráfica. Ocupa mais disco, mas elimina uma classe inteira de erros de caminho.
• Command-line tools: só o necessário, configurado na mão via sdkmanager. Mais leve, mais propenso a erro de quem nunca fez.

Se foi pelo Android Studio, abra ele uma vez e deixe terminar o setup inicial, é nesse primeiro boot que o SDK é baixado de fato.

Export templates do Godot. São os binários pré-compilados da engine pra cada plataforma. No editor: Editor > Manage Export Templates > Download and Install. Baixe a versão que bate exatamente com a sua versão do Godot. Template de 4.3 não funciona em editor 4.4.

Apontando os caminhos no editor

Com tudo instalado, o Godot precisa saber onde as coisas estão. Em Editor > Editor Settings > Export > Android, preencha:

• Java SDK Path: a pasta raiz do JDK 17 (algo como C:\Program Files\Eclipse Adoptium\jdk-17... no Windows)
• Android SDK Path: a raiz do SDK (no Windows costuma ser C:\Users\seu_usuario\AppData\Local\Android\Sdk)

Esses dois campos são a causa número um de export quebrado. Se o erro mencionar jarsigner, apksigner ou "could not find", volte aqui e confira se os caminhos apontam pra raiz certa, não pra uma subpasta.

Keystore: a assinatura do seu jogo

Todo pacote Android precisa ser assinado digitalmente. A assinatura prova que o app veio de você, e é ela que permite atualizar o jogo depois: a Play Store só aceita update assinado com a mesma chave do original. Existem duas keystores na sua vida:

Debug keystore. Serve só pra testar no seu aparelho. O Godot gera uma automaticamente se o campo estiver vazio nas configurações do editor, então pra teste local você não precisa fazer nada.

Release keystore. Essa é a chave de publicação, e essa você cria uma vez e guarda pra sempre. O comando usa o keytool, que vem junto com o JDK:

keytool -genkeypair -v -keystore meu-jogo-release.keystore -alias meujogo -keyalg RSA -keysize 2048 -validity 10000

Ele vai pedir uma senha e alguns dados (nome, organização, país). O -validity 10000 define a validade em dias, uns 27 anos, o que na prática significa "não vence".

Agora o aviso sério, e eu repito porque já vi gente perder isso: se você perder a release keystore ou a senha, não existe recuperação. Não tem "esqueci minha senha". Sem a chave, você não atualiza mais o app na loja com aquele pacote. Faça backup do arquivo .keystore em pelo menos dois lugares (um deles fora do seu PC) e anote a senha num gerenciador de senhas. A assinatura por app da Play Store ameniza esse risco pra quem publica lá, mas a chave de upload continua sendo sua responsabilidade.

Exportar Godot para Android: criando o preset

Com ambiente e keystore prontos, vem a parte do Godot. Em Project > Export, clique em Add... e escolha Android. O preset tem muita opção, mas as que importam de verdade são poucas:

Package > Unique Name. O identificador do app no formato de domínio invertido: com.seuestudio.nomedojogo. Tem que ser único na Play Store e não pode mudar nunca depois de publicado. Escolha com calma. Use só letras minúsculas, números e pontos, e não comece segmento com número.

Version > Code e Name. O version code é um inteiro que tem que crescer a cada upload na loja (1, 2, 3...). O version name é o texto que o jogador vê ("1.0.2"). A loja só liga pro code.

Keystore. Na seção Keystore do preset, aponte o arquivo de release, o alias e a senha que você criou no passo anterior. O debug pode ficar em branco que o Godot resolve.

Permissões. Marque só o que o jogo usa de verdade. Jogo offline sem anúncio geralmente não precisa de permissão nenhuma marcada na mão (acesso à internet o Godot gerencia conforme as features). Permissão sobrando levanta bandeira na revisão da loja e desconfiança no jogador.

Renderer e compressão de textura

Duas decisões de projeto afetam direto o build mobile:

• Renderer: o renderer Mobile é otimizado pra GPU de celular. O Compatibility (OpenGL) roda em aparelhos mais antigos e fracos. O Forward+ é pensado pra desktop; em Android ele funciona em hardware recente, mas pra maioria dos jogos mobile o Mobile ou o Compatibility é a escolha certa. Isso se define em Project Settings > Rendering > Renderer.
• Compressão de textura: GPUs de celular usam formatos próprios (ETC2/ASTC). O preset de export já cuida disso, mas saiba que é por isso que o primeiro export demora mais: o Godot está recomprimindo as texturas pro formato mobile.

APK ou AAB: qual gerar e quando

Os dois formatos saem do mesmo preset, e cada um tem um papel:

APK é o pacote instalável direto. É o que você usa pra testar no seu aparelho, mandar pra amigos testarem, ou distribuir fora da Play Store (itch.io, site próprio). Instala com um toque no arquivo ou via adb.

AAB (Android App Bundle) é o formato que a Google Play exige pra apps novos desde 2021. Você não instala um AAB diretamente: você sobe ele pra loja, e a Play gera APKs otimizados pra cada aparelho (só as texturas e arquiteturas que aquele dispositivo precisa). Resultado: download menor pro jogador.

A regra prática: APK pra testar, AAB pra publicar na Play Store.

Pra gerar o AAB, o Godot precisa do build via Gradle. Dois passos:

1. Project > Install Android Build Template: instala o projeto Gradle dentro de res://android/. Faça isso uma vez por projeto (e refaça quando atualizar a versão do Godot).
2. No preset de export, ligue Gradle Build > Use Gradle Build e mude o Export Format pra AAB.

O primeiro build Gradle demora porque baixa dependências. Os seguintes são bem mais rápidos. Pra APK simples de teste, você nem precisa do Gradle: o export direto resolve.

Com tudo configurado, Export Project gera o arquivo. Se aparecer erro, leia a mensagem de baixo pra cima: a causa real costuma estar nas últimas linhas, e quase sempre é caminho de SDK/JDK errado ou keystore com senha incorreta.

Testar no celular: do arquivo ao one-click deploy

Jogo mobile se testa em celular de verdade, e de preferência num aparelho mediano ou fraco, não no seu flagship. O que roda liso num celular de R$ 4.000 pode engasgar feio num de R$ 800, e o de R$ 800 é onde está a maior parte dos jogadores.

Preparando o aparelho

1. Ative o modo desenvolvedor: em Configurações > Sobre o telefone, toque sete vezes em "Número da versão" (ou "Número de compilação", varia por fabricante).
2. Nas opções de desenvolvedor que apareceram, ative Depuração USB.
3. Conecte o cabo no PC e aceite o aviso de autorização que aparece na tela do celular.

Confirme que o PC enxerga o aparelho:

adb devices

Se o aparelho aparecer na lista como device, está pronto. Se aparecer unauthorized, olhe a tela do celular: o popup de autorização está esperando você aceitar.

Instalando o APK na mão

adb install -r meu-jogo.apk

O -r reinstala por cima mantendo os dados, útil quando você está iterando.

One-click deploy: o jeito bom

Aqui está o motivo de configurar tudo isso direito. Com o aparelho conectado e o preset Android criado, aparece um ícone de Android na barra superior do editor. Um clique: o Godot exporta uma build de debug, instala no celular e roda. Com Deploy with Remote Debug ativo (no menu de debug do editor), os print() e os erros do jogo rodando no celular aparecem no Output do editor, no seu PC. Pra iterar em jogo mobile, isso muda o jogo: o ciclo "mudei o código, testei no aparelho" cai pra menos de um minuto.

O botão voltar do Android

Um detalhe que todo jogo Android precisa tratar: o botão/gesto de voltar. Por padrão o Godot fecha o app quando ele é acionado (controlado por application/config/quit_on_go_back nas Project Settings). Se você quiser interceptar pra abrir um menu de pause em vez de fechar:

func _notification(what):
    if what == NOTIFICATION_WM_GO_BACK_REQUEST:
        # Disparado pelo botão/gesto de voltar no Android.
        abrir_menu_pause()

Desligue o quit_on_go_back nas Project Settings pra notificação chegar sem o app fechar. Jogo que fecha sem avisar no primeiro toque em voltar é desinstalação garantida.

Checklist antes de subir pra Play Store

Publicar é assunto pra outro artigo (conta de desenvolvedor da Google Play custa USD 25, taxa única, mais o processo de ficha da loja e revisão). Mas o pacote que sai do Godot já precisa estar redondo:

• AAB gerado com Gradle Build ligado e assinado com a release keystore
• version code maior que o do upload anterior
• Package name definitivo (lembra: não muda nunca)
• Ícones e splash configurados no preset (a loja rejeita ícone padrão da engine)
• Testado em pelo menos um aparelho físico, de preferência dois com desempenho bem diferente
• Backup da keystore feito e senha guardada

Fechando

O export Android do Godot tem duas fases com naturezas opostas: a configuração do ambiente, que é burocrática e só precisa acontecer uma vez, e o ciclo de export e teste, que depois disso fica genuinamente rápido. Quem desiste, desiste na primeira fase, geralmente por um caminho de SDK errado.

Então o conselho prático é: monte o ambiente num momento em que você não está com pressa, valide com o one-click deploy no celular, e guarde a keystore como se fosse documento. Feito isso, colocar seu jogo rodando na mão de alguém deixa de ser obstáculo e vira rotina. E ver seu jogo rodando no celular de outra pessoa pela primeira vez é um dos melhores momentos de quem desenvolve.