0.1.0-2-beta.1.fix.3

docs/development/007-ANDROID_JNI_BRIDGE.md

@@ -1,5 +1,5 @@
 <!-- file: docs/development/007-ANDROID_JNI_BRIDGE.md -->
-<!-- version: 1 -->
+<!-- version: 2 -->
 
 # Bridge Java/JNI Android
 
@@ -14,7 +14,7 @@ L'input tactile de base ne passe pas par JNI : SDL3 fournit directement les év
 La baseline expose un unique appel Java vers Rust :
 
 ```text
-NativeBridge.nativeContractVersion() -> 1
+NativeBridge.nativeContractVersion() -> 2
 ```
 
 `SaseGameActivity` vérifie ce contrat après `SDLActivity.onCreate()`.
@@ -45,3 +45,20 @@ L'export JNI utilise un symbole nommé explicitement et reçoit deux pointeurs o
 Aucun bloc `unsafe` ni fonction `unsafe` n'est autorisé.
 
 Si un futur service nécessite de manipuler réellement `JNIEnv`, il devra faire l'objet d'une tranche distincte avec une politique FFI réévaluée plutôt que d'élargir implicitement l'exception actuelle.
+
+## Back Android
+
+Le contrat v2 ajoute un pont Java/JNI explicite pour Back :
+
+```text
+SaseGameActivity
+-> NativeBridge.requestPlatformBack()
+-> nativeRequestPlatformBack()
+-> engine-v1-sdl::request_platform_back()
+-> EngineGame::quit_requested(QuitSource::PlatformBack)
+```
+
+Sur API 33+, `SaseGameActivity` enregistre un `OnBackInvokedCallback`.
+Sur les versions antérieures, `onBackPressed()` reste le fallback.
+
+Cette voie remplace la dépendance au mapping variable du bouton Back vers `SDL_SCANCODE_AC_BACK`.

docs/rules/RULES_PROJECT.md

@@ -1,5 +1,5 @@
 <!-- file: docs/rules/RULES_PROJECT.md -->
-<!-- version: 8 -->
+<!-- version: 9 -->
 
 # Règles spécifiques games.sasedev
 
@@ -72,3 +72,6 @@
 - **GAME-PLATFORM-013** — Les demandes de sortie Tauri sont évaluées par la politique `EngineGame::quit_requested` avant toute fermeture native.
 
 - **GAME-BUILD-001** — Les artefacts générés Cargo, Tauri, Vite et caches frontend sont placés hors de la racine du dépôt, sous `../builds/sasedev-games/`; un répertoire racine `builds/` dans le dépôt est interdit.
+
+- **GAME-PLATFORM-014** — Android API 33+ traite Back via `OnBackInvokedCallback`; le bridge Java/JNI doit convertir cette action en `QuitSource::PlatformBack` et laisser `EngineGame::quit_requested` décider.
+- **GAME-PLATFORM-015** — Les exécutables Android initialisent le subscriber partagé et envoient les événements `tracing` vers logcat ; `stderr` n'est pas la destination Android de référence.

docs/rules/RULES_RUST.md

@@ -1,5 +1,5 @@
 <!-- file: docs/rules/RULES_RUST.md -->
-<!-- version: 5 -->
+<!-- version: 6 -->
 
 # Règles Rust générales
 
@@ -8,7 +8,7 @@
 - **RUST-BASE-001** — L'édition Rust est Rust 2024.
 - **RUST-BASE-002** — Chaque `lib.rs` et `main.rs` active `missing_docs`, `unreachable_pub` et interdit `unsafe_code`, sauf exception FFI explicitement définie par cette règle.
 - **RUST-BASE-003** — Les lints communs sont déclarés au workspace et hérités par les crates ; une crate FFI exceptée peut déclarer localement le même profil avec uniquement le niveau `unsafe_code` ajusté.
-- **RUST-BASE-004** — Les blocs `unsafe` et fonctions `unsafe` sont interdits. L’unique exception actuelle est `crates/apps/game-android-entrypoint/src/lib.rs`, autorisé à porter uniquement les attributs `#[unsafe(export_name = "SDL_main")]` et `#[unsafe(export_name = "Java_com_sasedev_games_common_NativeBridge_nativeContractVersion")]` nécessaires aux frontières SDL Android et JNI. Cette exception n’autorise aucun déréférencement de pointeur brut, aucun autre attribut unsafe, aucun bloc `unsafe` et aucune fonction `unsafe`.
+- **RUST-BASE-004** — Les blocs `unsafe` et fonctions `unsafe` sont interdits. L’unique exception actuelle est `crates/apps/game-android-entrypoint/src/lib.rs`, autorisé à porter uniquement les attributs `#[unsafe(export_name = "SDL_main")]` , `#[unsafe(export_name = "Java_com_sasedev_games_common_NativeBridge_nativeContractVersion")]` et `#[unsafe(export_name = "Java_com_sasedev_games_common_NativeBridge_nativeRequestPlatformBack")]` nécessaires aux frontières SDL Android et JNI. Cette exception n’autorise aucun déréférencement de pointeur brut, aucun autre attribut unsafe, aucun bloc `unsafe` et aucune fonction `unsafe`.
 - **RUST-BASE-005** — Tout fichier Rust possède les en-têtes `// file: ...` et `// version: N`.
 - **RUST-DEP-001** — Une dépendance tierce partagée déclare uniquement sa contrainte de version canonique sous `[workspace.dependencies]`, sauf exception normative explicitement documentée.
 - **RUST-DEP-002** — Les features d'une dépendance tierce sont activées dans le `Cargo.toml` de la crate qui en a réellement besoin, via `workspace = true`; elles ne sont pas activées globalement au workspace par commodité.

docs/testing/002-BETA_VALIDATION_MATRIX.md

@@ -1,5 +1,5 @@
 <!-- file: docs/testing/002-BETA_VALIDATION_MATRIX.md -->
-<!-- version: 1 -->
+<!-- version: 2 -->
 
 # Matrice de validation beta 0.1.0
 
@@ -128,3 +128,21 @@ cargo test --workspace --all-targets --all-features
 ```
 
 Cette suite complète ne devient pas une gate de chaque futur correctif beta.
+
+## Logcat Android
+
+Le buffer doit être vidé avant le lancement du jeu, pas après :
+
+```bash
+adb -s <device> logcat -c
+adb -s <device> shell am start -n <package>/<activity>
+adb -s <device> logcat | grep -iE 'games\.sasedev|com\.sasedev\.games|SDL|AndroidRuntime|FATAL|panic'
+```
+
+Android utilise un subscriber `tracing` dédié à logcat.
+
+## Back Android 16
+
+Les applications ciblent API 36. Le Back système est donc traité via `OnBackInvokedCallback` sur API 33+ puis converti en `QuitSource::PlatformBack`.
+
+Le fallback `onBackPressed()` reste réservé aux versions Android antérieures.