130 lines
3.5 KiB
Markdown
130 lines
3.5 KiB
Markdown
<!-- file: deltas/0.1.0/0-pre.7.fix.1.md -->
|
|
<!-- version: 1 -->
|
|
|
|
# Delta 0.1.0-0-pre.7.fix.1
|
|
|
|
## Base
|
|
|
|
Base déclarée : `0.1.0-0-pre.7`, non validée intégralement.
|
|
|
|
## Validation du delta précédent
|
|
|
|
L'utilisateur a exécuté les validations de `0.1.0-0-pre.7` le 2026-09-16.
|
|
|
|
Résultats propres :
|
|
|
|
- `cargo fmt --all` ;
|
|
- `cargo fmt --all -- --check` ;
|
|
- audit Rust/workspace ;
|
|
- audit Markdown : `1 table(s), 51 file(s)` ;
|
|
- `cargo check --workspace` ;
|
|
- `cargo clippy --workspace --all-targets --all-features -- -D warnings` ;
|
|
- `cargo test -p game-android-entrypoint --no-default-features` ;
|
|
- `cargo-ndk 4.1.2` installé ;
|
|
- target Rust `aarch64-linux-android` installé ;
|
|
- builds Gradle Reflex et Snake propres.
|
|
|
|
## Échec du build natif Android
|
|
|
|
Les deux commandes :
|
|
|
|
```bash
|
|
python3 scripts/build_android_rust.py reflex
|
|
python3 scripts/build_android_rust.py snake
|
|
```
|
|
|
|
ont échoué avant cross-compilation avec :
|
|
|
|
```text
|
|
jni/arm64-v8a/libSDL3.so is missing from Android/libs/SDL3-3.4.16.aar
|
|
```
|
|
|
|
La cause est une hypothèse incorrecte du script.
|
|
|
|
L'AAR SDL3 officiel expose ses bibliothèques natives via Prefab, sous une structure de type :
|
|
|
|
```text
|
|
prefab/modules/SDL3/libs/android.arm64-v8a/libSDL3.so
|
|
```
|
|
|
|
et non obligatoirement sous `jni/arm64-v8a/`.
|
|
|
|
## Correctif
|
|
|
|
Le script `build_android_rust.py` :
|
|
|
|
- recherche d'abord la structure Prefab officielle ;
|
|
- conserve un fallback `jni/<abi>/libSDL3.so` ;
|
|
- sait détecter une unique variante compatible sous `*/libs/android.<abi>/libSDL3.so` ;
|
|
- extrait `libSDL3.so` dans le répertoire de liaison temporaire ;
|
|
- stage aussi `libSDL3.so` dans le `jniLibs/<abi>/` de l'application ;
|
|
- vérifie après `cargo ndk` que `libgame_android_entrypoint.so` existe réellement.
|
|
|
|
Les `versionName` Android passent à `0.1.0-0-pre.7.fix.1`.
|
|
|
|
## ADB et NDK
|
|
|
|
L'absence initiale de `adb` n'est pas considérée comme un défaut du projet.
|
|
|
|
Préflight recommandé :
|
|
|
|
```bash
|
|
"${ANDROID_HOME}/cmdline-tools/latest/bin/sdkmanager" "ndk;28.2.13676358" "platform-tools"
|
|
export PATH="${ANDROID_HOME}/platform-tools:${PATH}"
|
|
adb version
|
|
```
|
|
|
|
Le NDK r28c correspond à `28.2.13676358`.
|
|
|
|
## Validation à exécuter par l'utilisateur
|
|
|
|
Le fix modifie un script Python et des fichiers Gradle, mais aucun fichier Rust.
|
|
|
|
```bash
|
|
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 deltas history
|
|
cargo check --workspace
|
|
```
|
|
|
|
Build natif :
|
|
|
|
```bash
|
|
python3 scripts/build_android_rust.py reflex
|
|
python3 scripts/build_android_rust.py snake
|
|
```
|
|
|
|
Vérifier :
|
|
|
|
```bash
|
|
test -f Android/game-reflex-poc/src/main/jniLibs/arm64-v8a/libSDL3.so
|
|
test -f Android/game-reflex-poc/src/main/jniLibs/arm64-v8a/libgame_android_entrypoint.so
|
|
test -f Android/game-snake-poc/src/main/jniLibs/arm64-v8a/libSDL3.so
|
|
test -f Android/game-snake-poc/src/main/jniLibs/arm64-v8a/libgame_android_entrypoint.so
|
|
```
|
|
|
|
Puis :
|
|
|
|
```bash
|
|
cd Android
|
|
gradle :game-reflex-poc:assembleDebug
|
|
gradle :game-snake-poc:assembleDebug
|
|
cd ..
|
|
```
|
|
|
|
Le smoke appareil est demandé seulement si `adb` et un appareil/émulateur sont disponibles :
|
|
|
|
```bash
|
|
adb devices
|
|
```
|
|
|
|
puis installation/lancement des deux APK.
|
|
|
|
## Règle de transition
|
|
|
|
Si les gates légères, les deux builds Rust Android et les deux APK sont propres, `0.1.0-0-pre.7.fix.1` peut être validé même sans appareil disponible.
|
|
|
|
Si un appareil/émulateur est disponible, le premier smoke runtime Android doit également être exécuté avant de passer à `0.1.0-0-pre.8`.
|
|
|
|
En cas d'échec imputable au projet, produire `0.1.0-0-pre.7.fix.2`.
|