Install vitalera iOS SDK v2 for Medical Device Integration
The Vitalera SDK v2 for iOS is distributed via Swift Package Manager (SPM). It replaces the previous CocoaPods distribution.
Note: If migrating from v1, remove any
pod 'VitaleraSdk'lines from your Podfile.
1. Add the SDK Package
- Open your project in Xcode.
- Navigate to File > Add Package Dependencies.
- Enter the repository URL:
https://github.com/vitalera/vitalera-sdk.git - Select the version rule (e.g., "Up to Next Major" from
2.0.0). - Choose your target and click Add Package.
2. Select Products
Option A: Umbrella Product (quickest setup)
Select the VitaleraSdk product to include all provider modules:
VitaleraSdk-- includes Core, BLE, and all providers
Option B: Individual Products (recommended for production)
Select only the products you need to minimize binary size:
| Product | Description |
|---|---|
VitaleraSdkCore | Builder, auth, registry, observation types (always required) |
VitaleraSdkBle | BLE abstraction, standard BLE profiles (required for Bluetooth devices) |
VitaleraSdkProviderOmron | Omron blood pressure monitors, thermometers |
VitaleraSdkProviderPolar | Polar heart rate monitors (H10, Verity Sense) |
VitaleraSdkProviderLifevit | Lifevit BPM, oximeter, scale, thermometer |
VitaleraSdkProviderBeurer | Beurer BPM, oximeter |
VitaleraSdkProviderSmartPeakFlow | Smart Peak Flow (audio-based) |
VitaleraSdkProviderHealthKit | Apple HealthKit |
3. Configure Info.plist
Add the required Bluetooth usage descriptions:
<key>NSBluetoothAlwaysUsageDescription</key>
<string>This app uses Bluetooth to connect with medical devices.</string>
<key>NSBluetoothPeripheralUsageDescription</key>
<string>This app uses Bluetooth to communicate with devices.</string>
For HealthKit integration, also add:
<key>NSHealthShareUsageDescription</key>
<string>This app reads health data from HealthKit.</string>
And enable the HealthKit capability in your app's entitlements:
<key>com.apple.developer.healthkit</key>
<true/>
<key>com.apple.developer.healthkit.access</key>
<array/>
4. Background Modes (Optional)
For background BLE operations, enable the bluetooth-central background mode in your Info.plist:
<key>UIBackgroundModes</key>
<array>
<string>bluetooth-central</string>
</array>
Vendor SDK Requirements
Some provider modules integrate with vendor-specific SDKs:
- Omron: Requires Omron's partner SDK (available from the Omron partner portal). Included as a pre-built binary target.
- Polar: Integrated with Polar's BLE SDK (open-source, MIT license).
- Lifevit: Integrated with Lifevit's SDK.
- Smart Peak Flow: Requires Smart Peak Flow's proprietary SDK.
Next Steps
See the Usage Guide for SDK initialization and device integration.