Atualizado em 12 de agosto de 2026

Uma das maiores dúvidas de quem começa a desenvolver aplicativos com React Native é:

Como transformar meu projeto em um APK para instalar no celular Android?

Com React Native, Expo e EAS Build, você pode gerar um APK utilizando a infraestrutura em nuvem do Expo, sem precisar realizar todo o processo de compilação manualmente pelo Android Studio.

Neste tutorial você aprenderá, passo a passo, como configurar o projeto, gerar o APK e instalar o aplicativo em um dispositivo Android.

Resposta rápida: como gerar APK no React Native com Expo?

Para gerar um APK utilizando Expo e EAS Build, primeiro configure seu projeto com:

eas build:configure

Depois, configure um profile para gerar APK no arquivo eas.json e execute:

eas build -p android --profile preview

O projeto será enviado para o EAS Build, a compilação será realizada na nuvem e, quando terminar, você poderá baixar o APK para instalar no Android.

---

Vídeo: Como gerar APK no React Native

Neste vídeo mostro todo o processo na prática, desde a configuração do projeto até a geração do APK.

---

O que é um APK?

APK significa Android Package Kit.

É um formato utilizado para distribuir e instalar aplicativos Android diretamente em dispositivos compatíveis.

Depois de gerar um APK, você pode utilizá-lo para:

• instalar seu aplicativo no próprio celular;
• testar o projeto em um dispositivo real;
• compartilhar versões de teste;
• distribuir internamente um aplicativo;
• apresentar projetos acadêmicos;
• instalar o aplicativo sem publicá-lo na Google Play.

Para quem está aprendendo React Native, gerar um APK é uma ótima maneira de transformar um projeto de desenvolvimento em um aplicativo que realmente pode ser instalado no celular.

---

APK x AAB: qual é a diferença?

Ao trabalhar com aplicativos Android, você provavelmente encontrará dois formatos:

APK

O APK pode ser instalado diretamente em dispositivos Android compatíveis.

É muito útil para:

• testes;
• projetos acadêmicos;
• protótipos;
• distribuição interna;
• instalação direta no celular.

AAB

AAB significa Android App Bundle.

É o formato utilizado para distribuição de novos aplicativos através da Google Play.

A partir do AAB, a Google Play gera os APKs otimizados necessários para os diferentes dispositivos.

Resumindo:

APK → instalar e testar diretamente no Android.

AAB → distribuição pela Google Play.

---

O que é o EAS Build?

EAS Build é um serviço do ecossistema Expo utilizado para gerar builds de aplicativos React Native.

Uma das grandes vantagens é que o processo pode ser realizado utilizando a infraestrutura em nuvem do Expo.

Seu computador envia o projeto para o serviço e o processo de build acontece nos servidores do EAS.

Isso facilita bastante a vida de quem está começando com desenvolvimento mobile.

---

O que preciso para gerar um APK?

Para acompanhar este tutorial você precisa basicamente de:

• um projeto React Native com Expo;
• Node.js instalado;
• uma conta no Expo;
• EAS CLI.

Se você ainda não possui uma conta no Expo, pode criar uma gratuitamente no site oficial.

Instalando o EAS CLI

No terminal, execute:

npm install --global eas-cli

Depois verifique a instalação:

eas --version

Outra possibilidade é utilizar o EAS CLI através do npx, sem instalação global.

---

Preciso instalar Java e Gradle?

Para o fluxo apresentado neste tutorial, utilizando o EAS Build na nuvem, você não precisa instalar Java e Gradle separadamente apenas para executar o build nos servidores do Expo.

Essas ferramentas fazem parte do ecossistema de desenvolvimento Android e podem ser necessárias em outros cenários, especialmente quando você trabalha com builds locais ou diretamente com o ambiente nativo Android.

Aqui nosso objetivo é justamente utilizar o EAS Build para simplificar o processo.

---

Preciso instalar Android Studio para gerar o APK?

Para o processo mostrado neste tutorial, não é necessário utilizar o Android Studio para realizar a compilação do APK, pois o build será executado na infraestrutura do EAS.

O Android Studio continua sendo uma ferramenta extremamente importante no desenvolvimento Android e pode ser necessário em outros fluxos, como uso de emuladores, desenvolvimento nativo ou determinadas configurações locais.

Mas para gerar nosso APK utilizando o EAS Build na nuvem, podemos seguir sem realizar a compilação pelo Android Studio.

---

Projeto utilizado no tutorial

No vídeo utilizamos um aplicativo desenvolvido com:

• React Native;
• Expo;
• TypeScript.

O projeto é simples porque o objetivo é concentrar a explicação no processo de geração do APK.

O mesmo conceito pode ser aplicado posteriormente em projetos maiores.

---

Como gerar APK no React Native com Expo: passo a passo

Agora vamos configurar o projeto para utilizar o EAS Build.

1. Fazer login na conta Expo

Abra o terminal dentro do projeto e execute:

eas login

Informe os dados da sua conta.

Para verificar qual usuário está conectado, você também pode executar:

eas whoami

---

2. Configurar o projeto para EAS Build

Dentro da pasta do projeto, execute:

eas build:configure

Esse comando prepara o projeto para utilizar o EAS Build e cria/configura o arquivo:

eas.json

Esse arquivo é responsável por armazenar os profiles utilizados durante os builds.

---

