sevenx_engine 0.2.11

Engine de jogos 2D/3D completa com suporte Android, física, áudio, partículas, tilemap, UI, eventos e sistema 3D avançado com PBR.
Documentation
# 🚀 Setup Automático - Sem Precisar do Nome de Usuário!


## ⚡ Método Mais Fácil (Recomendado)


### 1️⃣ Configurar Automaticamente


Abra o PowerShell como **Administrador** e execute:

```powershell
.\configurar-android.ps1
```

Este script vai:
- ✅ Encontrar automaticamente o Android SDK
- ✅ Encontrar automaticamente o NDK
- ✅ Configurar todas as variáveis de ambiente
- ✅ Atualizar o PATH

**Não precisa saber o nome de usuário!** O script detecta tudo sozinho.

---

### 2️⃣ Fechar e Abrir o Terminal


**IMPORTANTE**: Feche o PowerShell e abra novamente!

---

### 3️⃣ Instalar Ferramentas Rust


No PowerShell (normal, não precisa ser admin):

```bash
cargo install cargo-apk
```

Aguarde instalar (2-3 minutos).

Depois:

```bash
rustup target add aarch64-linux-android
```

---

### 4️⃣ Verificar Se Está Tudo OK


```powershell
.\verificar-setup.ps1
```

Se aparecer "TUDO PRONTO!", pode prosseguir!

---

### 5️⃣ Conectar 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 via USB
6. Aceite a permissão

---

### 6️⃣ Testar Conexão


```bash
adb devices
```

Deve aparecer seu celular.

---

### 7️⃣ COMPILAR! 🎮


```bash
.\build-android.ps1
```

**Pronto!** O app vai abrir no celular!

---

## 🐛 Se o Script Não Encontrar o Android SDK


### Opção A: Informar Manualmente


O script vai perguntar o caminho. Você pode encontrar assim:

1. Abra o Android Studio
2. Vá em: **File → Settings** (ou **Configure → Settings**)
3. Procure por: **Appearance & Behavior → System Settings → Android SDK**
4. Copie o caminho que aparece em "Android SDK Location"
5. Cole no script quando pedir

### Opção B: Procurar Manualmente


Abra o Explorador de Arquivos e procure em:

```
C:\Users\[QUALQUER_NOME]\AppData\Local\Android\Sdk
```

Ou:

```
%LOCALAPPDATA%\Android\Sdk
```

Cole esse caminho no script quando pedir.

---

## 📊 Verificar Caminhos Atuais


Para ver onde está o Android SDK no seu PC:

```powershell
# Ver ANDROID_HOME atual

echo $env:ANDROID_HOME

# Ver ANDROID_NDK_HOME atual

echo $env:ANDROID_NDK_HOME

# Procurar Android SDK

dir "$env:LOCALAPPDATA\Android" -Recurse -Depth 1 2>$null | Where-Object { $_.Name -eq "Sdk" }
```

---

## ✅ Resumo Ultra-Rápido


```powershell
# 1. Configurar (PowerShell como Admin)

.\configurar-android.ps1

# 2. Fechar e abrir terminal


# 3. Instalar ferramentas

cargo install cargo-apk
rustup target add aarch64-linux-android

# 4. Verificar

.\verificar-setup.ps1

# 5. Conectar celular


# 6. Testar

adb devices

# 7. COMPILAR!

.\build-android.ps1
```

---

## 💡 Vantagens do Script Automático


- ✅ Não precisa saber o nome de usuário
- ✅ Detecta automaticamente os caminhos
- ✅ Encontra a versão mais recente do NDK
- ✅ Configura tudo de uma vez
- ✅ Atualiza o PATH automaticamente
- ✅ Mostra resumo da configuração

---

## 🎯 Se Tudo Der Certo


Você vai ver:

```
✅ Configuração concluída!

📋 Resumo da Configuração:

   ANDROID_HOME:
   C:\Users\...\AppData\Local\Android\Sdk

   ANDROID_NDK_HOME:
   C:\Users\...\AppData\Local\Android\Sdk\ndk\25.2.9519653

⚠️  IMPORTANTE:
   Feche e abra o PowerShell/CMD para as mudanças terem efeito!
```

---

## 🔧 Troubleshooting


### "Acesso negado"

- Execute o PowerShell como **Administrador**

### "Android SDK não encontrado"

- Verifique se o Android Studio está instalado
- Ou informe o caminho manualmente quando o script pedir

### "NDK não encontrado"

- Abra o Android Studio
- **Tools → SDK Manager → SDK Tools**
- Marque **NDK (Side by side)**
- Clique em **Apply**
- Execute o script novamente

---

**Muito mais fácil, né? 😄🚀**