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

Exportar um jogo Godot 4 para Android não e difícil, mas falha de uma forma especifica e previsível para quase todo mundo na primeira vez: um conflito de versão entre três componentes de software separados que precisam estar em sincronia. Quando você entende quais são esses três componentes e os alinha, a exportação em si e apenas alguns cliques.

Este guia percorre todo o caminho, de um jogo finalizado até um arquivo assinado que você pode instalar em um telefone ou enviar para o Google Play. Assume-se que você já tem um jogo que deseja publicar. Se ainda estiver construindo um, o Summer Engine cria projetos reais compatíveis com Godot 4, o que significa que os passos de exportação abaixo se aplicam a um projeto Summer exatamente como se aplicam a qualquer projeto Godot feito a mão. O plano gratuito cobre a exportação sem marca d'água e sem participação na receita.

O que quebra a maioria dos primeiros exports

A exportação para Android no Godot depende de três coisas em sincronia:

1. A versão do seu editor Godot (por exemplo, 4.5.1)
2. Os templates de exportação que você instala (precisam ser da mesma versão)
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 você instala os templates 4.5, ou aponta o Godot para o JDK 21 em vez do 17, a exportação fica acinzentada, lança um erro cryptico do Gradle ou gera um APK que não instala. Resolva esses três pontos antes de mexer em qualquer outra coisa e você evita a maior parte dos problemas que as pessoas enfrentam.

A ordem das operações importa. Instale os templates e o toolchain primeiro, configure a exportação em seguida e compile por último.

Passo 1: Instale os templates de exportação 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 versão exata do editor.

As pessoas pulam isso porque o menu de exportação parece que deveria funcionar direto. Não funciona. Os templates são o runtime específico da plataforma empacotado com o seu jogo, e sem o template Android o preset não tem nada para compilar. Em um build beta ou release-candidate do Godot, talvez seja necessário baixar o arquivo de template manualmente e usar Install from File, já que o downloader automático conhece apenas versões estáveis.

Passo 2: Instale o JDK e o Android SDK

O Godot não incluí o toolchain Android. Você o instala uma vez na sua máquina e o Godot reutiliza para todos os projetos.

Você precisa de duas coisas:

• Um JDK, versão 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 distribuição gratuita e confiável.
• As ferramentas de linha de comando do Android SDK. O caminho mais simples e instalar o Android Studio, que incluí o SDK, as ferramentas de plataforma e as ferramentas de build. Se não quiser a IDE completa, você pode instalar apenas as ferramentas de linha de comando, mas o Android Studio e o caminho de menor resistência para um primeiro export.

Após a instalação, anote dois caminhos de pasta: onde o JDK esta instalado e onde o Android SDK esta instalado. Você vai colar ambos no Godot no próximo 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 seção 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 válida esses caminhos conforme você digita. Se um caminho estiver errado, você recebe um aviso vermelho ali mesmo, o que e muito mais fácil de corrigir agora do que depurar como uma exportação com falha depois.

Essa configuração e global para a sua instalação do Godot, não por projeto, então você só precisa fazer isso uma vez por máquina.

Passo 4: Crie o preset de exportação Android

Agora a exportação em si. Va em Project, depois Export. Clique em Add e escolha Android.

Você provavelmente vera um ícone 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 você resolve a seguir.

Nas opções do preset, as configurações mais importantes para um primeiro build:

• Unique Name (o identificador do pacote, como com.seuestudio.seujogo). Esse nome precisa ser único na Play Store, então use um nome de domínio 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. Você 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. Você pode desativar armeabi-v7a a menos que tenha como alvo telefones muito antigos.

Passo 5: Instale o template de build Android

No preset Android há um botão: Install Android Build Template. Clique nele.

Isso cópia um projeto Gradle para a pasta do seu jogo (um diretório android/build). O Godot usa isso para montar o pacote. Você precisa dele para builds personalizados, para adicionar plugins depois, e ele e obrigatório 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 saída na parte inferior da janela do Godot; o erro real esta la, não no popup.

Passo 6: Configure a assinatura (o keystore)

O Android não instala um aplicativo não assinado, então mesmo um build de teste precisa de um keystore. Há dois casos.

Para testes no seu próprio dispositivo (debug keystore):

O Godot pode usar um debug keystore gerado automaticamente. Em Editor, depois Editor Settings, depois Export, depois Android, há campos para um debug keystore, usuário e senha. O Godot pode criar o debug keystore para você, e as credenciais de depuração padrão são bem conhecidas (o usuário do keystore e androiddebugkey). Isso e suficiente para instalar em hardware que você controla. Nunca distribua publicamente um build assinado com debug.

