Ugrás a fő tartalomra

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

  1. Nyissa meg a projektet az Xcode-ban.
  2. Navigáljon a File > Add Package Dependencies menüpontra.
  3. Adja meg a repository URL-t:
    https://github.com/vitalera/vitalera-sdk.git
  4. Válassza ki a verzió szabályt (pl. "Up to Next Major" a 2.0.0-tól).
  5. 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ékLeírás
VitaleraSdkCoreBuilder, hitelesítés, nyilvántartás, megfigyelés típusok (mindig szükséges)
VitaleraSdkBleBLE absztrakció, szabványos BLE profilok (Bluetooth eszközökhöz szükséges)
VitaleraSdkProviderOmronOmron vérnyomásmérők, hőmérők
VitaleraSdkProviderPolarPolar pulzusmérők (H10, Verity Sense)
VitaleraSdkProviderLifevitLifevit BPM, oximéter, mérleg, hőmérő
VitaleraSdkProviderBeurerBeurer BPM, oximéter
VitaleraSdkProviderSmartPeakFlowSmart Peak Flow (hangalapú)
VitaleraSdkProviderHealthKitApple 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.xcframework szü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 MicrophoneSignalProcess keretrendszert 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.