## Objectif

Builder l'APK Android du **téléphone** GameTime de manière déterministe, sans
recalculer l'environnement de build à chaque fois.

## Usage obligatoire

Toujours lancer le script dédié depuis le project root :

```bash
bash .ideai/skills/scripts/build-phone-apk.sh debug
```

ou pour un build optimisé :

```bash
bash .ideai/skills/scripts/build-phone-apk.sh release
```

Par défaut, si aucun mode n'est donné, le script construit `debug`.

## Ce que le script fixe automatiquement

- copie un SDK Flutter writable dans `.ideai/build-env/flutter-sdk` si absent ;
- isole `HOME`, `XDG_*` et `GRADLE_USER_HOME` dans `.ideai/build-env` ;
- force **Java 21** via `/usr/lib/jvm/java-21-openjdk` ;
- configure `ANDROID_HOME=/opt/android-sdk` et le `PATH` Android/Java ;
- lance `flutter pub get` puis `flutter build apk`.

Ne pas utiliser `/usr/bin/flutter` ou `/opt/flutter/bin/flutter` directement tant
que l'environnement a les mêmes contraintes de sandbox/cache : le wrapper et les
caches système peuvent écrire dans des emplacements non utilisables.

## Sorties

- Debug : `build/app/outputs/flutter-apk/app-debug.apk`
- Release : `build/app/outputs/flutter-apk/app-release.apk`

Le script affiche le chemin final de l'APK.

## Quand l'utiliser

- Après tout changement mobile Android/Flutter côté téléphone.
- Avant une installation ADB sur le téléphone.
- Avant de livrer un APK au user.

## Diagnostic rapide

- `Unsupported class file major version 70` :
  `JAVA_HOME` n'est pas sur Java 21.
- `No space left on device` :
  manque d'espace dans le volume qui porte `.ideai/build-env`.
- erreurs de dépendances Flutter :
  relancer le même script, ne pas improviser une autre séquence.

## Règle d'exécution

Pour builder l'APK téléphone, ne pas réfléchir à la recette : exécuter le script
ci-dessus avec `debug` ou `release`, puis vérifier l'APK dans `build/app/outputs/flutter-apk/`.