Saltar al contenido principal

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

El SDK v2 de vitalera se distribuye mediante Maven (GitHub Packages). Añada el repositorio y los módulos que su aplicación necesita.

1. Añadir el repositorio Maven​

En el archivo settings.gradle.kts (o build.gradle) de nivel de proyecto, añada el repositorio Maven de vitalera:

dependencyResolutionManagement {
    repositories {
        google()
        mavenCentral()
        maven {
            url = uri("https://maven.pkg.github.com/HumanITcare/vitalera-sdk")
            credentials {
                username = System.getenv("GITHUB_ACTOR")
                    ?: providers.gradleProperty("gpr.user").orNull
                password = System.getenv("GITHUB_TOKEN")
                    ?: providers.gradleProperty("gpr.key").orNull
            }
        }
    }
}

2. Añadir dependencias​

Opción A: Módulo umbrella (configuración más rápida)​

El módulo umbrella incluye sdk-core, sdk-ble y todos los módulos de proveedores como dependencias transitivas:

dependencies {
    implementation("com.vitalera:sdk-android:2.0.6")
}

Opción B: Módulos individuales (recomendado para producción)​

Seleccione solo los módulos que necesite para minimizar el tamaño del binario y evitar empaquetar SDKs de fabricantes no utilizados:

dependencies {
    // Always required
    implementation("com.vitalera:sdk-core:2.0.6")

    // Add BLE layer if using any Bluetooth device
    implementation("com.vitalera:sdk-ble:2.0.6")

    // Add only the providers you need
    implementation("com.vitalera:provider-omron:2.0.6")
    implementation("com.vitalera:provider-polar:2.0.6")
    implementation("com.vitalera:provider-lifevit:2.0.6")
    implementation("com.vitalera:provider-beurer:2.0.6")
    implementation("com.vitalera:provider-smart-peak-flow:2.0.6")
    implementation("com.vitalera:provider-health-connect:2.0.6")
}

Referencia de módulos​

MóduloArtefactoDescripción
sdk-corecom.vitalera:sdk-coreBuilder, autenticación, registro, tipos de observación (siempre requerido)
sdk-blecom.vitalera:sdk-bleAbstracción BLE, perfiles BLE estándar (requerido para dispositivos Bluetooth)
provider-omroncom.vitalera:provider-omronTensiómetros Omron, termómetros
provider-polarcom.vitalera:provider-polarMonitores de frecuencia cardíaca Polar (H10, Verity Sense)
provider-lifevitcom.vitalera:provider-lifevitTensiómetro, pulsioxímetro, báscula y termómetro Lifevit
provider-beurercom.vitalera:provider-beurerTensiómetro y pulsioxímetro Beurer
provider-smart-peak-flowcom.vitalera:provider-smart-peak-flowSmart Peak Flow (basado en audio)
provider-health-connectcom.vitalera:provider-health-connectAndroid Health Connect
sdk-androidcom.vitalera:sdk-androidUmbrella: todos los proveedores incluidos

3. Configurar permisos​

Añada los permisos Bluetooth requeridos en su AndroidManifest.xml:

<!-- Android 12+ (API 31+) -->
<uses-permission android:name="android.permission.BLUETOOTH_SCAN" />
<uses-permission android:name="android.permission.BLUETOOTH_CONNECT" />
<uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />

<!-- Android 11 and below -->
<uses-permission android:name="android.permission.BLUETOOTH" />
<uses-permission android:name="android.permission.BLUETOOTH_ADMIN" />
<uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />

4. Seguridad de credenciales​

Almacene sus credenciales de GitHub Packages en local.properties (no se sube al control de versiones) o utilice variables de entorno:

# local.properties
gpr.user=your-github-username
gpr.key=ghp_your-github-token

Asegúrese de que local.properties está en su .gitignore.

Siguientes pasos​

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