Como Exportar Seu Jogo para Android no Godot 4 (Guia Completo 2026)

Exportar um jogo Godot 4 para Android nao e dificil, mas falha de uma forma especifica e previsivel para quase todo mundo na primeira vez: um conflito de versao entre tres componentes de software separados que precisam estar em sincronia. Quando voce entende quais sao esses tres componentes e os alinha, a exportacao em si e apenas alguns cliques.

Este guia percorre todo o caminho, de um jogo finalizado ate um arquivo assinado que voce pode instalar em um telefone ou enviar para o Google Play. Assume-se que voce ja tem um jogo que deseja publicar. Se ainda estiver construindo um, o Summer Engine cria projetos reais compativeis com Godot 4, o que significa que os passos de exportacao abaixo se aplicam a um projeto Summer exatamente como se aplicam a qualquer projeto Godot feito a mao. O plano gratuito cobre a exportacao sem marca d'agua e sem participacao na receita.

O que quebra a maioria dos primeiros exports

A exportacao para Android no Godot depende de tres coisas em sincronia:

1. A versao do seu editor Godot (por exemplo, 4.5.1)
2. Os templates de exportacao que voce instala (precisam ser da mesma versao)
3. O JDK que o Godot usa para compilar o pacote Android (JDK 17 para Godot 4.x)

Se o seu editor e 4.5.1, mas voce instala os templates 4.5, ou aponta o Godot para o JDK 21 em vez do 17, a exportacao fica acinzentada, lanca um erro cryptico do Gradle ou gera um APK que nao instala. Resolva esses tres pontos antes de mexer em qualquer outra coisa e voce evita a maior parte dos problemas que as pessoas enfrentam.

A ordem das operacoes importa. Instale os templates e o toolchain primeiro, configure a exportacao em seguida e compile por ultimo.

Passo 1: Instale os templates de exportacao correspondentes

Abra seu projeto no Godot. Va em Editor, depois Manage Export Templates. Se o painel disser que nenhum template esta instalado, clique em Download and Install. O Godot baixa os templates para a sua versao exata do editor.

As pessoas pulam isso porque o menu de exportacao parece que deveria funcionar direto. Nao funciona. Os templates sao o runtime especifico da plataforma empacotado com o seu jogo, e sem o template Android o preset nao tem nada para compilar. Em um build beta ou release-candidate do Godot, talvez seja necessario baixar o arquivo de template manualmente e usar Install from File, ja que o downloader automatico conhece apenas versoes estaveis.

Passo 2: Instale o JDK e o Android SDK

O Godot nao inclui o toolchain Android. Voce o instala uma vez na sua maquina e o Godot reutiliza para todos os projetos.

Voce precisa de duas coisas:

• Um JDK, versao 17. Os builds Android com Gradle para o Godot atual exigem o JDK 17 especificamente. Um JDK mais novo, como o 21, costuma falhar. O Temurin (Eclipse Adoptium) e uma distribuicao gratuita e confiavel.
• As ferramentas de linha de comando do Android SDK. O caminho mais simples e instalar o Android Studio, que inclui o SDK, as ferramentas de plataforma e as ferramentas de build. Se nao quiser a IDE completa, voce pode instalar apenas as ferramentas de linha de comando, mas o Android Studio e o caminho de menor resistencia para um primeiro export.

Apos a instalacao, anote dois caminhos de pasta: onde o JDK esta instalado e onde o Android SDK esta instalado. Voce vai colar ambos no Godot no proximo passo.

{/* IMAGE: Android Studio SDK Manager showing installed platform-tools and build-tools, with the SDK location path highlighted. Screenshot, 1200x675. */}

Passo 3: Aponte o Godot para o toolchain

De volta ao Godot, va em Editor, depois Editor Settings, e encontre a secao Export, depois Android na barra lateral esquerda.

Preencha:

• Java SDK Path (ou JDK path): a pasta do JDK 17 do Passo 2
• Android SDK Path: a pasta do SDK do Passo 2

O Godot valida esses caminhos conforme voce digita. Se um caminho estiver errado, voce recebe um aviso vermelho ali mesmo, o que e muito mais facil de corrigir agora do que depurar como uma exportacao com falha depois.

Essa configuracao e global para a sua instalacao do Godot, nao por projeto, entao voce so precisa fazer isso uma vez por maquina.

