Editing User:Ph744915

# 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.

1. Acesse o portal da Tropa: [Download Adoptium Temurin JDK 17](https://adoptium.net/pt-BR/temurin/releases?version=17)
2. Selecione e baixe o instalador no formato **`.msi`** (versão Windows x64).
3. 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:

1. No menu iniciar do Windows, pesquise por: **"Editar variáveis de ambiente para sua conta"** e abra.
2. 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!)*
3. 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`
4. 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:

```powershell
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:

```powershell
$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:

```powershell
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:

```powershell
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`):

```powershell
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:

```powershell
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!**

---

## Relacionados

- [Home](Home)
- [Build local do APK React Native](Build-Local-ReactNativeMobile)
- [Configurações do VS Code](Configurações-vscode)
- [Git](Git)