iOS SDK telepítési útmutató
A Vitalera SDK v2 iOS-hez Swift Package Manager (SPM) segítségével kerül terjesztésre. Felváltja a korábbi CocoaPods terjesztést.
Megjegyzés: Ha v1-ről migrál, távolítsa el a
pod 'VitaleraSdk'sorokat a Podfile-ból.
1. SDK csomag hozzáadása
- Nyissa meg a projektet az Xcode-ban.
- Navigáljon a File > Add Package Dependencies menüpontra.
- Adja meg a repository URL-t:
https://github.com/vitalera/vitalera-sdk.git - Válassza ki a verzió szabályt (pl. "Up to Next Major" a
2.0.0-tól). - Válassza ki a célplatformot és kattintson az Add Package gombra.
2. Termékek kiválasztása
A opció: Összevont termék (leggyorsabb beállítás)
Válassza a VitaleraSdk terméket az összes szolgáltatói modul beépítéséhez:
VitaleraSdk-- tartalmazza a Core, BLE és az összes szolgáltatót
B opció: Egyedi termékek (élesben ajánlott)
Csak a szükséges termékeket válassza ki a bináris méret minimalizálásához:
| Termék | Leírás |
|---|---|
VitaleraSdkCore | Builder, hitelesítés, nyilvántartás, megfigyelés típusok (mindig szükséges) |
VitaleraSdkBle | BLE absztrakció, szabványos BLE profilok (Bluetooth eszközökhöz szükséges) |
VitaleraSdkProviderOmron | Omron vérnyomásmérők, hőmérők |
VitaleraSdkProviderPolar | Polar pulzusmérők (H10, Verity Sense) |
VitaleraSdkProviderLifevit | Lifevit BPM, oximéter, mérleg, hőmérő |
VitaleraSdkProviderBeurer | Beurer BPM, oximéter |
VitaleraSdkProviderSmartPeakFlow | Smart Peak Flow (hangalapú) |
VitaleraSdkProviderHealthKit | Apple HealthKit |
3. Info.plist konfigurálása
Adja hozzá a szükséges Bluetooth használati leírásokat:
<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>
HealthKit integrációhoz adja hozzá a következőket is:
<key>NSHealthShareUsageDescription</key>
<string>This app reads health data from HealthKit.</string>
Valamint engedélyezze a HealthKit képességet az alkalmazás jogosultságaiban:
<key>com.apple.developer.healthkit</key>
<true/>
<key>com.apple.developer.healthkit.access</key>
<array/>
4. Háttérmódok (opcionális)
A háttérben futó BLE műveletekhez engedélyezze a bluetooth-central háttérmódot az Info.plist fájlban:
<key>UIBackgroundModes</key>
<array>
<string>bluetooth-central</string>
</array>
Gyártói SDK követelmények
Egyes szolgáltatói modulok saját gyártói SDK-kat csomagolnak:
- Omron: Az
OmronConnectivityLibrary.xcframeworkszükséges (az Omron partner portálról). Előre épített bináris célként tartalmazza. - Polar: A nyílt forráskódú Polar BLE SDK-t használja (MIT licenc).
- Lifevit: A LifevitSPM-et használja.
- Smart Peak Flow: A saját
MicrophoneSignalProcesskeretrendszert igényli.
Következő lépések
Lásd a Használati útmutatót az SDK inicializálásához és eszközintegrációhoz.