# Notas: Execução do TatuChat em Emulador Android

Data: 2026-09-12

## Objetivo

Executar o projeto TatuChat (Flutter) em um emulador Android com janela visível.

## Ambiente

| Item | Valor |
|------|-------|
| OS | Linux (Freedesktop SDK 25.08, Flatpak runtime) |
| Flutter | 3.47.3 (Dart 3.13.3) |
| Android SDK | /home/welton/Android/Sdk (versão 37, emulator 37.1.11) |
| JDK | 17 (Temurin, via JAVA_HOME) |
| Imagem de sistema | android-36, google_apis, x86_64 |
| Sessão | Terminal integrado do VSCodium (sandbox Flatpak `com.vscodium.codium`) |

## Problemas encontrados e soluções

### 1. Nenhum AVD disponível inicialmente
Não havia AVDs criados. Imagem de sistema `android-36/google_apis/x86_64` já instalada.
- Criação: `avdmanager create avd -n tatuchat -k "system-images;android-36;google_apis;x86_64" -d pixel_7`
- **Atenção:** `avdmanager` (Java) criou o AVD em `~/.var/app/com.vscodium.codium/config/.android/avd/` (home do sandbox), diferente de `~/.android/avd` que o emulador espera. Corrigido copiando para `~/.android/avd` e ajustando o `path=` nos arquivos `.ini`.

### 2. Emulador não abre janela dentro do sandbox Flatpak
Erro original: `Could not load the Qt platform plugin "xcb"` — o Qt do emulador não tem plugin Wayland e não há display X11 dentro do sandbox.
- Solução 1 (provisória): rodar headless com `-no-window` e `QT_QPA_PLATFORM=offscreen`.
- Solução 2 (definitiva): rodar o emulador **na sessão do host** (onde `DISPLAY=:0` existe) via `flatpak-spawn --host`, destacando o processo com `setsid` para não ser morto com o terminal.

### 3. Bug no AndroidManifest que impedia o app de iniciar
O projeto é um fork do FluffyChat renomeado para TatuChat. O `namespace` e `applicationId` foram alterados para `chat.fluffy.tatuchat`, **mas**:
- `android/app/src/main/kotlin/chat/fluffy/fluffychat/MainActivity.kt` está no pacote `chat.fluffy.fluffychat`
- O manifest usava `android:name=".MainActivity"`, que resolvia para `chat.fluffy.tatuchat.MainActivity` (inexistente)

Resultado: crash na inicialização com `ClassNotFoundException: chat.fluffy.tatuchat.MainActivity`.

**Correção aplicada** em `android/app/src/main/AndroidManifest.xml:39`:
```xml
<!-- antes -->
android:name=".MainActivity"
<!-- depois -->
android:name="chat.fluffy.fluffychat.MainActivity"
```

Observação pendente: o `MainActivity.kt` (e o `FcmPushService.kt`, que está com código comentado) ainda vivem no pacote `chat.fluffy.fluffychat`. Uma limpeza futura deveria mover as classes para `chat.fluffy.tatuchat` e limpar as referências relativas do manifest (`.MainActivity`, `.FcmPushService` — este último aponta para classe que nem existe mais).

## Como rodar o emulador em janela visível

### Você (terminal normal do host)
```bash
# iniciar emulador com janela
~/Android/Sdk/emulator/emulator -avd tatuchat

# rodar o app em outro terminal
cd ~/Documentos/Projetos/tatuchat
flutter run -d emulator-5554
```

### Comandos equivalentes usados daqui (via flatpak-spawn)
```bash
# encerrar emulador anterior
adb emu kill

# copiar AVD para a pasta padrão (se ainda não foi feito)
mkdir -p ~/.android/avd
cp -r ~/.var/app/com.vscodium.codium/config/.android/avd/. ~/.android/avd/

# iniciar emulador na sessão do host (janela visível)
flatpak-spawn --host sh -c 'export HOME=/home/welton; unset QT_QPA_PLATFORM; export DISPLAY=:0; setsid /home/welton/Android/Sdk/emulator/emulator -avd tatuchat -gpu swiftshader_indirect -no-boot-anim > /tmp/emu_run.log 2>&1 < /dev/null & echo started'

# build + instalação manual (quando o hot reload da CLI falha no sandbox)
flutter build apk --debug
adb install -r build/app/outputs/flutter-apk/app-debug.apk
adb shell am start -n chat.fluffy.tatuchat/chat.fluffy.fluffychat.MainActivity
```

## Estado atual

- Emulador `tatuchat` rodando com janela na sessão do host (boot OK).
- App TatuChat instalado e em execução, foco em `chat.fluffy.tatuchat/chat.fluffy.fluffychat.MainActivity`.
- Build: `flutter build apk --debug` gera `build/app/outputs/flutter-apk/app-debug.apk`.

## Observações

- `flutter run -d emulator-5554` pode falhar com `Error waiting for a debug connection: The log reader stopped unexpectedly` ao rodar a partir do sandbox; nesse caso o APK é instalado normalmente e basta abrir via `adb shell am start`.
- O AVD usa imagem `android-36` (compileSdk do projeto é 37) — compatível para execução.
- Arquivos de log do emulador no host: `/tmp/emu_run.log`.