Guia do Recruta: Criando a Primeira Build Nativa do Projeto (Expo Prebuild)

“No dia mais claro, na noite mais densa, nenhuma dependência quebrada escapará da minha presença!”

Seja bem-vindo ao setor 2814 do desenvolvimento mobile. Este guia foi forjado no centro da bateria verde de Oa para você transformar o seu projeto Expo Go em uma verdadeira Build Nativa (Development Build) e gerar o aplicativo no Android sem precisar de anel de acesso de Administrador no Windows.

Passo 1: Download e Instalação do Java (MSI)

Nem só de força de vontade se constrói um app. Precisamos do JDK 17 para alimentar os construtos do Gradle e do Kotlin.

Acesse o portal da Tropa: Download Adoptium Temurin JDK 17
Selecione e baixe o instalador no formato .msi (versão Windows x64).
Execute o instalador baixado e conclua a instalação padrão. (Relaxa, não precisa pedir permissão ao Guardião da TI!).

Passo 2: Configuração do Ambiente do Usuário

Parte A: Variáveis de Ambiente no Windows (Interface Gráfica)

Vamos gravar o caminho do Java na memória da sua máquina sem acionar o alarme do Guardião do Sistema:

No menu iniciar do Windows, pesquise por: "Editar variáveis de ambiente para sua conta" e abra.
Na seção Variáveis de usuário para [seu_nome], clique em Novo...:
- Nome da variável: JAVA_HOME
- Valor da variável: C:\Program Files\Eclipse Adoptium\jdk-17.0.20.101-hotspot (Ajuste o nome se os Guardiões atualizaram os números no final da pasta!)
Na mesma lista de variáveis de usuário, procure pela variável Path:
- Selecione a variável Path e clique em Editar....
- Clique em Novo e adicione: %JAVA_HOME%\bin
Clique em OK nas duas janelas para canalizar essa energia.

Parte B: Preparação do Terminal do VS Code (Rede / SSL)

1. Liberação do PowerShell (Executar APENAS UMA VEZ na sua jornada):

Abra o PowerShell dentro do VS Code e rode este comando para que o Windows pare de tratar seus scripts como vilões do Sinestro Corps:

Set-ExecutionPolicy RemoteSigned -Scope CurrentUser -Force

2. Comandos de Sessão (Executar SEMPRE que abrir o Terminal):

Toda vez que você abrir uma nova janela do terminal para rodar o projeto, precisará drenar o campo de força dos proxies e certificados da rede. Execute estas duas linhas de poder:

$env:NODE_TLS_REJECT_UNAUTHORIZED = "0"
$env:JAVA_TOOL_OPTIONS = "-Djavax.net.ssl.trustStoreType=WINDOWS-ROOT -Djavax.net.ssl.trustStore=NONE"

Se você esquecer de rodar esses dois comandos, a rede corporativa vai sugar a bateria do seu anel mais rápido que um Lanterna Amarelo no escuro!

Passo 3: Instalação do expo-dev-client

Chega de depender do app Expo Go! Vamos forjar nosso próprio cliente nativo sob medida.

No terminal, navegue até a pasta do seu projeto (cd caminho/do/projeto) e rode:

npx expo install expo-dev-client

Passo 4: Corrigir Versões e Incompatibilidades (Fix)

Se o seu package.json tiver versões brigando feito o Hal Jordan e o Guy Gardner, este comando vai colocar todo mundo em ordem de marcha:

npx expo install --fix -- --legacy-peer-deps

Passo 5: Gerar a Pasta Nativa (prebuild)

Hora da verdadeira materialização! Vamos usar a força de vontade para transformar o código em infraestrutura Android nativa (gerando a lendária pasta /android):

npx expo prebuild --clean

(Se o terminal perguntar pelo package name, dê Enter sem medo — confiamos no plano padrão dos Guardiões).

Passo 6: Pulo para alegria e Abraço Coletivo! (Rodar o App)

Verifique se o seu Emulador Android está ligado ou se o seu celular físico está plugado via cabo com a Depuração USB ativada.

Invoque o poder máximo:

npx expo run:android

O Expo vai compilar todo o código nativo Kotlin/Java, construir o construto do APK, instalar direto no dispositivo e acender a luz verde do servidor Metro.

Tudo funcionando de primeira! Abraço coletivo e missão cumprida, Lanterna!