danielfttorres / react-native-wearables

React Native common interface for iOS and Android wearables

React Native Wearables

A React Native module with a common interface for interacting with wearables on iOS and Android.

Getting started

• Browse to your react-native app. (see Demo for a ready made example)

• Install react-native-wearables. npm install react-native-wearables

• Install the peer dependencies. npm install rn-apple-healthkit react-native-google-fitness

• Link the native modules. react-native link

• Edit android/app/src/main/java/.../MainApplication.java. The line that looks like new GoogleFitPackage() should be changed to new GoogleFitPackage(BuildConfig.APPLICATION_ID). (this is a temporary fix to a known react-native limitation)

• Add the following lines to ios//Info.plist – these are what iOS shows your users when requesting access to HealthKit data.

<key>NSHealthShareUsageDescription</key>
<string>Read and understand health data.</string>
<key>NSHealthUpdateUsageDescription</key>
<string>Share workout data with other apps.</string>

• Enable HealthKit in your iOS app's Capabilities in Xcode.

Demo app

Go to yldio/react-native-wearables-demo to check out a super simple demo app that runs on both iOS and Android.

Data

Data is a common interface to the health and fitness data system repositories on iOS and Android, respectively HealthKit and Google Fitness.

It lets you write code like this which works on both iOS and Android.

import { Data } from "react-native-wearables";

Data.authorize([Data.Types.heartRateBpm])
  .then(() =>
    Data.read(Data.Types.heartRateBpm, {
      startDate: new Date("2018-05-01"),
      endDate: new Date("2018-05-09")
    })
  )
  .then(samples => console.log(samples))
  .catch(error => console.error(error));

Motivation

This project builds on the great work of existing iOS- and Android-specific React Native modules to access wearables data on each platform. It abstracts the platform differences into a common interface that makes it easy to create great cross-platform experiences with wearables data.

API Documentation

Data.Types

An object of constants representing each of the data types supported by the module.

• Data.Types.heartRateBpm, heart rate samples, unit is BPM (beats per minute)

Data.authorize(dataTypes)

Launches the OS-specific dialog to request permission from the user to read / write the data types requested.

Example

import { Data } from "react-native-wearables";

Data.authorize([Data.Types.heartRateBpm])
  .then(() => console.log("permission granted"))
  .catch(() => console.log("permission not granted"));

Arguments

• dataTypes, an array of data types constants, found in Data.Types.

Returns

A promise which resolves when and if the user granted the requested permission to your app and rejects if the user cancelled or didn’t grant permission.

Data.read(dataType, options)

Retrieves data samples from HealthKit on iOS and Google Fitness on Android. Will fail if called before Data.authorize has been called with success.

Example

import { Data } from "react-native-wearables";

Data.read(Data.Types.heartRateBpm, {
  startDate: new Date("2018-05-01"),
  endDate: new Date("2018-05-09")
})
  .then(samples => console.log(samples))
  .catch(() => console.log("failed"));

Arguments

• dataType, a data type, found in Data.Types
• options, an object of options - startDate, a Date instance - endDate, a Date instance

Returns

An array of data points, where

• value is a number
• startDate is a Date ISO string
• endDate is a Date ISO string

[
	{
		value: 80,
		startDate: "2018-06-06T13:59:47.375+0100",
		endDate: "2018-06-06T13:59:47.375+0100",
	},
	...
]