Flutter SDK Background Delivery

​

iOS

​

Important Notes About Background Delivery on iOS

• For most data types, the most possible frequency of updates is 1 hour.
• iOS can update data more frequently for some data types, for example, vo2 max.
• iOS may throttle the frequency of updates for background delivery depending on the app’s activity, battery state, etc.
• Background delivery is not possible while a device is locked, so it will be executed only when the device is unlocked.
• iOS may stop background delivery if it detects that the app is not active for a long time.
• The feature is available starting with iOS 15.

​

Setup

​

Enable Background Delivery for the Application Target

• Open XCode with your ios project
• Open the folder of your project in Xcode
• Select the project name in the left sidebar
• Open the Signing & Capabilities section
• Select HealthKit background delivery under the HealthKit section

​

Initialization at Application Startup

import SpikeSDK
...
  override func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey : Any]? = nil) -> Bool {
    ...
    Spike.configure()
    ...
  }
...

​

Android

​

Important Notes About Background Delivery on Android

• Background delivery is scheduled to run every hour, but ultimately, Android decides when the delivery will be executed.
• Android may throttle the frequency of updates for background delivery depending on the app’s activity, battery state, etc.
• Android may stop background delivery if it detects that the app is not active for a long time.
• There is a limit of queries that can be done in Health Connect, and it is different for foreground and background reads, so please request only essential data to be delivered in the background. More information in Health Connect documentation.

​

Setup

<uses-permission android:name="android.permission.health.READ_HEALTH_DATA_IN_BACKGROUND" />

​

Flutter Specific

try {
  final request = await connection.requestHealthPermissions(
      statisticTypes: [StatisticsType.steps],
      includeBackgroundDelivery: true,
  );
} on SpikeException catch (e) {
  log("Error: $e");
}

try {
  await connection.enableBackgroundDelivery(
      statisticTypes: [StatisticsType.steps],
      sleepConfigs: [
        SleepConfig(includeMetricTypes: {MetricType.heartrate})
      ],
  );

} on SpikeException catch (e) {
  log("Error: $e");
}

​

Samsung Health