|
|
@@ -37,12 +37,28 @@ java -jar /tmp/opencode/plantuml.jar -checkonly documentation/puml/*.puml
|
|
|
- **Épinglages à ne pas bouger sans raisons** :
|
|
|
- AGP < 8.9.2 → son lint plante (UAST vs Kotlin 2.1,
|
|
|
`KaCallableMemberCall`). Ne pas revenir à 8.7.x.
|
|
|
+ - **Compose BOM = `2025.08.00`** (Compose 1.9.0) : c'est la version attendue
|
|
|
+ par Wear Compose 1.6.2 (qui dépend de `compose.ui:1.9.0`). Avec une BOM
|
|
|
+ plus ancienne (1.8.x) les versions Compose deviennent mixtes et le rendu
|
|
|
+ casse. Ne pas redescendre.
|
|
|
- Wear Compose **1.6.2** : la 1.7.x exige AGP 9.1 + compileSdk 37.
|
|
|
- - core-ktx / lifecycle / compose-bom : versions inférieures aux dernières
|
|
|
- car les suivantes demandent compileSdk ≥ 36. Monter compileSdk/AGP est un
|
|
|
- chantier à part entière (AGP 9 change le DSL).
|
|
|
-- `lint { disable += "RememberInComposition" }` dans `wear/build.gradle.kts` :
|
|
|
- détecteur en crash avec cette paire AGP/Kotlin, laisser tel quel.
|
|
|
+ - core-ktx / lifecycle : versions inférieures aux dernières car les suivantes
|
|
|
+ demandent compileSdk ≥ 36. Monter compileSdk/AGP est un chantier à part.
|
|
|
+
|
|
|
+## Pièges de rendu Wear Compose (déjà rencontrés)
|
|
|
+
|
|
|
+- Dans `SwipeDismissableNavHost`, utiliser **impérativement**
|
|
|
+ `androidx.wear.compose.navigation.composable` — et NON
|
|
|
+ `androidx.navigation.compose.composable`. Avec le mauvais import les
|
|
|
+ destinations ne s'affichent jamais : l'app démarre sur un **écran noir**
|
|
|
+ (aucune exception, surface dessinée mais vide). C'était la cause du bug
|
|
|
+ d'écran noir d'octobre 2026.
|
|
|
+- Toujours passer `modifier = Modifier.fillMaxSize()` à
|
|
|
+ `SwipeDismissableNavHost` : sans contrainte de taille explicite il peut
|
|
|
+ mesurer 0.
|
|
|
+- Pour déboguer un écran noir sur montre : `adb exec-out screencap -p` +
|
|
|
+ analyse des pixels (voir `scripts/`), puis comparer avec le `NavHost`
|
|
|
+ standard `androidx.navigation.compose.NavHost` qui, lui, rend correctement.
|
|
|
|
|
|
## Diagrammes UML
|
|
|
|