# ⚡ Comandos Para Executar - Na Ordem
## 🎯 Você Já Tem Android Studio!
Então é só seguir estes passos:
---
## 1️⃣ Verificar o Setup Atual
Abra o PowerShell e execute:
```powershell
.\verificar-setup.ps1
```
Isso vai mostrar o que está faltando.
---
## 2️⃣ Configurar Variáveis de Ambiente
**Abra o PowerShell como ADMINISTRADOR** e cole:
```powershell
$usuario = $env:USERNAME
[System.Environment]::SetEnvironmentVariable('ANDROID_HOME', "C:\Users\$usuario\AppData\Local\Android\Sdk", 'User')
[System.Environment]::SetEnvironmentVariable('ANDROID_NDK_HOME', "C:\Users\$usuario\AppData\Local\Android\Sdk\ndk\25.2.9519653", 'User')
$path = [System.Environment]::GetEnvironmentVariable('Path', 'User')
$androidHome = [System.Environment]::GetEnvironmentVariable('ANDROID_HOME', 'User')
[System.Environment]::SetEnvironmentVariable('Path', "$path;$androidHome\platform-tools", 'User')
Write-Host "✅ Configurado! Feche e abra o terminal." -ForegroundColor Green
```
**IMPORTANTE**: Feche e abra o PowerShell depois!
---
## 3️⃣ Instalar Ferramentas Rust
Abra o PowerShell (normal, não precisa ser admin) e execute:
```bash
cargo install cargo-apk
```
Aguarde instalar (pode demorar uns 2-3 minutos).
Depois:
```bash
rustup target add aarch64-linux-android
```
---
## 4️⃣ Verificar NDK no Android Studio
1. Abra o Android Studio
2. Vá em: **Tools → SDK Manager**
3. Clique na aba **SDK Tools**
4. Procure: **NDK (Side by side)**
5. Se não estiver marcado, marque e clique em **Apply**
---
## 5️⃣ Preparar o Celular
1. No celular: **Configurações → Sobre o telefone**
2. Toque **7 vezes** em "Número da versão"
3. Volte e entre em **Opções do desenvolvedor**
4. Ative **Depuração USB**
5. Conecte o celular no PC via USB
6. Aceite a permissão no celular
---
## 6️⃣ Testar Conexão
No PowerShell:
```bash
adb devices
```
Deve aparecer:
```
List of devices attached
ABC123XYZ device
```
Se aparecer "unauthorized", desconecte e reconecte o celular.
---
## 7️⃣ COMPILAR E TESTAR! 🎮
```bash
.\build-android.ps1
```
**Pronto!** O app vai:
1. Compilar (primeira vez demora ~5 minutos)
2. Instalar no celular
3. Abrir automaticamente
---
## 🎯 Resumo dos Comandos
```powershell
# 1. Verificar setup
.\verificar-setup.ps1
# 2. Configurar variáveis (PowerShell como Admin)
# (Cole o script do passo 2)
# 3. Fechar e abrir terminal
# 4. Instalar ferramentas
cargo install cargo-apk
rustup target add aarch64-linux-android
# 5. Verificar NDK no Android Studio
# 6. Conectar celular
# 7. Testar conexão
adb devices
# 8. COMPILAR!
.\build-android.ps1
```
---
## 🐛 Se Der Erro
### "adb not found"
```bash
# Feche e abra o terminal
```
### "NDK not found"
```bash
# Verifique a versão do NDK instalado:
dir "C:\Users\SEU_USUARIO\AppData\Local\Android\Sdk\ndk"
# Se for diferente de 25.2.9519653, ajuste no passo 2
```
### "device unauthorized"
```bash
# Desconecte o celular
# No celular: Opções do desenvolvedor → Revogar autorizações USB
# Reconecte e aceite novamente
```
### Compilação falha
```bash
# Tente em modo debug (mais rápido)
.\build-android.ps1 -debug
```
---
## 📱 Depois de Compilar
Você vai ver no celular:
- 🟢 Quadrado verde (player)
- 🕹️ Joystick virtual (canto inferior esquerdo)
- 🔵 Botão azul (canto inferior direito)
- 📊 FPS, bateria, etc.
**Teste:**
- Mova o joystick → quadrado se move
- Toque no botão azul → vibra
- Toque em qualquer lugar → círculo amarelo
---
## 🎮 Outros Exemplos
```bash
# Jogo de tiro completo
.\build-android.ps1 -example mobile_shooter
# Demo avançado (gestos, etc)
.\build-android.ps1 -example android_advanced_demo
# Demo completo
.\build-android.ps1 -example android_demo
```
---
## ✅ Checklist
- [ ] Executei `.\verificar-setup.ps1`
- [ ] Configurei variáveis de ambiente (PowerShell como Admin)
- [ ] Fechei e abri o terminal
- [ ] Instalei cargo-apk
- [ ] Adicionei target Android
- [ ] Verifiquei NDK no Android Studio
- [ ] Conectei o celular
- [ ] `adb devices` mostra meu celular
- [ ] Executei `.\build-android.ps1`
- [ ] App abriu no celular!
---
**É só isso! Boa sorte! 🚀📱**