Passo 4: Crie o preset de exportacao Android

Agora a exportacao em si. Va em Project, depois Export. Clique em Add e escolha Android.

Voce provavelmente vera um icone de erro vermelho no topo do preset. Isso e esperado nessa etapa e indica o que ainda esta faltando. Passe o mouse sobre ele para ler a mensagem. Geralmente aponta para o template de build ou o keystore, que voce resolve a seguir.

Nas opcoes do preset, as configuracoes mais importantes para um primeiro build:

• Unique Name (o identificador do pacote, como com.seuestudio.seujogo). Esse nome precisa ser unico na Play Store, entao use um nome de dominio reverso real mesmo para testes.
• Renderer. Defina seu projeto com o renderizador Mobile para telefones modernos, ou Compatibility para o maior suporte de dispositivos, incluindo hardware mais antigo. Voce define isso em Project Settings em Rendering, e e o principal motivo pelo qual um jogo roda no editor mas exibe uma tela preta no telefone.
• Architectures. Deixe arm64-v8a ativada; ela cobre praticamente todos os dispositivos Android modernos. Voce pode desativar armeabi-v7a a menos que tenha como alvo telefones muito antigos.

Passo 5: Instale o template de build Android

No preset Android ha um botao: Install Android Build Template. Clique nele.

Isso copia um projeto Gradle para a pasta do seu jogo (um diretorio android/build). O Godot usa isso para montar o pacote. Voce precisa dele para builds personalizados, para adicionar plugins depois, e ele e obrigatorio para o formato AAB que o Google Play exige.

Se essa etapa der erro, quase sempre e o caminho do JDK ou do SDK do Passo 3, ou um download do Gradle bloqueado por um firewall. Leia o painel de saida na parte inferior da janela do Godot; o erro real esta la, nao no popup.

Passo 6: Configure a assinatura (o keystore)

O Android nao instala um aplicativo nao assinado, entao mesmo um build de teste precisa de um keystore. Ha dois casos.

Para testes no seu proprio dispositivo (debug keystore):

O Godot pode usar um debug keystore gerado automaticamente. Em Editor, depois Editor Settings, depois Export, depois Android, ha campos para um debug keystore, usuario e senha. O Godot pode criar o debug keystore para voce, e as credenciais de depuracao padrao sao bem conhecidas (o usuario do keystore e androiddebugkey). Isso e suficiente para instalar em hardware que voce controla. Nunca distribua publicamente um build assinado com debug.

Para lancamento (seu proprio keystore):

Quando estiver pronto para distribuir, gere um keystore de lancamento. Voce pode fazer isso em um terminal com o comando keytool que vem com o seu JDK:

keytool -genkey -v -keystore release.keystore -alias mygame -keyalg RSA -keysize 2048 -validity 10000

Ele solicita uma senha e alguns dados de identidade. Em seguida, no preset de exportacao Android, expanda a secao Keystore e preencha o caminho do keystore de lancamento, o alias e as senhas.

Critico: faca backup desse arquivo keystore e das suas senhas em algum lugar seguro. Se voce publicar no Google Play com esse keystore e depois perda-lo, nunca mais podera enviar uma atualizacao para esse aplicativo sob a mesma identidade. Esse e o unico erro no mobile que e genuinamente irrecuperavel, entao trate o arquivo como uma senha.

Passo 7: Exporte

Com o template de build instalado e a assinatura configurada, o erro vermelho no preset deve ter desaparecido. Agora escolha sua saida.

• Export Project com um nome de arquivo .apk gera um arquivo instalavel unico. Copie-o para um telefone e toque nele (talvez seja necessario permitir instalacoes de fontes desconhecidas), ou instale via USB. E o que voce usa para testes e para distribuicao fora da loja, como no itch.io.
• Export Project com um nome de arquivo .aab gera um Android App Bundle para a Google Play Store. O Google Play aceita apenas AAB para novos aplicativos.

Para um teste rapido no dispositivo, o caminho mais rapido e o deploy com um clique: conecte seu telefone via USB com USB debugging ativado, e um pequeno icone Android aparece no canto superior direito do editor Godot. Clique nele e o Godot compila, instala e lanca o jogo no dispositivo conectado em uma acao, com o depurador remoto anexado para que voce possa ler os erros em tempo real.

