Saltar al contingut principal

Instal·lar el SDK iOS v2 de vitalera per a integració de dispositius mèdics

El Vitalera SDK v2 per a iOS es distribueix via Swift Package Manager (SPM). Substitueix la distribució anterior via CocoaPods.

Nota: Si esteu migrant des de v1, elimineu qualsevol línia pod 'VitaleraSdk' del vostre Podfile.

1. Afegir el paquet del SDK

  1. Obriu el vostre projecte a Xcode.
  2. Navegueu a File > Add Package Dependencies.
  3. Introduïu l'URL del repositori:
    https://github.com/vitalera/vitalera-sdk.git
  4. Seleccioneu la regla de versió (p. ex., "Up to Next Major" des de 2.0.0).
  5. Trieu el vostre target i feu clic a Add Package.

2. Seleccionar productes

Opció A: Producte umbrella (configuració més ràpida)

Seleccioneu el producte VitaleraSdk per incloure tots els mòduls de proveïdors:

  • VitaleraSdk -- inclou Core, BLE i tots els proveïdors

Opció B: Productes individuals (recomanat per a producció)

Seleccioneu només els productes que necessiteu per minimitzar la mida del binari:

ProducteDescripció
VitaleraSdkCoreBuilder, autenticació, registre, tipus d'observació (sempre requerit)
VitaleraSdkBleAbstracció BLE, perfils BLE estàndard (requerit per a dispositius Bluetooth)
VitaleraSdkProviderOmronMonitors de pressió arterial Omron, termòmetres
VitaleraSdkProviderPolarMonitors de freqüència cardíaca Polar (H10, Verity Sense)
VitaleraSdkProviderLifevitLifevit BPM, pulsioxímetre, bàscula, termòmetre
VitaleraSdkProviderBeurerBeurer BPM, pulsioxímetre
VitaleraSdkProviderSmartPeakFlowSmart Peak Flow (basat en àudio)
VitaleraSdkProviderHealthKitApple HealthKit

3. Configurar Info.plist

Afegiu les descripcions d'ús de Bluetooth necessàries:

<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>

Per a la integració HealthKit, afegiu també:

<key>NSHealthShareUsageDescription</key>
<string>This app reads health data from HealthKit.</string>

I habiliteu la capacitat HealthKit als entitlements de la vostra app:

<key>com.apple.developer.healthkit</key>
<true/>
<key>com.apple.developer.healthkit.access</key>
<array/>

4. Modes en segon pla (opcional)

Per a operacions BLE en segon pla, habiliteu el mode en segon pla bluetooth-central al vostre Info.plist:

<key>UIBackgroundModes</key>
<array>
<string>bluetooth-central</string>
</array>

Requisits de SDK de fabricant

Alguns mòduls de proveïdors s'integren amb SDKs específics del fabricant:

  • Omron: Requereix el SDK de soci d'Omron (disponible al portal de socis d'Omron). Inclòs com a binary target preconstruït.
  • Polar: Integrat amb el SDK BLE de Polar (codi obert, llicència MIT).
  • Lifevit: Integrat amb el SDK de Lifevit.
  • Smart Peak Flow: Requereix el SDK propietari de Smart Peak Flow.

Passos següents

Consulteu la Guia d'ús per a la inicialització del SDK i la integració de dispositius.