0.3.5-beta.2

crates/common/game-realtime-webtransport-lib/README.md

@@ -1,9 +1,9 @@
 <!-- file: crates/common/game-realtime-webtransport-lib/README.md -->
-<!-- version: 6 -->
+<!-- version: 7 -->
 
 # game-realtime-webtransport-lib
 
-Backend WebTransport/QUIC candidat pour le realtime de `games.sasedev`.
+Backend WebTransport/QUIC retenu comme second backend realtime de `games.sasedev`, aux côtés de WebSocket qui reste la baseline/fallback de référence.
 
 ## Responsabilité
 
@@ -125,8 +125,13 @@ La crate ne possède toujours pas :
 - d'API datagram transport-neutral ;
 - de serveur WebTransport WASM ;
 - de fallback WebSocket dans le backend ;
-- de benchmark WebSocket/WebTransport.
+- de sélection dynamique de transport ;
+- de protocole wire/session ou de synchronisation gameplay.
 
-Ces responsabilités restent réservées aux tranches suivantes du plan `0.3.5`.
+Le fallback WebSocket est prouvé au niveau composition par `game-realtime-transport-fallback-smoke`. La caractérisation comparative est portée par `game-realtime-transport-measure` et documentée dans `docs/studies/027-V0_3_5_REALTIME_TRANSPORT_MEASUREMENT.md`; elle ne fait pas partie de la responsabilité de cette crate.
 
 Le chemin natif s'exécute sous un runtime Tokio fourni par le consommateur ; la crate ne crée ni runtime ni thread privé. Les dépendances navigateur sont target-specific et ne sont donc pas tirées par le backend natif. Réciproquement, `web-transport-quinn`, Tokio et rcgen ne sont pas requis pour construire la crate en `wasm32-unknown-unknown`.
+
+## Portabilité validée en 0.3.5
+
+La validation de la version couvre Linux natif client/server, le client navigateur/WASM réel et la cross-compilation du backend pour `aarch64-linux-android` avec API 21. Cette dernière preuve est une preuve de compilation, pas un smoke réseau sur appareil Android. Les plateformes Apple et les autres ABI Android ne sont pas déclarées validées par `0.3.5`.

crates/common/game-realtime-webtransport-lib/USAGE.md

@@ -1,5 +1,5 @@
 <!-- file: crates/common/game-realtime-webtransport-lib/USAGE.md -->
-<!-- version: 5 -->
+<!-- version: 6 -->
 
 # Utilisation de game-realtime-webtransport-lib
 
@@ -106,6 +106,27 @@ Le build workspace fournit `web_sys_unstable_apis` uniquement à `wasm32-unknown
 
 Le host Vite et l'adapter `wasm-bindgen` de `game-realtime-webtransport-browser-smoke` servent uniquement de preuve runtime. Ils ne sont pas nécessaires à un consommateur qui intègre déjà la bibliothèque dans son propre frontend.
 
+## Cross-compilation Android ARM64
+
+`0.3.5` a validé la cross-compilation de la crate pour `aarch64-linux-android` avec le NDK `28.2.13676358` et `minSdk`/API 21. Le NDK moderne expose un Clang dont le nom contient le niveau API ; `ring`/`cc-rs` doit recevoir explicitement ce compilateur si le wrapper générique `aarch64-linux-android-clang` n'est pas présent dans le `PATH`.
+
+Configuration de validation portable à partir du SDK déjà déclaré dans l'environnement :
+
+```bash
+ANDROID_SDK="${ANDROID_HOME:-$ANDROID_SDK_ROOT}"
+export ANDROID_NDK_HOME="$ANDROID_SDK/ndk/28.2.13676358"
+export TOOLCHAIN="$ANDROID_NDK_HOME/toolchains/llvm/prebuilt/linux-x86_64"
+
+export CC_aarch64_linux_android="$TOOLCHAIN/bin/aarch64-linux-android21-clang"
+export CXX_aarch64_linux_android="$TOOLCHAIN/bin/aarch64-linux-android21-clang++"
+export AR_aarch64_linux_android="$TOOLCHAIN/bin/llvm-ar"
+export CARGO_TARGET_AARCH64_LINUX_ANDROID_LINKER="$TOOLCHAIN/bin/aarch64-linux-android21-clang"
+
+cargo check -p game-realtime-webtransport-lib --target aarch64-linux-android
+```
+
+Ces variables décrivent une commande de cross-compilation et ne doivent pas être remplacées dans le dépôt par un chemin absolu propre à une machine. Cette preuve ne construit pas d'APK/AAB et ne remplace pas un futur smoke WebTransport sur appareil Android si cette cible devient un chemin produit réel.
+
 ## Contrat realtime
 
 Une fois le stream primaire sélectionné, utiliser les traits de `game-realtime-transport-lib` pour le chemin fiable normal :