React Native

Thryve provides React Native SDK and modules that are using the Thryve native SDKs.

The React Native wrapper for the native SDKs supports all functionalities of the native SDKs unless stated differently.

Configuration of projects

The SDK supports both React Native CLI and React Native Expo projects. Follow the guide below to configure your project.

In the package.json file, include dependencies by specifying the path to each within your project. Ensure that @thryve/react-native-core-sdk is included, as it is a prerequisite for all optional modules or packages.

"dependencies": {
    "@thryve/react-native-sdk": "file:../../thryve-react-native-sdk-5.0.1.tgz",
    "@thryve/react-native-apple-health-module": "file:../../thryve-react-native-apple-health-module-5.0.1.tgz",
    "@thryve/react-native-health-connect-module": "file:../../thryve-react-native-health-connect-module-5.0.1.tgz",
    "@thryve/react-native-shealth-module": "file:../../thryve-react-native-shealth-module-5.0.1.tgz",
     "@thryve/react-native-shenai-module": "file:../../thryve-react-native-shenai-module-5.0.1.tgz",
    "react": "19.0.0",
    "react-native": "0.78.2"
},
"devDependencies": {
     "@types/react": "^19.0.0",
},

Run below commands to install all necessary dependencies defined in your package.json file, ensuring that your project has all the modules it requires:

Run npm install or yarn install
Run cd ios && pod install && cd ..

For more details refer to the sample code demonstrating the SDK configuration.

To integrate the Thryve React Native SDK into an Expo project, follow the specific setup instructions tailored for Expo environments.

This process involves modifying configuration files to include necessary plugins and permissions, ensuring seamless interaction with health data across Android and iOS platforms.

Install expo-build-properties in your project to allow for configuration of android/gradle.properties and ios/Podfile.properties.json directories during prebuild required to make the SDK and it's module run. Refer to documentation for details.
Configure native build properties, by include the expo-build-properties plugin in your project configuration file (app.config.ts, app.config.js, or app.json).

"plugins": [
    ...
      [
        "expo-build-properties",
        {
          "android": {
            "compileSdkVersion": 34,
            "targetSdkVersion": 34,
            "buildToolsVersion": "35.0.0",
            "extraMavenRepos": [
              {
                "url": "https://nexus.external.thryve.de/repository/releases/",
                "credentials": {
                  "username": "PUT_NEXUS_USERNAME_HERE",
                  "password": "PUT_NEXUS_PASSWORD_HERE"
                }
              }
            ],
            "manifestQueries": {
              "package": [
                //If you are integrating Health Connect add
                "com.google.android.apps.healthdata", 
                //If you are integrating Google Fit add
                "com.google.android.apps.fitness",
                //If you are integrating Samsung Health add
                "com.samsung.health",
                "com.sec.android.app.shealth"
              ]
            },
            "permissions": [
                //Add the Health Connect permissions you are interested here.
              "android.permission.health.READ_HEART_RATE"
            ]
          },
          "ios": {
            "extraPods": [
              {
                "name": "ThryveCore",
                "source": "https://git.thryve.de/thryve/Specs.git"
              },
              {
                "name": "ThryveAppleHealth",
                "source": "https://git.thryve.de/thryve/Specs.git"
              },
              {
                "name": "ThryveShenAI",
                "source": "https://git.thryve.de/thryve/Specs.git"
              }
            ],
            "entitlements": {
              "com.apple.developer.healthkit": true,
              "com.apple.developer.healthkit.background-delivery": true
            },
            "infoPlist": {
              "NSHealthShareUsageDescription": " Allow to share your health data",
              "NSHealthUpdateUsageDescription": "Allow to update your health data",
              "UIBackgroundModes": [
                "fetch"
              ]
            },
            "privacyManifests": {
              "NSPrivacyAccessedAPITypes": [
                {
                  "NSPrivacyAccessedAPIType": "NSPrivacyAccessedAPICategorySystemBootTime",
                  "NSPrivacyAccessedAPITypeReasons": [
                    "CA92.1"
                  ]
                },
                {
                  "NSPrivacyAccessedAPIType": "NSPrivacyAccessedAPICategoryUserDefaults",
                  "NSPrivacyAccessedAPITypeReasons": [
                    "CA92.1"
                  ]
                }
              ]
            }
          }
        }
      ]
      ...
    ]

Configurations specific to native plattforms

When developing applications with React Native that utilize Thryve's SDKs, platform-specific configurations might be required to ensure seamless integration and functionality across iOS and Android devices.

When building for iOS, you might encounter the following error: RCT-Folly/folly/portability/Time.h:52:17: Typedef redefinition with different types ('uint8_t' (aka 'unsigned char') vs 'enum clockid_t')

To resolve the error, add the following line to your Podfile under post_install:

`sed -i -e $'s/__IPHONE_10_0/__IPHONE_13_0/' Pods/RCT-Folly/folly/portability/Time.h`

If this does not resolve the issue, navigate to ios/Pods/RCT-Folly/folly/portability/Time.h and comment out the line:

typedef uint8_t clockid_t;

To integrate the Thryve React Native SDK plugins for Android, follow these steps to set up the credentials for the Thryve private repository. This will allow your project to access the necessary dependencies.

Navigate to your Android app's root Gradle file (e.g., '../sample/android/build.gradle').
Locate the repositories section.
Add the Thryve repository below mavenCentral() or after the last repository listed.

This setup ensures your project can retrieve the required dependencies from the Thryve repository.

build.gradle

allprojects {
    repositories {
        google()
        mavenCentral()
        ....
        maven {
        url "https://nexus.external.thryve.de/repository/releases/"
        credentials {
            username = thryveUsername
            password = thryvePassword
        }
        ....
}

gradle.properties

thryveUsername=YOUR_SDK_CREDENTIAL_USER
thryvePassword=YOUR_SDK_CREDENTIAL_PASSWORD

Keep sensitive information out of your repositories by storing credentials in the local.properties file or the global Gradle properties.

PreviousAndroid NextFlutter

Last updated 1 month ago

hashtagConfiguration of projects

hashtagConfigurations specific to native plattforms

Configuration of projects

Configurations specific to native plattforms