Saltar al contingut principal

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

El Vitalera SDK v2 es distribueix via Maven (GitHub Packages). Afegiu el repositori i els mòduls que la vostra app necessita.

1. Afegir el repositori Maven​

Al fitxer settings.gradle.kts (o build.gradle) a nivell de projecte, afegiu el repositori 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. Afegir dependències​

Opció A: Mòdul umbrella (configuració més ràpida)​

El mòdul umbrella inclou sdk-core, sdk-ble i tots els mòduls de proveïdors com a dependències transitives:

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

Opció B: Mòduls individuals (recomanat per a producció)​

Trieu només els mòduls que necessiteu per minimitzar la mida del binari i evitar incloure SDKs de fabricants no utilitzats:

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")
}

Referència de mòduls​

MòdulArtefacteDescripció
sdk-corecom.vitalera:sdk-coreBuilder, autenticació, registre, tipus d'observació (sempre requerit)
sdk-blecom.vitalera:sdk-bleAbstracció BLE, perfils BLE estàndard (requerit per a dispositius Bluetooth)
provider-omroncom.vitalera:provider-omronMonitors de pressió arterial Omron, termòmetres
provider-polarcom.vitalera:provider-polarMonitors de freqüència cardíaca Polar (H10, Verity Sense)
provider-lifevitcom.vitalera:provider-lifevitLifevit BPM, pulsioxímetre, bàscula, termòmetre
provider-beurercom.vitalera:provider-beurerBeurer BPM, pulsioxímetre
provider-smart-peak-flowcom.vitalera:provider-smart-peak-flowSmart Peak Flow (basat en àudio)
provider-health-connectcom.vitalera:provider-health-connectAndroid Health Connect
sdk-androidcom.vitalera:sdk-androidUmbrella: tots els proveïdors inclosos

3. Configurar permisos​

Afegiu els permisos Bluetooth necessaris al vostre 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. Seguretat de credencials​

Emmagatzemeu les vostres credencials de GitHub Packages a local.properties (no pujat al control de versions) o utilitzeu variables d'entorn:

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

Assegureu-vos que local.properties està al vostre .gitignore.

Passos següents​

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