HormoneTrack/docs/MONTRE-GADGETBRIDGE.md

# Montre Huawei Watch GT 3 — Gadgetbridge & options

> Contexte : Huawei Watch GT 3 (HarmonyOS 4.0.0.120). C'est un appareil **« Lite Wearable »**
> (base LiteOS-like) : il n'exécute pas d'apps Android, et l'installation d'apps tierces
> au poignet est très restreinte. Ce doc récapitule ce qui est possible, ce qui ne l'est
> pas, et la stratégie retenue.

## 1. État v1 : la montre comme écran de notifications ✅

L'app téléphone envoie des notifications de rappel (AlarmManager exact) qui remontent au
poignet. **Deux chemins supportés, au choix** :

| Chemin | Prérequis | Notes |
|---|---|---|
| **Gadgetbridge** (FOSS) | Appairage GB ↔ montre | Transfert de notifications supporté pour la GT 3 (« mostly supported »). Aucun compte Huawei, aucune télémétrie — cohérent avec la vie privée de l'app. |
| **Huawei Health** | Appairage Health ↔ montre | Chemin « officiel ». Autoriser l'app dans Santé → Montre → Notifications. |

⚠️ **La montre ne peut être appairée qu'à l'un des deux à la fois** (Health ou Gadgetbridge).
Pour installer un watchface via GB, il faut dé-pairer de Health, puis re-pairer ensuite.

Le bouton **« Pris »** dans la notification logue la dose côté téléphone ; « Reporter 1 h »
re-programme l'alarme. Les deux marchent quelle que soit la source de la notification
(la montre ne fait que l'afficher).

## 2. Ce que Gadgetbridge sait faire (vérifié juillet 2026)

Source : docs gadgetbridge.org + issues/pull requests Codeberg.

- ✅ Appairage sans l'app Huawei (no-vendor pair), notifications, données santé (TruSleep…)
- ✅ **Installation de watchfaces** `.hwt` / `watchface.bin` (PR #3910 « Improve watchface
  install support » : les `.hwt` récents contiennent un zip interne `com.huawei.watchface`
  ; pour les montres LiteOS comme la GT 3, GB en extrait `watchface.bin` et le flashe)
- ❌ **Pas d'installation d'apps `.hap`** : Gadgetbridge n'implémente pas l'installation
  d'applications Lite Wearable sur les montres GT — seulement watchfaces + firmwares
- ⚠️ **Régression connue** : HarmonyOS 6.1+ (firmwares 2026, ex. GT 6) casse l'installation
  de `.hwt` via GB (issues #5968/#6005/#6199). La GT 3 en HarmonyOS 4.0.0.120 **devrait**
  rester OK, mais à valider en pratique.

**Conclusion** : « Gadgetbridge installe des applis » = en réalité des **watchfaces**.
Une vraie app au poignet passe par un autre chemin (§4).

## 3. Signatures : qu'est-ce qu'il faut ?

- **Watchface via Gadgetbridge** : **aucune signature** — le `watchface.bin` est flashé tel
  quel par GB. Rien à faire de ce côté.
- **App Lite Wearable (`.hap`) par sideload** : nécessite un certificat de **debug
  AppGallery Connect** (compte développeur Huawei, UDID de la montre enregistré,
  fichiers `.p12/.cer/.p7b` dans DevEco Studio). Gadgetbridge ne gère pas ce flux.
- **App Android (téléphone)** : debug keystore auto-généré — rien à faire pour un usage
  personnel.

## 4. Options « app au poignet » (Phase 2), par coût croissant

### Option A — Watchface personnalisée (statique + champs de données standard)
- Faisable **sans** Huawei : format `.hwt` (ressources + `description.xml`), installable
  via GB sur HarmonyOS ≤ 6.0.x
- Limites : les données affichables sont une **liste fixe** (heure, date, batterie, pas,
  FC, météo…) — **pas** nos estimations E2/T dynamiques
- Usage possible : rappel visuel statique (ex : « gel 8h · 20h » intégré au design),
  pas d'affichage de courbe

### Option B — Mini-app **Lite Wearable** (`.hap`) installée par sideload
- Chaîne : **DevEco Studio** (~10 Go) → projet `[Lite] Empty Ability` (JS UI lite) →
  build `.hap` signé → compte **AppGallery Connect** + UDID de la montre → installation
  via **DevEco Assistant** (APK sur le téléphone) — procédure documentée (article Huawei
  Developers, jan. 2025, testée sur GT 5 ; GT 3/HarmonyOS 4 à valider)
- Limites : framework JS très simple (pas de Canvas riche), stockage local limité
  (`@system.storage`), et **pas de synchro live** avec l'app téléphone sans l'API
  **Wear Engine** (accès partenaire, dossier à déposer chez Huawei) → la mini-app serait
  autonome (saisie/redondance de données sur la montre)
- C'est le seul chemin vers une « vraie app » sur GT 3

### Option C — Rester sur les notifications (choix v1)
- Zéro maintenance, fiable, marche avec GB et Health ; la montre affiche rappel + actions
- Recommandé tant que l'option B n'apporte pas de vraie valeur (voir la saisie pénible
  au poignet)

## 5. Décision et prochaines étapes

1. **V1** : notifications via Gadgetbridge (ou Health) — livré ✅
2. À tester par l'utilisatrice : installer une watchface `.hwt` de test via GB sur la GT 3
   (HarmonyOS 4.0.0.120) pour valider le chemin d'installation
3. Si une app au poignet est vraiment souhaitée : option B, en commençant par un POC
   « afficher une valeur statique » ; la synchro téléphone↔montre étant le point dur
   (Wear Engine partenaire), la mini-app devra être **autonome** (saisie sur la montre)

## 6. Références

- Docs GB Huawei/Honor : https://gadgetbridge.org/basics/topics/huawei-honor/
- Compatibilité appareils : https://gadgetbridge.org/gadgets/wearables/huawei-honor/
- PR watchface install (#3910) : https://codeberg.org/Freeyourgadget/Gadgetbridge/pulls/3910
- Régression HarmonyOS 6.1 (#6199) : https://codeberg.org/Freeyourgadget/Gadgetbridge/issues/6199
- Guide de développement Lite Wearable (session 1) : DevEco Studio + AGC + DevEco
  Assistant — voir historique de chat et https://developer.huawei.com/consumer/en/multidevice/wearables/get-started/