iOS

The Thryve iOS SDK is the fastest way to implement Thryve's product into your iOS application and is required to allow users to connect Apple Health as a data source. The Thryve iOS SDK is available as Cocoapods and frameworks. It requires:

• Xcode: version 14.2 or later.

• iOS Target: version 14 or higher is recommended.

Integration via Cocoapods

To integrate the Thryve iOS SDK modules via Cocoapods into your application, follow these steps:

1. Add Thryve Specs Repository Open your terminal and navigate to your project directory. Then, execute the following command to add the Thryve Specs repository:

   pod repo add ThryveSpecs https://git.thryve.de/thryve/Specs.git

2. Update Your Podfile Modify your Podfile to include the necessary Thryve SDK modules. Refer to the sample Podfile provided in the Thryve iOS Sample App for guidance.

3. Install Pods Run the following command in your terminal to install the specified pods:

   pod install

Ensure you regularly update the Thryve Specs repository to get the latest features and fixes. For more details, visit the Thryve Specs Git repository: Thryve Specs.

platform :ios, '13.0'
source 'https://git.thryve.de/thryve/Specs.git'

target 'ThryveConnectorSample' do
 
  use_frameworks!

pod 'ThryveCore', '5.1.0'
pod 'ThryveCommons', '5.1.0'
pod 'ThryveAppleHealth', '5.1.0'
pod 'ThryveShenAI', '5.1.0'
pod 'ThryveObservability', '5.1.0'
pod 'ThryveBLE', '5.1.0'

end

Integration via frameworks

If an Undefined symbol: error occurs, ensure that all modules use the same SDK version. For example, ThryveAppleHealth.xcframework (or Pod) version 5.0.2 cannot be used together with ThryveCommons.xcframework (or Pod) version 5.0.4.

App Store Privacy Compliance Configuration

Adding a Privacy Manifest File

Starting May 1, 2024, all apps and third-party SDKs must include the use of required reason API, such as UserDefaults, in their privacy manifest file for App Store Connect approval. Follow these steps:

1. Create a Privacy Manifest File: Ensure your app includes a manifest file.

2. Specify Privacy API Types: Add Privacy Accessed API Types or NSPrivacyAccessedAPITypes to your file.

3. Provide API Reasoning: Under Privacy Accessed API Reasons, or NSPrivacyAccessedAPITypeReasons, list CA92.1 in an array. More details can be found here.

The PrivacyInfo.xcprivacy plist file should look similar to this sample

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
    <key>NSPrivacyAccessedAPITypes</key>
    <array>
        <dict>
            <key>NSPrivacyAccessedAPITypeReasons</key>
            <array>
                <string>CA92.1</string>
            </array>
            <key>NSPrivacyAccessedAPIType</key>
            <string>NSPrivacyAccessedAPICategoryUserDefaults</string>
        </dict>
    </array>
</dict>
</plist>

Apple Health (HealthKit) project configuration

Integrate ThryveAppleHealth module

To add HealthKit to your iOS app:

• Integrate ThryveAppleHealth, along with ThryveCore and ThryveCommons.

• Use either CocoaPods or framework files for installation.

• This setup allows users to connect with Apple Health and retrieve health data automatically.

Add HealthKit to project & configure Info.plist

To be able to build your app with integrated ThryveAppleHealth module you need to:

1. Enable HealthKit

   1. In Xcode: Navigate to Target → Signing & Capabilities → add (+) → HealthKit.

   2. For Background Sync feature to work, ensure Background Delivery is enabled.

1. Update your app's info.plist

<key>NSHealthShareUsageDescription</key>
<string>This app needs permission to share your health data.</string>
<key>NSHealthUpdateUsageDescription</key>
<string>This app needs permission to update your health data.</string>

Although ThryveAppleHealth module does not update data via HealthKit, NSHealthUpdateUsageDescription is required. A missing description will lead to rejection during the App Store review process.

Read the ThryveBLE Set-up guide for additional information on how to set-up the ThryveBLE module

Read the ThryveShenAI Set-up guide for additional information on how to set-up the ThryveShenAI module