Saltar al contenido principal

Instalar el SDK iOS v2 de vitalera para integración de dispositivos médicos

El SDK v2 de vitalera para iOS se distribuye mediante Swift Package Manager (SPM). Reemplaza la distribución anterior por CocoaPods.

Nota: Si migra desde v1, elimine cualquier línea pod 'VitaleraSdk' de su Podfile.

1. Añadir el paquete SDK

  1. Abra su proyecto en Xcode.
  2. Navegue a File > Add Package Dependencies.
  3. Introduzca la URL del repositorio:
    https://github.com/vitalera/vitalera-sdk.git
  4. Seleccione la regla de versión (p. ej., "Up to Next Major" desde 2.0.0).
  5. Elija su target y haga clic en Add Package.

2. Seleccionar productos

Opción A: Producto umbrella (configuración más rápida)

Seleccione el producto VitaleraSdk para incluir todos los módulos de proveedores:

  • VitaleraSdk — incluye Core, BLE y todos los proveedores

Opción B: Productos individuales (recomendado para producción)

Seleccione solo los productos que necesite para minimizar el tamaño del binario:

ProductoDescripción
VitaleraSdkCoreBuilder, autenticación, registro, tipos de observación (siempre requerido)
VitaleraSdkBleAbstracción BLE, perfiles BLE estándar (requerido para dispositivos Bluetooth)
VitaleraSdkProviderOmronTensiómetros Omron, termómetros
VitaleraSdkProviderPolarMonitores de frecuencia cardíaca Polar (H10, Verity Sense)
VitaleraSdkProviderLifevitTensiómetro, pulsioxímetro, báscula y termómetro Lifevit
VitaleraSdkProviderBeurerTensiómetro y pulsioxímetro Beurer
VitaleraSdkProviderSmartPeakFlowSmart Peak Flow (basado en audio)
VitaleraSdkProviderHealthKitApple HealthKit

3. Configurar Info.plist

Añada las descripciones de uso de Bluetooth requeridas:

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

Para la integración con HealthKit, añada también:

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

Y habilite la capacidad HealthKit en los entitlements de su aplicación:

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

4. Modos en segundo plano (opcional)

Para operaciones BLE en segundo plano, habilite el modo en segundo plano bluetooth-central en su Info.plist:

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

Requisitos de SDKs de fabricantes

Algunos módulos de proveedores se integran con SDKs específicos de fabricantes:

  • Omron: Requiere el SDK de partners de Omron (disponible en el portal de partners de Omron). Incluido como un binary target precompilado.
  • Polar: Integrado con el SDK BLE de Polar (código abierto, licencia MIT).
  • Lifevit: Integrado con el SDK de Lifevit.
  • Smart Peak Flow: Requiere el SDK propietario de Smart Peak Flow.

Siguientes pasos

Consulte la Guía de uso para la inicialización del SDK e integración de dispositivos.