Apple HealthKit data sync improvements (Aug 2024)

An overhauled Apple HealthKit sync engine is now available across all Vital Mobile SDK platforms. The changes bring historical data sync incrementality, prioritization, network resiliency and reduced resource usage.

  1. Most resources now use a resumable sync & upload process.

    • This enables the SDK to make constant forward progress, especially when you have specified a very large historical pull stage (60-365 days) through the Team Data Pull Preferences API.
  2. The SDK now prioritises syncing of summary types over timeseries data.

    • During the historical pull stage, all timeseries resources would be suppressed until all the summary types have been successfully uploaded.

    • After the historical pull stage, the SDK would make forward progress on summary types, before it proceeds to deal with the more CPU-time consuming timeseries data that are more prone to operating system throttling.

  3. With an updated iOS App Target configuration, the SDK would now self-register as a BGProcessingTask or BGHealthResearchTask (iOS 17+) to the iOS BackgroundTasks framework.

    • This would provide the SDK an additional opportunity to complete any resource sync that is not able to complete during normal HealthKit background delivery.

    • Please refer to the Apple HealthKit guide on how to update your iOS App Target configuration in Xcode.

PlatformRelease Note
Native iOSvital-ios 1.2.2
Fluttervital-flutter 4.2.1
React Nativevital-react-native 4.2.1

Menstrual Cycle Tracking (July 2024)

Menstrual cycle tracking data can now be collected through the Apple HealthKit and Android Health Connect integrations.

Ask for data permission on the MenstrualCycle resource from the user through the Vital Health SDK.

Check out the Get Menstrual Cycles endpoint and the Menstrual Cycle data events in the Event Catalog for more information.

Steps count in workouts (May 2024)

Workouts now include the total steps count during the session (if available).

Check out the Get Workouts endpoint and the Workout Created event for more information.

New Abbott LibreView integration (May 2024)

Vital has introduced an new Abbott LibreView provider (abbott_libreview). It uses password authentication, accepting LibreView patient account credentials.

This is an alternative option to our practice-based Freestyle Libre provider (freestyle_libre).

With abbott_libreview, Vital uses the provided LibreView patient account credentials to connect directly to LibreView. There is no involvement of a LibreView practice in this integration.

Note that both practice-based and patient-based connections would continue to be supported in parallel. The abbott_libreview integration does not replace the freestyle_libre integration.

Check out the Abbott LibreView / Freestyle Libre guide for more information.

Removed Fitbit and Oura required scopes (May 2024)

The Fitbit profile scope and Oura email scope are no longer required for establishing connections.

For Fitbit specifically, please be aware of the updated Fitbit Time Zone resolution precedences. When your user refuses to grant both the activity and the profile scope, Fitbit data are more likely be timestamped incorrectly in UTC time basis due to inaccurate or unavailable time zone information.

We have now updated our Fitbit and Oura integrations not to depend on these scopes to be minimally functional.

If you are interested in requiring your users to grant certain scopes when connecting an OAuth provider, check out the Team Scope Requirements changelog entry and the Set Team Scope Requirements endpoint for more information.

Freestyle Libre: India region (Apr 2024)

Our Freestyle Libre integration now supports the LibreView India region.

Check out the Freestyle Libre documentation for more information.

Health Connect Background Sync (Mar 2024)

Vital Mobile SDK now includes an experimental Background Sync feature for Android Health Connect.

The feature is available through the following Vital Mobile SDK releases:

PlatformVersion
Native Android2.0.0+
Flutter3.2.0+
React Native3.1.0+

Check out the following documentation for information, integration guidance as well as caveats of the experimental Background Sync :

Expanded Source Type attribution (Feb 2024)

Data from Fitbit, Oura, Garmin and Freestyle Libre now comes with Source Type attributions.

Check out the Data Attributions documentation for more information.