Android SDK Installationsleitfaden

Das Vitalera SDK v2 wird ueber Maven (GitHub Packages) verteilt. Fuegen Sie das Repository und die Module hinzu, die Ihre App benoetigt.

1. Maven-Repository hinzufuegen

Fuegen Sie in Ihrer settings.gradle.kts (oder build.gradle) auf Projektebene das Vitalera Maven-Repository hinzu:

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. Abhaengigkeiten hinzufuegen

Option A: Umbrella-Modul (schnellste Einrichtung)

Das Umbrella-Modul enthaelt sdk-core, sdk-ble und alle Anbietermodule als transitive Abhaengigkeiten:

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

Option B: Einzelne Module (empfohlen fuer die Produktion)

Waehlen Sie nur die Module, die Sie benoetigen, um die Binaergroesse zu minimieren und ungenutzte Hersteller-SDKs zu vermeiden:

dependencies {
    // Immer erforderlich
    implementation("com.vitalera:sdk-core:2.0.6")

    // BLE-Schicht hinzufuegen, wenn ein Bluetooth-Geraet verwendet wird
    implementation("com.vitalera:sdk-ble:2.0.6")

    // Nur die benoetigten Anbieter hinzufuegen
    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")
}

Modulreferenz

Modul	Artefakt	Beschreibung
sdk-core	com.vitalera:sdk-core	Builder, Auth, Registry, Beobachtungstypen (immer erforderlich)
sdk-ble	com.vitalera:sdk-ble	BLE-Abstraktion, Standard-BLE-Profile (erforderlich fuer Bluetooth-Geraete)
provider-omron	com.vitalera:provider-omron	Omron-Blutdruckmessgeraete, Thermometer
provider-polar	com.vitalera:provider-polar	Polar-Herzfrequenzmesser (H10, Verity Sense)
provider-lifevit	com.vitalera:provider-lifevit	Lifevit BPM, Oximeter, Waage, Thermometer
provider-beurer	com.vitalera:provider-beurer	Beurer BPM, Oximeter
provider-smart-peak-flow	com.vitalera:provider-smart-peak-flow	Smart Peak Flow (audiobasiert)
provider-health-connect	com.vitalera:provider-health-connect	Android Health Connect
sdk-android	com.vitalera:sdk-android	Umbrella: alle Anbieter enthalten

3. Berechtigungen konfigurieren

Fuegen Sie die erforderlichen Bluetooth-Berechtigungen zu Ihrer AndroidManifest.xml hinzu:

<!-- 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 und aelter -->
<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. Sicherheit der Anmeldedaten

Speichern Sie Ihre GitHub-Packages-Anmeldedaten in local.properties (nicht in die Versionskontrolle eingecheckt) oder verwenden Sie Umgebungsvariablen:

# local.properties
gpr.user=ihr-github-benutzername
gpr.key=ghp_ihr-github-token

Stellen Sie sicher, dass local.properties in Ihrer .gitignore enthalten ist.

Naechste Schritte

Siehe den Verwendungsleitfaden fuer SDK-Initialisierung und Geraeteintegration.