Editing User:Ph744915 (section)

= 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: [https://adoptium.net/pt-BR/temurin/releases?version=17 Download Adoptium Temurin JDK 17]
# Selecione e baixe o instalador no formato '''<code>.msi</code>''' (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:''' <code>JAVA_HOME</code>
#* '''Valor da variável:''' <code>C:\Program Files\Eclipse Adoptium\jdk-17.0.20.101-hotspot</code> ''(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: <code>%JAVA_HOME%\bin</code>
# 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:

<pre>
Set-ExecutionPolicy RemoteSigned -Scope CurrentUser -Force
</pre>

==== 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:

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

<blockquote>''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!''</blockquote>

----

== 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 (<code>cd caminho/do/projeto</code>) e rode:

<pre>
npx expo install expo-dev-client
</pre>

----

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

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

<pre>
npx expo install --fix -- --legacy-peer-deps
</pre>

----

== 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 <code>/android</code>):

<pre>
npx expo prebuild --clean
</pre>
''(Se o terminal perguntar pelo <code>package name</code>, 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:

<pre>
npx expo run:android
</pre>

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!'''