254 lines
8.3 KiB
Markdown
254 lines
8.3 KiB
Markdown
<!-- file: deltas/0.3.3/0-pre.3.md -->
|
|
<!-- version: 1 -->
|
|
|
|
# Delta 0.3.3-0-pre.3
|
|
|
|
## Base et statut précédent
|
|
|
|
Cette tranche part exclusivement de `0.3.3-0-pre.2`, validé par l'utilisateur le 2026-09-21. `history/0.3.3/0-pre.2.md` enregistre la gate complète, le build Gradle réussi et l'APK Snake ARM64 inspecté.
|
|
|
|
Aucun fix de `0-pre.2` n'est requis.
|
|
|
|
## Objectif
|
|
|
|
Cette tranche traite ensemble les deux décisions prévues avant l'AAB :
|
|
|
|
1. passer d'une version Gradle/JDK imposée pour la preuve à un contrat de minimum compatible avec l'environnement ;
|
|
2. élargir le pipeline Gradle/Cargo natif à `arm64-v8a + x86_64` et produire des APK Debug universal.
|
|
|
|
Snake reste le jeu-sonde principal. Reflex devient le second consommateur de la logique commune puisque sa migration ne demande qu'un mapping de feature et d'ABI, sans nouvelle architecture.
|
|
|
|
## Politique Gradle minimale
|
|
|
|
AGP `9.4.0` conserve Gradle `9.6.0` comme minimum. Le projet déclare désormais dans `Android/settings.gradle` :
|
|
|
|
```text
|
|
minimumGradleVersion = 9.6.0
|
|
```
|
|
|
|
Le script compare ce minimum à `GradleVersion.current()` et échoue explicitement si le Gradle système est trop ancien.
|
|
|
|
Le projet Android natif ne versionne plus de Gradle Wrapper. Une machine avec Gradle `9.6.0`, `9.7.1` ou une version ultérieure compatible utilise directement sa propre version. La version réellement employée est consignée par la gate avec :
|
|
|
|
```bash
|
|
(cd Android && gradle --version)
|
|
```
|
|
|
|
Cette décision concerne uniquement `Android/`. Les wrappers générés ou contraintes historiques propres au POC Tauri restent locaux à la crate Tauri et ne sont pas réinterprétés.
|
|
|
|
## Politique JDK
|
|
|
|
Aucun `export JAVA_HOME=/usr/lib/jvm/temurin-17-jdk-amd64` n'est imposé au chemin SDL3 natif.
|
|
|
|
Gradle/AGP utilisent le JDK fourni normalement par le shell ou l'IDE. Le minimum de la chaîne reste Java 17, tandis que la gate doit vérifier le JDK réellement sélectionné. Le JDK 25 installé dans l'environnement utilisateur est donc un candidat normal pour cette validation.
|
|
|
|
La glue Java Android conserve volontairement :
|
|
|
|
```text
|
|
sourceCompatibility = 17
|
|
targetCompatibility = 17
|
|
```
|
|
|
|
Le JDK de build et le niveau Java de l'application restent deux contrats distincts.
|
|
|
|
## Multi-ABI Snake
|
|
|
|
`game-snake-poc` déclare maintenant :
|
|
|
|
```text
|
|
feature snake
|
|
ABI arm64-v8a + x86_64
|
|
API Rust 21
|
|
```
|
|
|
|
et :
|
|
|
|
```text
|
|
abiFilters 'arm64-v8a', 'x86_64'
|
|
```
|
|
|
|
La logique commune `sasedev-rust-android.gradle`, déjà prouvée en mono-ABI, enregistre une tâche Rust par ABI et remet les deux répertoires `jniLibs` générés à AGP. L'APK Debug attendu est universal, sans split ABI par défaut.
|
|
|
|
## Reflex devient second consommateur
|
|
|
|
`game-reflex-poc` reçoit uniquement la configuration symétrique :
|
|
|
|
```text
|
|
feature reflex
|
|
ABI arm64-v8a + x86_64
|
|
API Rust 21
|
|
```
|
|
|
|
puis applique la même logique Gradle commune. Aucun nouveau script, type de tâche, bridge JNI ou chemin d'output n'est introduit.
|
|
|
|
Cette symétrie confirme que la factorisation appartient bien à `Android/gradle/sasedev-rust-android.gradle` et non aux modules de jeu.
|
|
|
|
## Suppression du wrapper natif
|
|
|
|
Un ZIP delta n'efface pas les fichiers d'un jalon précédent. Le manifest :
|
|
|
|
```text
|
|
deltas/0.3.3/0-pre.3.delete.txt
|
|
```
|
|
|
|
supprime :
|
|
|
|
```text
|
|
Android/gradlew
|
|
Android/gradlew.bat
|
|
Android/gradle/wrapper/gradle-wrapper.jar
|
|
Android/gradle/wrapper/gradle-wrapper.properties
|
|
```
|
|
|
|
Après extraction du delta à la racine du dépôt, appliquer :
|
|
|
|
```bash
|
|
while IFS= read -r path; do
|
|
rm -f -- "$path"
|
|
done < deltas/0.3.3/0-pre.3.delete.txt
|
|
rmdir --ignore-fail-on-non-empty Android/gradle/wrapper
|
|
```
|
|
|
|
L'audit de distribution traite désormais ces quatre fichiers comme interdits dans le projet Android natif afin d'éviter un retour involontaire à une version Gradle épinglée.
|
|
|
|
## Règles et documentation
|
|
|
|
Les règles de commandes Android utilisent désormais `gradle` depuis `Android/` et exigent le minimum déclaré par le projet. `CMD-051` devient :
|
|
|
|
```text
|
|
(cd Android && gradle :<app>:assembleDebug)
|
|
```
|
|
|
|
Le plan `0.3.3`, la documentation Android et le document de build natif distinguent explicitement :
|
|
|
|
- Gradle système `>= 9.6.0` ;
|
|
- JDK runtime fourni par l'environnement ;
|
|
- Java source/target 17 ;
|
|
- contraintes Tauri historiques séparées ;
|
|
- deux ABI natives productives de cette tranche.
|
|
|
|
## Fichiers
|
|
|
|
Ajoutés :
|
|
|
|
```text
|
|
deltas/0.3.3/0-pre.3.md
|
|
deltas/0.3.3/0-pre.3.delete.txt
|
|
history/0.3.3/0-pre.2.md
|
|
```
|
|
|
|
Modifiés :
|
|
|
|
```text
|
|
Android/README.md
|
|
Android/game-reflex-poc/build.gradle
|
|
Android/game-snake-poc/build.gradle
|
|
Android/settings.gradle
|
|
Cargo.toml
|
|
docs/development/006-ANDROID_RUST_NATIVE_BUILD.md
|
|
docs/plans/003-V0_3_3_ANDROID_NATIVE_MULTI_ABI_PLAN.md
|
|
docs/rules/RULES_COMMANDS.md
|
|
docs/rules/RULES_VALIDATION_MATRIX.md
|
|
scripts/audit_distribution_layout.py
|
|
```
|
|
|
|
Supprimés par manifest :
|
|
|
|
```text
|
|
Android/gradlew
|
|
Android/gradlew.bat
|
|
Android/gradle/wrapper/gradle-wrapper.jar
|
|
Android/gradle/wrapper/gradle-wrapper.properties
|
|
```
|
|
|
|
`scripts/build_android_rust.py`, le code Rust, les manifests Android, `CHANGELOG.md` et `ROADMAP.md` restent inchangés.
|
|
|
|
## Validations exécutées dans l'environnement de génération
|
|
|
|
Le générateur exécute uniquement les audits statiques autorisés après constitution du delta :
|
|
|
|
```bash
|
|
python3 scripts/audit_rust_workspace_rules.py
|
|
python3 scripts/audit_markdown_tables.py README.md RULES.md ROADMAP.md CHANGELOG.md docs prompts crates Android Web deltas history
|
|
python3 scripts/audit_distribution_layout.py
|
|
```
|
|
|
|
Aucun build Cargo/Gradle, test ou smoke final n'est attribué au générateur.
|
|
|
|
## Validation utilisateur demandée
|
|
|
|
Exécuter la gate depuis un shell normal, sans ajouter l'ancien `export JAVA_HOME=/usr/lib/jvm/temurin-17-jdk-amd64` :
|
|
|
|
```bash
|
|
java -version
|
|
printf 'JAVA_HOME=%s\nANDROID_HOME=%s\n' "$JAVA_HOME" "$ANDROID_HOME"
|
|
(cd Android && gradle --version)
|
|
|
|
cargo fmt --all
|
|
cargo fmt --all -- --check
|
|
|
|
python3 scripts/audit_rust_workspace_rules.py
|
|
python3 scripts/audit_markdown_tables.py README.md RULES.md ROADMAP.md CHANGELOG.md docs prompts crates Android Web deltas history
|
|
python3 scripts/audit_distribution_layout.py
|
|
|
|
cargo check --workspace
|
|
cargo clippy --workspace --all-targets --all-features -- -D warnings
|
|
|
|
(cd Android && gradle :game-snake-poc:assembleDebug)
|
|
(cd Android && gradle :game-reflex-poc:assembleDebug)
|
|
```
|
|
|
|
La sortie `gradle --version` doit montrer une version `>= 9.6.0` et le JDK effectivement fourni par votre environnement. Une version supérieure au minimum n'est pas une divergence.
|
|
|
|
## Inspection des APK universal
|
|
|
|
Pour chaque jeu :
|
|
|
|
```bash
|
|
for game in game-snake-poc game-reflex-poc; do
|
|
APK="$(find "Android/${game}/build/outputs/apk/debug" -maxdepth 1 -type f -name '*.apk' -print -quit)"
|
|
test -n "$APK"
|
|
printf 'APK=%s\n' "$APK"
|
|
unzip -Z1 "$APK" | grep '^lib/' | sort
|
|
|
|
for abi in arm64-v8a x86_64; do
|
|
unzip -Z1 "$APK" | grep -Fx "lib/${abi}/libSDL3.so"
|
|
unzip -Z1 "$APK" | grep -Fx "lib/${abi}/libgame_android_entrypoint.so"
|
|
done
|
|
|
|
if unzip -Z1 "$APK" | grep -Eq '^lib/(armeabi-v7a|x86)/'; then
|
|
printf '%s\n' "unexpected 32-bit native library in ${game} universal APK" >&2
|
|
exit 1
|
|
fi
|
|
done
|
|
```
|
|
|
|
L'absence de split est démontrée par un seul APK Debug par module contenant simultanément les bibliothèques ARM64 et x86_64.
|
|
|
|
## Smoke multi-architecture Snake
|
|
|
|
Après inspection mécanique, installer le même APK Snake sur l'AVD x86_64 puis sur l'appareil ARM64 réel.
|
|
|
|
AVD connu :
|
|
|
|
```bash
|
|
APK="Android/game-snake-poc/build/outputs/apk/debug/game-snake-poc-debug.apk"
|
|
adb -s emulator-5554 install -r "$APK"
|
|
adb -s emulator-5554 shell am start -n com.sasedev.games.snake/.SnakeActivity
|
|
```
|
|
|
|
Puis sur l'appareil réel en remplaçant `<arm64-serial>` par le serial affiché par `adb devices -l` :
|
|
|
|
```bash
|
|
adb -s <arm64-serial> install -r "$APK"
|
|
adb -s <arm64-serial> shell am start -n com.sasedev.games.snake/.SnakeActivity
|
|
```
|
|
|
|
Le smoke attendu est borné : lancement sans erreur de chargement JNI/SDL3 et affichage du jeu. La validation gameplay exhaustive reste hors de ce jalon.
|
|
|
|
## Suite après validation
|
|
|
|
Si cette gate est propre, `0-pre.4` ouvre le chemin AAB, la vérification 16 KB, la validation du plancher Android disponible et la fermeture de `scripts/build_android_rust.py` si aucune responsabilité n'y subsiste.
|
|
|
|
Toute erreur de minimum Gradle, exécution JDK, task wiring x86_64, linkage SDL3, packaging universal ou activation Reflex produit d'abord `0-pre.3.fix.1`.
|