Para lançamento (seu próprio keystore):

Quando estiver pronto para distribuir, gere um keystore de lançamento. Você 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 exportação Android, expanda a seção Keystore e preencha o caminho do keystore de lançamento, o alias e as senhas.

Crítico: faça backup desse arquivo keystore e das suas senhas em algum lugar seguro. Se você publicar no Google Play com esse keystore e depois perda-lo, nunca mais podera enviar uma atualização para esse aplicativo sob a mesma identidade. Esse e o único erro no mobile que e genuinamente irrecuperavel, então 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 saída.

• Export Project com um nome de arquivo .apk gera um arquivo instalável único. Copie-o para um telefone e toque nele (talvez seja necessário permitir instalações de fontes desconhecidas), ou instale via USB. E o que você usa para testes e para distribuição 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 rápido no dispositivo, o caminho mais rápido e o deploy com um clique: conecte seu telefone via USB com USB debugging ativado, e um pequeno ícone Android aparece no canto superior direito do editor Godot. Clique nele e o Godot compila, instala e lança o jogo no dispositivo conectado em uma ação, com o depurador remoto anexado para que você 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 versão do template não corresponde a versão do seu editor. Reinstale os templates para a versão exata.
• "No valid Java SDK" ou "JDK not found": O caminho do Passo 3 esta errado, ou você 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 saída do Godot, não o popup. Na maioria das vezes e um conflito de versão do JDK, um download bloqueado ou um nome de pacote com caracteres invalidos (use domínio reverso em minúsculas, sem espaços 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 você já tem uma versão com assinatura diferente do mesmo pacote instalada. Desinstale a versão antiga primeiro.
• O jogo roda mas os controles não respondem: Seu mapa de entradas pressupõe um teclado. Mobile precisa de entrada por toque, que cobrimos a seguir.

O que a exportação não resolve: jogar com os dedos

Exportar e mecânico. O problema mobile mais difícil e que um jogo construído para teclado e mouse não e jogável em uma tela sensível ao toque, e nenhuma configuração de exportação resolve isso. Você precisa de:

• Controles de toque na tela. Um joystick virtual, botões de toque para ação ou entrada por gestos, dependendo do gênero.
• Escalonamento de tela que sobrevive a muitas proporções 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 não seja cortada ou deslocada.
• Áreas de toque maiores. Botões dimensionados para um cursor de mouse são pequenos demais para um polegar.

E aqui que um fluxo de trabalho com IA nativa poupa tempo real. No Summer você descreve a mudança em linguagem simples, como adicionar um joystick virtual para movimento e um botão de disparo no canto inferior direito, e fazer o HUD escalar para a tela, e ele edita o projeto real. Como a saída e um projeto padrão compatível com Godot 4, os controles de toque que ele adiciona são nos Godot normais que você pode abrir e ajustar manualmente. Comece um projeto otimizado para mobile na galeria de templates e adapte-o.

Se você 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 início ao fim. Ambos geram projetos que seguem exatamente os passos de exportação acima.

Gratuito versus pago, honestamente

Tudo neste guia e gratuito. O toolchain Godot (editor, templates, JDK, SDK) não custa nada. Compilar e exportar um APK ou AAB Android pelo Summer esta no plano gratuito, sem marca d'água e sem participação na receita; você só paga por mais uso de IA em projetos maiores, e você pode ver os limites na página de preços. O único custo fora do seu controle e a conta de desenvolvedor do Google Play, que custa 25 dólares uma única vez, e apenas se você quiser estar na Play Store. Instalar um APK diretamente no seu telefone, ou distribuir no itch.io, e gratuito.

Após o Android: o resto do lançamento

Um build Android assinado e uma plataforma. Se você também esta mirando no desktop, Publique Seu Jogo na Steam explica o lado da Steam, que tem seu próprio processo baseado em taxa mas sem assinatura. A boa notícia e que o Godot 4 padrão exporta para Windows, macOS, Linux, web e Android pelo mesmo menu Project, depois Export, então quando você tiver feito o Android, os outros seguem o mesmo fluxo com um preset diferente. No Summer, a exportação para desktop cobre Windows e macOS, e a exportação para a web cobre projetos GDScript, que você pode publicar no Summer Games.

Alinhe as três versões, instale o template de build, assine o build e você tera um jogo rodando em um telefone real. Para ir de uma ideia a esse projeto exportável sem escrever o código repetitivo você mesmo, comece no criador de jogos com IA ou pegue o aplicativo desktop na página de download.