sevenx_engine 0.2.11

# 🚀 SevenX Engine - Android Quick Start


## Você tem múltiplos dispositivos conectados!


Quando você tem mais de um dispositivo/emulador Android conectado, use nossos scripts automatizados:

## 📱 Instalação Rápida


```powershell
# 1. Instalar APK (escolhe dispositivo automaticamente)

.\install-android.ps1

# 2. Ver logs em tempo real

.\android-logs.ps1
```

## 🔧 Ou use comandos manuais


### Listar dispositivos


```powershell
adb devices
```

Saída exemplo:
```
List of devices attached
RF8N70ABCDE    device
emulator-5554  device
```

### Instalar em dispositivo específico


```powershell
# Substitua RF8N70ABCDE pelo ID do seu dispositivo

adb -s RF8N70ABCDE install target\aarch64-linux-android\release\examples\android_test.apk
```

### Ver logs de dispositivo específico


```powershell
adb -s RF8N70ABCDE logcat | Select-String "SevenX"
```

## 🎯 Workflow Completo


### 1. Build


```powershell
.\build-android-complete.ps1
```

Escolha:
- `1` - android_test (exemplo básico)
- `2` - android_complete (demo completa)
- `3` - Ambos

### 2. Instalar


```powershell
.\install-android.ps1
```

O script irá:
- ✅ Detectar todos os dispositivos
- ✅ Mostrar informações (modelo, Android version)
- ✅ Deixar você escolher qual usar
- ✅ Desinstalar versão antiga automaticamente
- ✅ Instalar e iniciar o app

### 3. Monitorar


```powershell
.\android-logs.ps1
```

Mostra logs em tempo real com cores:
- 🔴 Erros e panics
- 🟡 Warnings
- 🔵 Logs do SevenX
- ⚪ Outros logs relevantes

## 📋 Comandos Úteis


### Desinstalar app


```powershell
adb -s DEVICE_ID uninstall com.sevenx.engine
```

### Reiniciar app


```powershell
adb -s DEVICE_ID shell am start -n com.sevenx.engine/.MainActivity
```

### Forçar parar app


```powershell
adb -s DEVICE_ID shell am force-stop com.sevenx.engine
```

### Limpar dados do app


```powershell
adb -s DEVICE_ID shell pm clear com.sevenx.engine
```

### Capturar screenshot


```powershell
adb -s DEVICE_ID shell screencap -p /sdcard/screenshot.png
adb -s DEVICE_ID pull /sdcard/screenshot.png
```

### Gravar vídeo


```powershell
# Iniciar gravação (Ctrl+C para parar)

adb -s DEVICE_ID shell screenrecord /sdcard/demo.mp4

# Baixar vídeo

adb -s DEVICE_ID pull /sdcard/demo.mp4
```

## 🐛 Troubleshooting


### Dispositivo não aparece


```powershell
# Reiniciar servidor ADB

adb kill-server
adb start-server
adb devices
```

### Dispositivo "unauthorized"


1. Desconecte o cabo USB
2. No dispositivo: Configurações → Opções do desenvolvedor → Revogar autorizações de depuração USB
3. Reconecte o cabo
4. Autorize no dispositivo quando aparecer o popup

### Erro "INSTALL_FAILED_UPDATE_INCOMPATIBLE"


```powershell
# Desinstale completamente

adb -s DEVICE_ID uninstall com.sevenx.engine

# Reinstale

.\install-android.ps1
```

### App não inicia


```powershell
# Verifique se instalou corretamente

adb -s DEVICE_ID shell pm list packages | Select-String "sevenx"

# Tente iniciar manualmente

adb -s DEVICE_ID shell am start -n com.sevenx.engine/.MainActivity

# Veja os erros

adb -s DEVICE_ID logcat | Select-String "AndroidRuntime"
```

## 🎮 Testando no Dispositivo


### android_test (Básico)


- Use touch para mover
- Toque nos coins para coletar
- Veja FPS e score

### android_complete (Completo)


Teste todos os recursos:

1. **Touch**: Toque na tela
2. **Gestos**: 
   - Tap simples
   - Double tap
   - Long press
   - Swipe (cima/baixo/esquerda/direita)
   - Pinch (zoom)
   - Rotate (dois dedos)
3. **Joystick**: Use o joystick virtual no canto inferior esquerdo
4. **Sensores**: Sacuda o dispositivo
5. **Bateria**: Veja o nível de bateria
6. **Conectividade**: Veja tipo de conexão (WiFi/Mobile)

## 📊 Performance


### Monitorar FPS


O FPS é mostrado na tela. Esperado:
- ✅ 60 FPS - Ótimo
- ⚠️ 30-60 FPS - Bom
- ❌ < 30 FPS - Ruim (ative power save mode)

### Monitorar Bateria


```powershell
# Ver consumo de bateria

adb -s DEVICE_ID shell dumpsys battery

# Ver temperatura

adb -s DEVICE_ID shell dumpsys battery | Select-String "temperature"
```

### Monitorar Memória


```powershell
adb -s DEVICE_ID shell dumpsys meminfo com.sevenx.engine
```

## 🔄 Workflow de Desenvolvimento


```powershell
# 1. Fazer mudanças no código

# 2. Build

.\build-android-complete.ps1

# 3. Instalar

.\install-android.ps1

# 4. Monitorar logs (em outro terminal)

.\android-logs.ps1

# 5. Testar no dispositivo

# 6. Repetir

```

## 💡 Dicas


### Use emulador para testes rápidos


```powershell
# Iniciar emulador

emulator -avd Pixel_6_API_33

# Instalar

.\install-android.ps1
```

### Teste em múltiplos dispositivos


```powershell
# Terminal 1: Dispositivo físico

adb -s RF8N70ABCDE install app.apk

# Terminal 2: Emulador

adb -s emulator-5554 install app.apk
```

### Automatize testes


Crie um script `test-all-devices.ps1`:

```powershell
$devices = adb devices | Select-String "device$" | ForEach-Object {
    $_.ToString().Split()[0]
}

foreach ($device in $devices) {
    Write-Host "Testando em $device..."
    adb -s $device install -r app.apk
    adb -s $device shell am start -n com.sevenx.engine/.MainActivity
    Start-Sleep -Seconds 5
}
```

## 📚 Próximos Passos


1. ✅ Instale e teste os exemplos
2. 📖 Leia o [Guia Completo](./ANDROID_COMPLETE_GUIDE.md)
3. 🎮 Crie seu próprio jogo
4. 📱 Teste em dispositivos reais
5. 🚀 Publique na Play Store!

## 🆘 Precisa de Ajuda?


- 📖 [Guia Completo Android](./ANDROID_COMPLETE_GUIDE.md)
- 📖 [README Android](./README_ANDROID.md)
- 🐛 [GitHub Issues](https://github.com/sevenx777-dev/SevenX-Engine/issues)

---

**Agora você está pronto para desenvolver jogos Android com SevenX Engine!** 🚀