3. Configurar o eas.json para gerar APK

Por padrão, builds Android destinados à produção utilizam o formato AAB.

Como nosso objetivo é criar um APK instalável diretamente no Android, podemos configurar um profile específico no eas.json.

Exemplo:

{
  "build": {
    "preview": {
      "android": {
        "buildType": "apk"
      }
    },
    "production": {}
  }
}

Nesse exemplo criamos o profile:

preview

e informamos ao EAS que queremos gerar:

apk

Isso é importante porque estamos criando uma versão para instalação direta no dispositivo, e não um AAB destinado à Google Play.

---

4. Gerar o APK

Depois de configurar o projeto, execute:

eas build -p android --profile preview

Onde:

-p android

indica que queremos gerar um build para Android.

E:

--profile preview

indica que queremos utilizar o profile preview configurado no arquivo eas.json.

---

5. O que acontece depois do comando?

O EAS CLI prepara o projeto e inicia o processo de build.

A compilação acontece na infraestrutura do Expo.

Durante o processo, o terminal fornece informações sobre o build e um endereço para acompanhar o progresso.

O tempo necessário pode variar de acordo com o projeto, disponibilidade do serviço e plano utilizado.

Você não precisa deixar o terminal aberto durante todo o processamento: o build também pode ser acompanhado posteriormente pela sua conta Expo.

---

6. Como saber se o APK ficou pronto?

Você pode acompanhar seus builds pelo painel da sua conta Expo.

Também é possível consultar builds pelo terminal:

eas build:list

Quando o processo terminar, o build aparecerá como concluído.

---

7. Como baixar o APK?

Depois que o build for concluído:

1. acesse os detalhes do build;
2. localize a opção de instalação ou download;
3. baixe o APK;
4. transfira ou abra o arquivo no dispositivo Android;
5. faça a instalação.

Dependendo das configurações de segurança do Android, o sistema pode solicitar autorização para instalar aplicativos provenientes daquela fonte.

---

Posso compartilhar o APK com outras pessoas?

Sim.

Um APK gerado para distribuição interna pode ser utilizado para testes em dispositivos Android compatíveis.

Isso é muito útil para:

• mostrar um projeto para outra pessoa;
• entregar trabalhos acadêmicos;
• testar o aplicativo em diferentes aparelhos;
• disponibilizar versões de demonstração;
• validar um projeto antes da publicação oficial.

Para distribuição pública de aplicativos, entretanto, é importante estudar o processo adequado de publicação através da Google Play.

---

Como gerar AAB para publicar na Google Play?

Se seu objetivo não é simplesmente instalar o aplicativo, mas publicá-lo na Google Play, o processo é diferente.

O formato utilizado para novos aplicativos na loja é o AAB.

Um build de produção pode ser iniciado com:

eas build --platform android --profile production

Nesse caso, não utilize buildType: "apk" no profile destinado à publicação se seu objetivo for gerar o AAB padrão para envio à Google Play.

---

APK ou AAB: qual devo usar?

A escolha depende do seu objetivo.

Quero instalar o aplicativo diretamente no celular

Use APK.

Quero testar meu projeto em dispositivos Android

Use APK.

Quero compartilhar uma versão de teste

Um APK ou outro fluxo de distribuição interna do EAS pode ser adequado.

Quero publicar um novo aplicativo na Google Play

Use AAB.

---

Erro: o EAS gerou AAB em vez de APK

Se você esperava receber um APK e recebeu um arquivo .aab, verifique o profile utilizado no arquivo eas.json.

Para o exemplo deste tutorial, temos:

{
  "build": {
    "preview": {
      "android": {
        "buildType": "apk"
      }
    }
  }
}

E executamos:

eas build -p android --profile preview

O profile utilizado no comando precisa corresponder ao profile configurado para gerar APK.

---

Comandos utilizados neste tutorial

Instalar o EAS CLI:

npm install --global eas-cli

Fazer login:

eas login

Verificar usuário:

eas whoami

Configurar o projeto:

eas build:configure

Gerar APK:

eas build -p android --profile preview

Consultar builds:

eas build:list

---

O que você aprendeu

Neste tutorial você aprendeu:

• o que é APK;
• o que é AAB;
• a diferença entre APK e AAB;
• o que é EAS Build;
• como instalar o EAS CLI;
• como fazer login no Expo;
• como configurar o EAS Build;
• como configurar o eas.json;
• como gerar APK no React Native;
• como acompanhar o build;
• como baixar o APK;
• quando utilizar APK;
• quando utilizar AAB;
• como realizar o processo sem compilar manualmente pelo Android Studio.

---

Conclusão

Gerar um APK no React Native não precisa ser um processo complicado.

Utilizando Expo e EAS Build, podemos configurar o projeto, enviar o build para a infraestrutura do Expo e obter um APK pronto para instalação em dispositivos Android.

Para quem está aprendendo desenvolvimento mobile, isso permite sair do código rodando apenas durante o desenvolvimento e chegar a algo muito mais interessante:

um aplicativo que pode ser instalado no celular.

Esse é um passo importante para transformar exercícios em projetos reais.

Aqui no Desvendando o Código, o objetivo não é apenas decorar comandos.

É entender o que estamos fazendo, praticar e transformar conhecimento em projetos.

Eu não ensino programação.

Eu ajudo as pessoas a entenderem como a tecnologia funciona.

---