User:Ph744915: Difference between revisions
Created page with "# 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 Admin..." |
No edit summary |
||
| Line 1: | Line 1: | ||
= 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 | 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. | 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: | 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: | 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 | 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: | 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:NODE_TLS_REJECT_UNAUTHORIZED = "0" | ||
$env:JAVA_TOOL_OPTIONS = "-Djavax.net.ssl.trustStoreType=WINDOWS-ROOT -Djavax.net.ssl.trustStore=NONE" | $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. | 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 ( | No terminal, navegue até a pasta do seu projeto (<code>cd caminho/do/projeto</code>) e rode: | ||
<pre> | |||
npx expo install expo-dev-client | npx expo install expo-dev-client | ||
</pre> | |||
--- | ---- | ||
== Passo 4: Corrigir Versões e Incompatibilidades (Fix) == | |||
Se o seu | 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 | 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 | 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 | 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 | 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: | Invoque o poder máximo: | ||
<pre> | |||
npx expo run:android | 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. | 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!''' | |||
Latest revision as of 21:47, 25 August 2026
Guia do Recruta: Criando a Primeira Build Nativa do Projeto (Expo Prebuild)
[edit]“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)
[edit]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
[edit]Parte A: Variáveis de Ambiente no Windows (Interface Gráfica)
[edit]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!)
- Nome da variável:
- 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)
[edit]1. Liberação do PowerShell (Executar APENAS UMA VEZ na sua jornada):
[edit]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):
[edit]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
[edit]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)
[edit]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)
[edit]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)
[edit]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!