@@ -55,7 +53,7 @@ Install the [react-native-apple-healthkit] package from npm:
`npm install react-native-apple-healthkit --save`
##### Xcode
1. In XCode, in the project navigator, right click `Libraries` ➜ `Add Files to [your project's name]`
2. Go to `node_modules` ➜ `react-native-apple-healthkit` and add `RCTAppleHealthKit.xcodeproj`
3. In XCode, in the project navigator, select your project. Add `libRCTAppleHealthKit.a` to your project's `Build Phases` ➜ `Link Binary With Libraries`
Initialize HealthKit. This will show the HealthKit permissions prompt for any read/write permissions set in the required `options` object.
#### **`initHealthKit`**
Initialize HealthKit. This will show the HealthKit permissions prompt for any read/write permissions set in the required `options` object.
Due to Apple's privacy model if an app user has previously denied a specific permission then they can not be prompted again for that same permission. The app user would have to go into the Apple Health app and grant the permission to your react-native app under *sources* tab.
Due to Apple's privacy model if an app user has previously denied a specific permission then they can not be prompted again for that same permission. The app user would have to go into the Apple Health app and grant the permission to your react-native app under *sources* tab.
For any data that is read from HealthKit the status/error is the same for both. This privacy restriction results in having no knowledge of whether the permission was denied (make sure it's added to the permissions options object), or the data for the specific request was nil (ex. no steps recorded today).
...
...
@@ -262,9 +260,9 @@ Get the date of birth.
On success, the callback function will be provided with a `res` object containing dob `value: string` (ISO timestamp), and `age: number` (age in years):
Get the aggregated total steps for a specific day (starting and ending at midnight).
Get the aggregated total steps for a specific day (starting and ending at midnight).
An optional options object may be provided containing `date` field representing the selected day. If `date` is not set or an options object is not provided then the current day will be used.
An optional options object may be provided containing `date` field representing the selected day. If `date` is not set or an options object is not provided then the current day will be used.
Get the total steps per day over a specified date range.
Get the total steps per day over a specified date range.
`getDailyStepCountSamples` accepts an options object containing required *`startDate: ISO8601Timestamp`* and optional *`endDate: ISO8601Timestamp`*. If `endDate` is not provided it will default to the current time
```javascript
...
...
@@ -348,7 +312,7 @@ let options = {
```
The function will be called with an array of elements. Each element is an object containing `value`, `startDate`, and `endDate` fields:
@@ -375,32 +339,69 @@ The function will be called with an array of elements. Each element is an object
___
#### ~~**`getMultiDayStepCounts`**~~
**removed** - replaced by `getDailyStepCountSamples`
#### **`initStepCountObserver`**
Setup an HKObserverQuery for step count (HKQuantityTypeIdentifierStepCount) that will
trigger an event listenable on react-native `NativeAppEventEmitter` when the
HealthKit step count has changed.
Get the total steps per day over a specified date range.
The `initStepCountObserver` method must be called before adding a listener to
NativeAppEventEmitter. After the step count observer has been initialized you can
listen to the NativeAppEventEmitter `change:steps` event and re-fetch relevent
step count data in the event handler.
The `initStepCountObserver` method should be called after HealthKit has been
successfully initialized (AppleHealthKit.initHealthKit has been called without
error).
`getMultiDayStepCounts` accepts an options object containing required *`startDate: ISO8601Timestamp`* and optional *`endDate: ISO8601Timestamp`*. if `endDate` is not provided it will default to the current time
Get the total distance walking/running on a specific day.
Get the total distance walking/running on a specific day.
`getDistanceWalkingRunning` accepts an options object containing optional *`date: ISO8601Timestamp`* and *`unit: string`*. If `date` is not provided it will default to the current time. `unit` defaults to `meter`.
`getDistanceCycling` accepts an options object containing optional *`date: ISO8601Timestamp`* and *`unit: string`*. If `date` is not provided it will default to the current time. `unit` defaults to `meter`
get the total flights climbed (1 flight is ~10ft of elevation) on a specific day.
get the total flights climbed (1 flight is ~10ft of elevation) on a specific day.
`getFlightsClimbed` accepts an options object containing optional *`date: ISO8601Timestamp`*. if `date` is not provided it will default to the current time.
```javascript
...
...
@@ -504,7 +505,7 @@ On success, the callback function will be provided with a `weight` object contai
```javascript
{
value:200,
startDate:'2016-07-08T12:00:00.000-0400',
startDate:'2016-07-08T12:00:00.000-0400',
endDate:'2016-07-08T12:00:00.000-0400'
}
```
...
...
@@ -570,7 +571,7 @@ On success, the callback function will be provided with a `height` object contai
On success, the callback function will be provided with a `bmi` object containing the BMI `value`, and the `startDate` and `endDate` of the sample. *Note: startDate and endDate will be the same as bmi samples are saved at a specific point in time.*
```javascript
{
value:27.2,
startDate:'2016-07-08T12:00:00.000-0400',
startDate:'2016-07-08T12:00:00.000-0400',
endDate:'2016-07-08T12:00:00.000-0400'
}
```
...
...
@@ -690,7 +691,7 @@ On success, the callback function will be provided with a `bodyFatPercentage` ob
```javascript
{
value:20,
startDate:'2016-07-08T12:00:00.000-0400',
startDate:'2016-07-08T12:00:00.000-0400',
endDate:'2016-07-08T12:00:00.000-0400'
}
```
...
...
@@ -713,7 +714,7 @@ On success, the callback function will be provided with a `leanBodyMass` object
