Changelog
Cronologia dei rilasci e principali cambiamenti per BodyMetrics.
v1.1.0 — 14 giugno 2026
espansione multi-dispositivo🎉 Evidenze
- Supporto dei dispositivi espanso da 1 a 53 dispositivi Garmin
- Infrastruttura automatizzata di build e test multi-dispositivo
- Documentazione e guida di compatibilità dei dispositivi migliorate
Funzionalità
- Supporto espanso a 53 dispositivi Garmin Connect IQ su 11 famiglie di prodotti
- Forerunner (11 dispositivi), Fenix (serie 7/8), Epix, Venu, Vivoactive
- MARQ 2, Enduro 3, serie D2, Instinct 3 AMOLED, Descent, Approach
- Sistema automatizzato di validazione build multi-dispositivo (
.vscode/build-all-devices.sh) - Launcher del simulatore specifico per dispositivo con logica di retry (
.vscode/run-sim.sh) - Integrazione dei task di VS Code con dropdown di selezione dispositivo (53 dispositivi disponibili)
- Matrice di compatibilità dei dispositivi e rapporto di build completo
Miglioramenti UX
- Ottimizzazione del rendering cross-device con interfaccia completamente adattiva
- Geometria dinamica degli accordi per schermi circolari
- Supporto sia per display MIP (e-ink) che AMOLED
- Nessun percorso di codice specifico per dispositivo richiesto (sistema di rendering universale)
Architettura e Dipendenze
- Aggiornamento del livello API minimo da 1.2.0 a 2.3.0
- Garantisce compatibilità con i dispositivi Garmin moderni
- Supporta Application.Storage richiesto dal livello di persistenza dei dati
- Evita il limite di argomenti del metodo API 3.x (max 9 argomenti per metodo)
- Validazione build: 53/53 dispositivi superano (100% di successo)
Corretti
- Corretto un crash in modalità wizard durante la pressione rapida oltre il primo o l’ultimo valore di un campo profilo o di una finestra di trend (avvolgimento dell’indice con valori negativi)
Documentazione
- Aggiunta sezione “Dispositivi Supportati” nel README con elenco completo dei dispositivi
- Creata tabella completa di compatibilità dei dispositivi
- Aggiunta guida di test specifica per dispositivo
- Nuova pagina Dispositivi Supportati con tutti i 53 modelli, tipo di display e dimensione dello schermo
- Changelog esteso con breakdown completo delle funzionalità per v1.1.0
Limitazioni Note ed Esclusioni
Dispositivi Esclusi (incompatibilità API 3.x):
- Forerunner 745, 945, 945 LTE (API 3.3/3.4)
- Descent MK1, Descent MK2, Descent MK2S (API 3.x)
- Modelli MARQ Gen 1 (API 3.4)
Motivo: Monkey C API 3.x ha un limite fisso di 9 argomenti per metodo. I metodi BodyMetrics buildTargetMetric(), buildTargetMetricThresholds() e _drawMiniChart() richiedono 10+ argomenti, causando errori di compilazione. Questi dispositivi verranno ri-aggiunti in un futuro rilascio quando Garmin risolverà questa limitazione API.
Altre esclusioni:
- D2 Air: memoria widget di 512 KB, inferiore ai 768 KB usati dagli altri dispositivi supportati
v1.0.0 — 12 maggio 2026
primo rilascio stabileFunzionalità
- Viste di riepilogo e dettagli per tutte le metriche tracciate.
- Schermi informativi con descrizioni delle metriche, zone di riferimento e contesto di lettura.
- Visualizzazione dei trend storici con finestre temporali selezionabili.
- Flusso di lavoro guidato al primo avvio per l’impostazione del profilo utente.
- Flusso di lavoro guidato per l’inserimento delle misurazioni corporee.
- Flusso di lavoro guidato per l’impostazione dei target personalizzati.
- Calcolo del delta target rispetto al target effettivo.
- Supporto per peso, grasso corporeo, massa muscolare, idratazione e massa ossea.
- Valori derivati: BMI, percentuale muscolare, BMR di riferimento e potenza di uscita.
- Cronologia locale per grafici di trend e stati informativi.
- Distinzione tra dati locali manuali e peso del profilo utente Garmin.
- Commutazione della lingua dell’interfaccia (IT, EN, FR, ES).
- Reset completo dei dati locali dell’app.
- System Info → Website: pulsante selezionabile che apre una vista QR code a schermo intero centrata sul display.
- Documentazione del progetto bilingue (IT/EN).
Miglioramenti UX
- Tasto MENU nella procedura guidata: bloccato durante la modalità procedura guidata di inserimento dati per evitare l’apertura accidentale del menu di sistema.
- Navigazione della procedura guidata: accelerazione a pressione rapida per UP/DOWN — i tocchi consecutivi entro 600 ms aumentano progressivamente il moltiplicatore di passaggio (×1 → ×5 → ×10 → ×50).
Architettura
- Architettura pulita a sei livelli: coordinamento UI, rendering, facciata di dominio, casi d’uso, regole di business e localizzazione.
round1Global()/fmt1Global()globali come funzioni autoritative singole di arrotondamento e formattazione.RendererCommoncome singola fonte autorevole di tutti i layout di testo e le utilità di disegno.- Livello di policy puro e senza effetti collaterali (ClassificationPolicy, ThresholdFactory, HealthCalculators).
- Sistema i18n a tre componenti: catalogo, adapter e validatore di completezza.
- Servizio cache dei trend con invalidazione al salvataggio delle misurazioni, reset, cambio metrica e cambio finestra.
Compatibilità
- Validato sul target
fr265, build di riferimento v15: BUILD RIUSCITO.