Changelog
Release history and notable changes for BodyMetrics.
v1.1.0 — October 26, 202multi-device expansion >}}
🎉 Highlights
- Device support expanded from 1 to 53 Garmin devices
- Automated multi-device build and test infrastructure
- Enhanced documentation and device compatibility guide
Features
- Expanded device support to 53 Garmin Connect IQ devices across 11 product families
- Forerunner (11 devices), Fenix (7/8 series), Epix, Venu, Vivoactive
- MARQ 2, Enduro 3, D2 series, Instinct 3 AMOLED, Descent, Approach
- Automated multi-device build validation system (
.vscode/build-all-devices.sh) - Device-specific simulator launcher with retry logic (
.vscode/run-sim.sh) - VS Code task integration with device picker dropdown (53 devices available)
- Comprehensive device compatibility matrix and build report
UX Refinements
- Cross-device rendering optimization with fully adaptive UI
- Dynamic chord geometry for circular screens
- Support for both MIP (e-ink) and AMOLED display types
- No device-specific code paths required (universal rendering system)
Architecture & Dependencies
- Upgraded minimum API Level from 1.2.0 to 2.3.0
- Ensures compatibility with modern Garmin devices
- Supports Application.Storage required by data persistence layer
- Avoids API 3.x method argument limitation (max 9 arguments per method)
- Build validation: 53/53 devices pass (100% success rate)
Fixed
- Crash in wizard mode when rapid-pressing past the first or last value of a profile field or trend window (index wrap-around with negative values)
Documentation
- Added “Supported Devices” section in README with full device list
- Created comprehensive device compatibility table
- Added device-specific testing guide
- New Supported Devices page with all 53 models, display type and screen size
- Extended changelog with full feature breakdown for v1.1.0
Known Limitations & Exclusions
Excluded Devices (API 3.x incompatibility):
- Forerunner 745, 945, 945 LTE (API 3.3/3.4)
- Descent MK1, Descent MK2, Descent MK2S (API 3.x)
- MARQ Gen 1 models (API 3.4)
Reason: Monkey C API 3.x has a hard limit of 9 arguments per method. BodyMetrics methods buildTargetMetric(), buildTargetMetricThresholds(), and _drawMiniChart() require 10+ arguments, causing compilation failures. These devices will be re-added in a future release when Garmin resolves this API limitation.
Other exclusions:
- D2 Air: widget memory of 512 KB, below the 768 KB used by the other supported devices
v1.0.0 — May 12, 202first stable release >}}
Features
- Summary and detail views for all tracked metrics.
- Informational screens with metric descriptions, reference zones, and reading context.
- Historical trend visualisation with selectable time windows.
- Guided first-run workflow for user profile setup.
- Guided workflow for body measurement entry.
- Guided workflow for custom target setup.
- Target delta calculation against the effective target.
- Support for weight, body fat, muscle mass, hydration, and bone mass.
- Derived values: BMI, muscle percentage, reference BMR, and power output.
- Local history for trend charts and informational states.
- Distinction between manual local data and Garmin UserProfile weight.
- Interface language switching (IT, EN, FR, ES).
- Full reset of local app data.
- System Info → Website: selectable button that opens a full-screen QR code view centred on the display.
- Bilingual (IT/EN) project documentation.
UX Refinements
- MENU key in wizard: blocked during data-entry wizard mode to prevent accidental system menu opening.
- Wizard navigation: rapid-press acceleration for UP/DOWN — consecutive taps within 600 ms progressively increase the step multiplier (×1 → ×5 → ×10 → ×50).
Architecture
- Six-layer clean architecture: UI coordination, rendering, domain facade, use cases, business rules, and localisation.
- Global
round1Global()/fmt1Global()as the single authoritative rounding and formatting functions. RendererCommonas the single authoritative source for all text layout and drawing utilities.- Pure, side-effect-free policy layer (ClassificationPolicy, ThresholdFactory, HealthCalculators).
- Three-component i18n system: catalog, adapter, and completeness validator.
- Trend cache service with invalidation on measurement save, reset, metric change, and window change.
Compatibility
- Validated on target
fr265, reference build v15: *BUILD SUCCESSFUL