Ugrás a fő tartalomra

Android SDK telepítési útmutató

A Vitalera SDK v2 Maven-en (GitHub Packages) keresztül kerül terjesztésre. Adja hozzá a tárolót és az alkalmazásához szükséges modulokat.

1. Maven tároló hozzáadása​

A projekt szintű settings.gradle.kts (vagy build.gradle) fájlban adja hozzá a Vitalera Maven tárolót:

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. Függőségek hozzáadása​

A opció: Umbrella modul (leggyorsabb beállítás)​

Az umbrella modul tartalmazza az sdk-core, sdk-ble és az összes provider modult tranzitív függőségként:

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

B opció: Egyéni modulok (éles környezethez ajánlott)​

Válassza ki csak a szükséges modulokat a bináris méret minimalizálásához és a nem használt gyártói SDK-k elkerüléséhez:

dependencies {
    // Mindig szükséges
    implementation("com.vitalera:sdk-core:2.0.6")

    // BLE réteg hozzáadása bármilyen Bluetooth eszköz használata esetén
    implementation("com.vitalera:sdk-ble:2.0.6")

    // Csak a szükséges providerek hozzáadása
    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")
}

Modul referencia​

ModulArtifactLeírás
sdk-corecom.vitalera:sdk-coreBuilder, hitelesítés, registry, megfigyelési típusok (mindig szükséges)
sdk-blecom.vitalera:sdk-bleBLE absztrakció, szabványos BLE profilok (Bluetooth eszközökhöz szükséges)
provider-omroncom.vitalera:provider-omronOmron vérnyomásmérők, hőmérők
provider-polarcom.vitalera:provider-polarPolar pulzusmérők (H10, Verity Sense)
provider-lifevitcom.vitalera:provider-lifevitLifevit BPM, oximéter, mérleg, hőmérő
provider-beurercom.vitalera:provider-beurerBeurer BPM, oximéter
provider-smart-peak-flowcom.vitalera:provider-smart-peak-flowSmart Peak Flow (hang-alapú)
provider-health-connectcom.vitalera:provider-health-connectAndroid Health Connect
sdk-androidcom.vitalera:sdk-androidUmbrella: minden provider tartalmazza

3. Engedélyek konfigurálása​

Adja hozzá a szükséges Bluetooth engedélyeket az AndroidManifest.xml fájlhoz:

<!-- 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 és korábbi -->
<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. Hitelesítő adatok biztonsága​

Tárolja a GitHub Packages hitelesítő adatait a local.properties fájlban (ne kerüljön verziókezelés alá) vagy környezeti változókban:

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

Győződjön meg róla, hogy a local.properties szerepel a .gitignore fájlban.

Következő lépések​

Lásd a Használati útmutatót az SDK inicializálásához és az eszközintegrációhoz.