Repository files navigation

Flutter plugin for reading step count data. Wraps HealthKit on iOS and GoogleFit on Android.

👉Korean

Check out the example directory for a sample app.

To use this plugin, addfitness as adependency in your pubspec.yaml file.

Enable Fitness API and obtain an OAuth 2.0 client ID.

Enable HealthKit and add NSHealthShareUsageDescription key to the Info.plist file.

Check if the user has previously granted the necessary data access.

Note:Quite rightly so, Apple deems even the information as to whether a user accepted or denied the read permission for HealthKit as sensitive information.For this reason, HealthKit does not have a clear way to check permissions.

As a workaround, it checks whether you can read data within the last month or not to see if you actually have read access.

void_hasPermission()async {final result=awaitFitness.hasPermission();}

Initiate the authorization flow.

• Android: Request OAuth permission and request permission to read step count history from Google Fit. It also creates a subscription to synchronize step count data.

• iOS: Request permission to read step count history from Health Kit. Since it returns whether the request forHKHealthStore.requestAuthorization was successful or not, it is recommended to useFitness.hasPermission in the case of iOS to check if there is permission again.

void_requestPermission()async {final result=awaitFitness.requestPermission();}

• Android: All OAuth permissions granted to Googlt Fit are revoked and all subscriptions created in the app are removed.

• iOS: Feature is not supported, so it always returns true.

void_revokePermission()async {final result=awaitFitness.revokePermission();}

Requests user's step data with Google Fit or Health Kit.

When requested without any arguments, the daily step count is requested by default.

• timeRange
  • defaults: from 00:00:00 to 23:59:59
  • type:TimeRange [class]
• bucketByTime
  • defaults: 1
  • type:int
• timeUnit
  • defaults: TimeUnit.day
  • type:TimeUnit [enum]

// Request data for the last 7 days.void_read()async {final now=DateTime.now();final results=awaitFitness.read(    timeRange:TimeRange(      start: now.subtract(constDuration(days:7)),      end: now,    ),    bucketByTime:1,    timeUnit:TimeUnit.days,  );}