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.

---

1. 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!)*.

---

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

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

---

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

1. 1. 1. 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 ```

---

1. 1. 1. 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!*

---

1. 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 ```

---

1. 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 ```

---

1. 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).*

---

1. 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!**

---

1. Relacionados

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