Migrate From Apple Health or Health Connect

Only use this migration guide if you want to include the both sdks Apple Health and Health Connect in one integration

The current integration of Apple Health and Health Connect is still operational and continues to receive support and updates. The propuse of this is to guide to have only one integration for the both services

Installation

You need to install rook-sdk package and linked properly according to the case in android and iOS

npm

npm i react-native-rook-sdk

Yarn

yarn add react-native-rook-sdk

pnmp

pnpm add react-native-rook-sdk

For iOS you have to run npx pod-install and for android you don't have to do anything else for install.

Configuration

If you have already configured Health Connect and Apple Health services, you don't need to take any further action. However, if you haven't, please refer to the fundamentals documentation for instructions on how to do so.

Imports

-import { RookSyncGate } from 'react-native-rook-sdk-health-connect';
-import { RookSyncGate } from 'react-native-rook-sdk-apple-health';
+import { RookSyncGate } from 'react-native-rook-sdk';

-import {useRookSyncConfiguration} from 'react-native-rook-sdk-health-connect'
-import {useRookConfiguration} from 'react-native-rook-sdk-apple-health'
+import {useRookConfiguration} from 'react-native-rook-sdk'

-import {useRookSyncEvents} from 'react-native-rook-sdk-health-connect'
-import {useRookEvents} from 'react-native-rook-sdk-apple-health'
+import {useRookEvents} from 'react-native-rook-sdk'

-import {useRookSyncPermissions} from 'react-native-rook-sdk-health-connect'
-import {useRookPermissions} from 'react-native-rook-sdk-apple-health'
+import {useRookPermissions} from 'react-native-rook-sdk'

-import {useRookSyncSummaries} from 'react-native-rook-sdk-health-connect'
-import {useRookSummaries} from 'react-native-rook-sdk-apple-health'
+import {useRookSummaries} from 'react-native-rook-sdk'

-import {useRookBackground} from 'react-native-rook-sdk-apple-health'
+import {useRookAppleHealth} from 'react-native-rook-sdk'

RookSyncGate

You no longer need to use both gates. By switching the import to react-native-rook-sdk, you only need one gate to add your credentials.

-import { RookSyncGate } from 'react-native-rook-sdk-health-connect';
-import { RookSyncGate } from 'react-native-rook-sdk-apple-health';
+import { RookSyncGate } from 'react-native-rook-sdk';

export const ExampleComponent = () => {

  return (
    <RookSyncGate
      environment="sandbox"
      clientUUID="YOUR-CREDENTIALS"
      password="YOUR-CREDENTIALS"
    >
      <YOUR-COMPONENTS />
    </RookSyncGate>
  )
}

Manual Sync

Changes for manual sync of summaries

-import {useRookSyncSummaries} from 'react-native-rook-sdk-health-connect'
-import {useRookSummaries} from 'react-native-rook-sdk-apple-health'
+import {useRookSummaries} from 'react-native-rook-sdk'

export const ExampleComponent = () => {

-const rookSummaries = useRookSyncSummaries();
-const rookSummaries = useRookSummaries(); // For Apple Health
+const rookSummaries = useRookSummaries();

  const handleManualSyncSummaries = async () => {
    try {
      await rookSummaries.{pillar-to-sync}()
    }
    catch(error) {
      console.log(error)
    }
  }

  return (
    <Button title="Sync" onPress={handleManualSyncSummaries}/>
  )
}

The rest of the functions of react-native-rook-sdk.useRookSummaries are named as useRookSyncSummaries and react-native-rook-sdk-apple-health.useRookSummaries

Changes for manual sync of Events

-import {useRookSyncEvents} from 'react-native-rook-sdk-health-connect'
-import {useRookEvents} from 'react-native-rook-sdk-apple-health'
+import {useRookEvents} from 'react-native-rook-sdk'

export const ExampleComponent = () => {

-const rookEvents = useRookSyncEvents();
-const rookEvents = useRookEvents(); // For Apple Health
+const rookEvents = useRookEvents();

  const handleManualSyncSummaries = async () => {
    try {
      await rookEvens.{events-to-sync}()
    }
    catch(error) {
      console.log(error)
    }
  }

  return (
    <Button title="Sync" onPress={handleManualSyncSummaries}/>
  )
}

The rest of the functions of react-native-rook-sdk.useRookEvents are named as useRookSyncEvents and react-native-rook-sdk-apple-health.useRookEvents but with an 's' at the end.

const {
  ready,
  syncYesterdayEvents,
  syncTrainingEvent,
  syncBloodGlucoseEvent,
  syncBloodPressureEvent,
  syncBodyMetricsEvent,
  syncBodyHeartRateEvent,
  syncPhysicalHeartRateEvent,
  syncHealthConnectHydrationEvents,
  syncHealthConnectNutritionEvents,
  syncPhysicalOxygenationEvent,
  syncBodyOxygenationEvent,
  syncTemperatureEvent,
  reSyncFailedEvents,
} = useRookEvents();

Background Sync

You need reference how to activete please refer to the documentation

Apple Health

import {useEffect} from 'react'
-import {useRookBackGround} from 'react-native-rook-sdk-apple-health'
+import {useRookAppleHealth} from 'react-native-rook-sdk'

export const ExampleComponent = () => {

-const { enableBackgroundForSummaries, enableBackgroundForEvents } = useRookSyncEvents();
+const { enableBackGroundUpdates } = useRookAppleHealth();

  useEffect(() => {
-enableBackgroundForSummaries().then().cath()
-enableBackgroundForEvents().then().cath()
+enableBackGroundUpdates().then().cath()
  }, [])

  return (
    ...
  )
}

Health Connect

import {useEffect} from 'react'
-import {useRookSyncConfiguration} from 'react-native-rook-sdk-health-connect'
+import {useRookConfiguration} from 'react-native-rook-sdk'

export const ExampleComponent = () => {

-const { sheduleYesterdaySync } = useRookSyncEvents();
+const {scheduleAndroidYesterdaySync} = useRookAppleHealth();

  useEffect(() => {
    scheduleAndroidYesterdaySync().then().cath()
  }, [])

  return (
    ...
  )
}