{/* IMAGE: Godot editor toolbar showing the one-click Android deploy button (small Android robot icon) lit up with a connected device. Screenshot, 800x400. */}

Erros comuns e o que eles realmente significam

• Erro vermelho no preset, "Export templates not found": Passo 1, a versao do template nao corresponde a versao do seu editor. Reinstale os templates para a versao exata.
• "No valid Java SDK" ou "JDK not found": O caminho do Passo 3 esta errado, ou voce instalou um JDK diferente do 17. Instale o JDK 17 e aponte novamente.
• O build do Gradle falha com um longo stack trace: Leia o painel de saida do Godot, nao o popup. Na maioria das vezes e um conflito de versao do JDK, um download bloqueado ou um nome de pacote com caracteres invalidos (use dominio reverso em minusculas, sem espacos ou hifens no identificador).
• Instala mas tela preta ao iniciar: Renderizador errado para o dispositivo (mude para Mobile ou Compatibility) ou texturas grandes demais para a GPU mobile. Rode via USB com o depurador remoto para ler o log do Android.
• "App not installed" no telefone: Geralmente um problema de assinatura, ou voce ja tem uma versao com assinatura diferente do mesmo pacote instalada. Desinstale a versao antiga primeiro.
• O jogo roda mas os controles nao respondem: Seu mapa de entradas pressupoe um teclado. Mobile precisa de entrada por toque, que cobrimos a seguir.

O que a exportacao nao resolve: jogar com os dedos

Exportar e mecanico. O problema mobile mais dificil e que um jogo construido para teclado e mouse nao e jogavel em uma tela sensivel ao toque, e nenhuma configuracao de exportacao resolve isso. Voce precisa de:

• Controles de toque na tela. Um joystick virtual, botoes de toque para acao ou entrada por gestos, dependendo do genero.
• Escalonamento de tela que sobrevive a muitas proporcoes de aspecto. Os telefones variam de alto e estreito a tablets largos. Defina um modo de esticamento (canvas_items, keep aspect) para que sua interface nao seja cortada ou deslocada.
• Areas de toque maiores. Botoes dimensionados para um cursor de mouse sao pequenos demais para um polegar.

E aqui que um fluxo de trabalho com IA nativa poupa tempo real. No Summer voce descreve a mudanca em linguagem simples, como adicionar um joystick virtual para movimento e um botao de disparo no canto inferior direito, e fazer o HUD escalar para a tela, e ele edita o projeto real. Como a saida e um projeto padrao compativel com Godot 4, os controles de toque que ele adiciona sao nos Godot normais que voce pode abrir e ajustar manualmente. Comece um projeto otimizado para mobile na galeria de templates e adapte-o.

Se voce esta construindo o jogo do zero, Como Fazer um Jogo com IA cobre o ciclo de desenvolvimento, e Como Fazer um Jogo 2D com IA mergulha fundo em um pequeno projeto do inicio ao fim. Ambos geram projetos que seguem exatamente os passos de exportacao acima.

Gratuito versus pago, honestamente

Tudo neste guia e gratuito. O toolchain Godot (editor, templates, JDK, SDK) nao custa nada. Compilar e exportar um APK ou AAB Android pelo Summer esta no plano gratuito, sem marca d'agua e sem participacao na receita; voce so paga por mais uso de IA em projetos maiores, e voce pode ver os limites na pagina de precos. O unico custo fora do seu controle e a conta de desenvolvedor do Google Play, que custa 25 dolares uma unica vez, e apenas se voce quiser estar na Play Store. Instalar um APK diretamente no seu telefone, ou distribuir no itch.io, e gratuito.

Apos o Android: o resto do lancamento

Um build Android assinado e uma plataforma. Se voce tambem esta mirando no desktop, Publique Seu Jogo na Steam explica o lado da Steam, que tem seu proprio processo baseado em taxa mas sem assinatura. A boa noticia e que um projeto compativel com Godot 4 exporta para Windows, macOS, Linux, web e Android pelo mesmo menu Project, depois Export, entao quando voce tiver feito o Android, os outros seguem o mesmo fluxo com um preset diferente.

Alinhe as tres versoes, instale o template de build, assine o build e voce tera um jogo rodando em um telefone real. Para ir de uma ideia a esse projeto exportavel sem escrever o codigo repetitivo voce mesmo, comece no criador de jogos com IA ou pegue o aplicativo desktop na pagina de download.