sarthakjha889 / react-native-fitness

A React Native module to interact with Apple Healthkit and Google Fit.

react-native-fitness

react-native-fitness is a library that works on both iOS and Android with it you can interact with Apple Healthkit and Google Fit. Currently the lib provides a set of API that you can use to read steps count or distance count for a given period of time.

Note: We're open to receive PRs that contains new features or improvements, so feel free to contribute to this repo.

Getting started

npm install @ovalmoney/react-native-fitness --save

or

yarn add @ovalmoney/react-native-fitness

Mostly automatic installation

$ react-native link @ovalmoney/react-native-fitness

Manual installation

iOS

Pods

1. Add the line below to your podfile then run pod install pod 'react-native-fitness', :path => '../node_modules/@ovalmoney/react-native-fitness'
2. In XCode, in the project navigator, select your project. Add libreact-native-fitness.a to your project's Build Phases ➜ Link Binary With Libraries
3. Add NSHealthShareUsageDescription to your Info.plist in order to ask permissions.

Manually

1. In XCode, in the project navigator, right click Libraries ➜ Add Files to [your project's name]
2. Go to node_modules ➜ react-native-fitness and add RNFitness.xcodeproj
3. In XCode, in the project navigator, select your project. Add libRNFitness.a to your project's Build Phases ➜ Link Binary With Libraries
4. Run your project (Cmd+R)<

In order to make it run, it is necessary to turn on Health Kit in the Capabilities.

Android

1. Get an OAuth 2.0 Client ID as explained at https://developers.google.com/fit/android/get-api-key
2. Open up android/app/src/main/java/[...]/MainActivity.java

• Add import com.oval.fitness.RNFitnessPackage; to the imports at the top of the file
• Add new RNFitnessPackage() to the list returned by the getPackages() method

3. Append the following lines to android/settings.gradle:

   include ':@ovalmoney_react-native-fitness'
   project(':@ovalmoney_react-native-fitness').projectDir = new File(rootProject.projectDir, 	'../node_modules/@ovalmoney/react-native-fitness/android')
   

4. Insert the following lines inside the dependencies block in android/app/build.gradle:

     compile project(':@ovalmoney_react-native-fitness')
   

Usage

import Fitness from '@ovalmoney/react-native-fitness';

Fitness.isAuthorized()
  .then((authorized) => {
    //Do something
  })
  .catch((error) => {
    //Do something
  });

API

• Fitness.isAuthorized() Check if permissions are granted or not. It works on Android and iOS >= 12.0, while it returns an error when iOS < 12.

• Fitness.requestPermissions() Ask permission and return if user granted or not(Android), while, due to Apple's privacy model, always true is returned in iOS.

• Fitness.getSteps(dates: { startDate: string, endDate: string, interval: string }) Fetch steps on a given period of time. It requires an Object with startDate and endDate attributes as string. If startDate is not provided an error will be thrown. Set interval to decide how detailed the returned data is, set it to hour otherwise it defaults to days.

• Fitness.getDistance(dates: { startDate: string, endDate: string, interval: string }) Fetch distance in meters on a given period of time. It requires an Object with startDate and endDate attributes as string. If startDate is not provided an error will be thrown. Set interval to decide how detailed the returned data is, set it to hour otherwise it defaults to days.

• Fitness.getCalories(dates: { startDate: string, endDate: string }) Fetch calories burnt in kilocalories on a given period of time. It requires an Object with startDate and endDate attributes as string. If startDate is not provided an error will be thrown.

• Fitness.subscribeToActivity() Available only on android. Subscribe to all Google Fit activities. It returns a promise with true for a successful subscription and false otherwise. Call this function to get all google fit activites and eliminate the need to have Google Fit installed on the device.

• Fitness.subscribeToSteps() Available only on android. Subscribe only to steps from the Google Fit store. It returns a promise with true for a successful subscription and false otherwise. Call this function to get steps and eliminate the need to have Google Fit installed on the device.

Attributes

• Platform Return the used provider.