iOS SDK Installationsleitfaden
Das Vitalera SDK v2 fuer iOS wird ueber Swift Package Manager (SPM) verteilt. Es ersetzt die vorherige CocoaPods-Distribution.
Hinweis: Wenn Sie von v1 migrieren, entfernen Sie alle
pod 'VitaleraSdk'-Zeilen aus Ihrem Podfile.
1. SDK-Paket hinzufuegen
- Oeffnen Sie Ihr Projekt in Xcode.
- Navigieren Sie zu File > Add Package Dependencies.
- Geben Sie die Repository-URL ein:
https://github.com/vitalera/vitalera-sdk.git - Waehlen Sie die Versionsregel (z.B. "Up to Next Major" ab
2.0.0). - Waehlen Sie Ihr Ziel und klicken Sie auf Add Package.
2. Produkte auswaehlen
Option A: Umbrella-Produkt (schnellste Einrichtung)
Waehlen Sie das VitaleraSdk-Produkt, um alle Anbietermodule einzuschliessen:
VitaleraSdk-- enthaelt Core, BLE und alle Anbieter
Option B: Einzelne Produkte (empfohlen fuer die Produktion)
Waehlen Sie nur die Produkte, die Sie benoetigen, um die Binaergroesse zu minimieren:
| Produkt | Beschreibung |
|---|---|
VitaleraSdkCore | Builder, Auth, Registry, Beobachtungstypen (immer erforderlich) |
VitaleraSdkBle | BLE-Abstraktion, Standard-BLE-Profile (erforderlich fuer Bluetooth-Geraete) |
VitaleraSdkProviderOmron | Omron-Blutdruckmessgeraete, Thermometer |
VitaleraSdkProviderPolar | Polar-Herzfrequenzmesser (H10, Verity Sense) |
VitaleraSdkProviderLifevit | Lifevit BPM, Oximeter, Waage, Thermometer |
VitaleraSdkProviderBeurer | Beurer BPM, Oximeter |
VitaleraSdkProviderSmartPeakFlow | Smart Peak Flow (audiobasiert) |
VitaleraSdkProviderHealthKit | Apple HealthKit |
3. Info.plist konfigurieren
Fuegen Sie die erforderlichen Bluetooth-Verwendungsbeschreibungen hinzu:
<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>
Fuer die HealthKit-Integration fuegen Sie auch hinzu:
<key>NSHealthShareUsageDescription</key>
<string>This app reads health data from HealthKit.</string>
Und aktivieren Sie die HealthKit-Berechtigung in den Entitlements Ihrer App:
<key>com.apple.developer.healthkit</key>
<true/>
<key>com.apple.developer.healthkit.access</key>
<array/>
4. Hintergrundmodi (Optional)
Fuer BLE-Operationen im Hintergrund aktivieren Sie den bluetooth-central-Hintergrundmodus in Ihrer Info.plist:
<key>UIBackgroundModes</key>
<array>
<string>bluetooth-central</string>
</array>
Hersteller-SDK-Anforderungen
Einige Anbietermodule umschliessen proprietaere Hersteller-SDKs:
- Omron: Erfordert
OmronConnectivityLibrary.xcframework(vom Omron-Partnerportal). Als vorkompiliertes Binary Target enthalten. - Polar: Verwendet das Open-Source Polar BLE SDK (MIT-Lizenz).
- Lifevit: Verwendet LifevitSPM.
- Smart Peak Flow: Erfordert das proprietaere
MicrophoneSignalProcess-Framework.
Naechste Schritte
Siehe den Verwendungsleitfaden fuer SDK-Initialisierung und Geraeteintegration.