422b6ac3e6
Sylvain enchaîne un troisième envoi et reçoit « le canal est probablement occupé » — notre propre message, déclenché par watchNotFound avec des montres muettes : le service PsFTP est là, il ne répond pas. La chronologie de ses trois envois explique tout. Le premier réussit, montre fraîchement réinitialisée donc pas encore liée à Flow. Le deuxième renvoie 104 DIRECTORY_EXISTS, ce qui prouve que le canal était ENCORE libre. Le troisième échoue : Flow a repris la main entre-temps. Le canal n'est donc pas ouvert ou fermé en général — il y a une fenêtre, qui se referme dès que Flow se reconnecte. Le message conseillait de fermer complètement l'app Polar Flow. C'était faux, et la mesure du 31/08 le disait déjà : la montre affichait « connexion impossible » pendant que les réglages iOS la disaient toujours connectée à Flow. iOS maintient le lien d'un accessoire appairé, app fermée ou non. Le message nomme maintenant le geste qui libère réellement le canal — redémarrer la montre — précise que fermer l'app n'y change rien, et rappelle que le câble est le chemin fiable. Corrigé au passage le message des appareils sans PsFTP, qui présentait encore la question comme « l'inconnue restante » alors qu'elle a été tranchée le 31/08 : la montre expose bien PsFTP quand elle est connectée. Un test interdit désormais de la rouvrir dans l'UI. 88 tests Linux verts, dont deux nouveaux qui verrouillent l'absence du conseil inutile et la présence du geste utile. Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Coach Hypnotruck — Mobile (iOS + Android)
Wrapper natif mobile de coach.hypnotruck.ch basé sur Capacitor 8.
Le repo s'appelle historiquement
coach-ios; renommécoach-mobileà partir de l'ajout de la plateforme Android (2026-05-07). Le filenamecoach-ios.local.jsonest conservé pour ne pas casser les références dans le code Swift natif.
Architecture
- Backend : FastAPI + Jinja2 hébergé sur le VPS, accessible via
https://coach.hypnotruck.ch - Coque iOS : Capacitor 8 charge l'URL distante dans un WKWebView
- Coque Android : Capacitor 8 charge l'URL distante dans une WebView (Android 8.0+, API 26+ — requis par Health Connect)
- Plugins natifs : push notifications, local notifications, géolocalisation, HealthKit (iOS) / Health Connect (Android) via
@capgo/capacitor-health, splash, status bar, haptics
Le code web n'est pas embarqué — l'app pointe vers la prod via server.url dans capacitor.config.ts. Avantage : déploiement web = mise à jour instantanée de l'app sans review Apple/Google.
Bundle ID & nom
- Bundle ID :
ch.hypnotruck.coach - App Store name :
Coach Hypnotruck - Display name :
Coach Hypnotruck
Prérequis (sur le Mac mini)
- macOS 13+ (Ventura ou plus récent)
- Xcode 15+ (App Store, ~10 Go)
- Command Line Tools :
xcode-select --install - Homebrew +
brew install node cocoapods - Node 20 LTS (compatible avec Cap 8)
- Compte Apple Developer Program actif (99 USD/an)
- Apple ID
dev@hypnotruck.chconnecté dans Xcode → Settings → Accounts
Workflow build
1. Cloner le repo sur le Mac mini
git clone https://git.nexus.hypnotruck.ch/sylvain/coach-ios.git
cd coach-ios
npm install
1bis. Configurer le token d'auth (auto-login)
Le repo ne contient pas le token COACH_WEB_TOKEN (gitignored). Crée le fichier sur le Mac :
cp coach-ios.local.json.example coach-ios.local.json
# Édite coach-ios.local.json et remplace par la vraie valeur
# (visible dans ~/.config/infomaniak.env sur le VPS, ligne export COACH_WEB_TOKEN=)
L'app utilisera ce token pour se connecter automatiquement à coach.hypnotruck.ch/login?token=... au lancement.
2. Générer les icônes & splash
# iOS uniquement
npx @capacitor/assets generate --ios
# Android uniquement
npx @capacitor/assets generate --android
# Les deux
npx @capacitor/assets generate
Génère toutes les tailles requises depuis resources/icon.png (1024×1024) et resources/splash.png (2732×2732).
3. Ajouter la plateforme iOS (à faire UNE SEULE FOIS sur le Mac)
npx cap add ios
Cette commande crée le dossier ios/ avec le projet Xcode, qui sera ensuite committé.
4. Sync (à chaque changement de plugins ou config)
npx cap sync ios
5. Ouvrir dans Xcode
npx cap open ios
Dans Xcode :
- Sélectionner le projet App dans la navigation gauche
- Onglet Signing & Capabilities :
- Team : ton équipe Apple Developer
- Bundle Identifier :
ch.hypnotruck.coach - Cocher "Automatically manage signing"
- Ajouter les capabilities requises :
- HealthKit (lecture FC, pas, calories, VO2max)
- Push Notifications
- Background Modes → Remote notifications
- Onglet Info : ajouter les clés Privacy obligatoires (voir section ci-dessous)
6. Build sur simulateur / device
- Simulateur : choisir un iPhone dans la barre du haut → ⌘R
- Device physique : connecter iPhone par USB, sélectionner, ⌘R (la 1ère fois iOS demande de faire confiance au certificat dev dans Réglages → Général → VPN et gestion des appareils)
7. Upload TestFlight
- Xcode → Product → Archive
- Fenêtre Organizer s'ouvre → sélectionner l'archive → Distribute App → App Store Connect → Upload
- Sur App Store Connect : créer une nouvelle app (1ère fois), section TestFlight → ajouter testeurs (jusqu'à 100 internes sans review, 10 000 externes avec review légère)
Privacy keys requises (Info.plist)
Sans ces clés, iOS crashe à l'usage du plugin. À ajouter dans Xcode → onglet Info → Custom iOS Target Properties :
| Clé | Valeur (description affichée à l'utilisateur) |
|---|---|
NSHealthShareUsageDescription |
"Coach Hypnotruck lit vos données de santé (FC, pas, calories) pour adapter vos séances." |
NSHealthUpdateUsageDescription |
"Coach Hypnotruck enregistre vos séances dans Santé pour suivre votre progression." |
NSLocationWhenInUseUsageDescription |
"Coach Hypnotruck utilise votre position pour tracer vos sorties course et VTT." |
NSLocationAlwaysAndWhenInUseUsageDescription |
"Permet le suivi GPS pendant les sorties même app en arrière-plan." |
NSMotionUsageDescription |
"Coach Hypnotruck utilise les capteurs de mouvement pour mesurer votre activité." |
NSCameraUsageDescription |
"Coach Hypnotruck peut utiliser l'appareil photo pour scanner des codes-barres alimentaires." |
Anti-rejet App Store (Guideline 4.2)
Apple rejette les apps qui sont juste un wrapper webview sans valeur native. Pour passer review :
- ✅ Push notifications natives (rappel séances) — implémenté côté iOS via
@capacitor/push-notifications - ✅ HealthKit (lecture FC, pas, calories) — implémenté via
@capgo/capacitor-health - ✅ Géolocalisation native pour tracking sorties
- ✅ Local notifications (rappels hors-ligne)
- ✅ Haptics sur actions importantes
- ⏳ À implémenter côté web : appeler ces plugins via JS bridge depuis coach.hypnotruck.ch
Structure repo
coach-ios/
├── capacitor.config.ts # Config Capacitor (bundle ID, URL, plugins)
├── package.json # Deps Capacitor + plugins
├── www/ # Page de bootstrap (chargement, fallback)
│ └── index.html
├── resources/ # Source icônes & splash (1024×1024, 2732×2732)
│ ├── icon.png
│ └── splash.png
├── ios/ # Projet Xcode (généré par `cap add ios` sur Mac)
└── README.md
Mise à jour de l'app
| Type de modif | Action requise |
|---|---|
| Changement web (templates, CSS, routes) | Aucune — l'app charge la prod en direct |
| Ajout plugin Capacitor | npm install + npx cap sync + nouveau build TestFlight / Play Store |
| Changement icône / splash | npx @capacitor/assets generate + sync + nouveau build |
| Changement bundle ID, version, capabilities | Build + soumission Apple review / Play Console review |
TODO Phase 0
- Sur le Mac :
npx cap add ioset commit du dossierios/ - Configurer signing dans Xcode avec Apple ID
dev@hypnotruck.ch - Ajouter les Privacy keys dans Info.plist
- 1er build simulateur pour vérifier que la PWA charge bien
- 1er build device physique (iPhone perso)
- Upload TestFlight pour beta interne
- Préparer screenshots App Store (6.7" iPhone, min 3)
- Privacy policy URL (obligatoire avec HealthKit) — à héberger sur coach.hypnotruck.ch/privacy