Data sync

SyncProgressList displays the current status and record counts for each configured data type. Pass a map keyed by the data type and update it as the sync run advances:

SyncProgressList(
  progress: const {
    'heartRate': SyncProgress(
      measurementTypeKey: 'heartRate',
      status: SyncProgressStatus.syncing,
      progress: SyncProgressCounts(done: 84, total: 120, created: 78),
    ),
  },
)

The widget humanizes data type keys by default. Provide labelForType, statusLabels, and reasonLabels to supply app-specific labels and translations. A missing or empty progress map renders no rows.

Health data modesCopy Anchor Link

getHealthDataMode returns the Native SDK default for a health sync key. Pass configuredMode to override it. HealthDataType supplies the keys for health-only types that are not Core measurement services.

final mode = getHealthDataMode('stepCount');
final sleepMode = getHealthDataMode(
  HealthDataType.sleep.key,
  configuredMode: HealthDataMode.point,
);

Step counts, distance, active energy, flights climbed, exercise minutes, water, carbohydrates, and calories eaten default to dailyTotal; heart rate and heart-rate summaries default to dailySummary; sleep and workouts default to session. Other keys, including blood alcohol and insulin, default to point. series is available for explicitly configured time-series imports.

Health sync configurationCopy Anchor Link

HealthSyncConfiguration mirrors the Native SDK's data sync settings. It maps each sync key to the platform identifiers to read and the optional observation coding, date limit, and aggregation mode. The same settings carry the record page size, Wi-Fi preference, and progress or error callbacks.

final configuration = HealthSyncConfiguration<String>(
  dataToSync: {
    'heartRate': HealthSyncTypeConfiguration(
      typeIdentifiers: const [
        HealthSyncTypeIdentifier(
          typeIdentifier: 'HKQuantityTypeIdentifierHeartRate',
          code: '8867-4',
          system: 'http://loinc.org',
          display: 'Heart rate',
        ),
      ],
      mode: HealthDataMode.dailySummary,
    ),
  },
);

The default chunk size is 5000 records and Wi-Fi-only syncing is off. Platform adapters provide the identifiers and read the configured records.

Health import accessCopy Anchor Link

HealthImportController mirrors the Native SDK's useHealthImport state for Flutter apps. Supply an adapter for the app's health source; the controller tracks access and requests it when import is enabled, while health data reading stays with that adapter.

final healthImportController = HealthImportController(
  types: const ['heartRate', 'stepCount'],
  adapter: healthImportAdapter,
  background: true,
);

await healthImportController.refresh();
await healthImportController.setEnabled(true);

Listen to the controller to update the UI. statusByType contains the last successful access status for each type, notShared lists refused types, and error contains the last status-check or access-request error. Dispose the controller when its owner is removed.

Wrap the widgets that need access state in HealthImportProvider. Descendants read the nearest controller with HealthImportProvider.of; they rebuild when its state changes:

HealthImportProvider<String>(
  controller: healthImportController,
  child: Builder(
    builder: (context) {
      final healthImport = HealthImportProvider.of<String>(context);
      return Text(healthImport.enabled ? 'Enabled' : 'Disabled');
    },
  ),
)