Salt la continutul principal

Install vitalera Android SDK v2 for Medical Device Integration

The Vitalera SDK v2 is distributed via Maven (GitHub Packages). Add the repository and the modules your app needs.

1. Add the Maven Repository​

In your project-level settings.gradle.kts (or build.gradle), add the Vitalera Maven repository:

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. Add Dependencies​

Option A: Umbrella Module (quickest setup)​

The umbrella module includes sdk-core, sdk-ble, and all provider modules as transitive dependencies:

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

Pick only the modules you need to minimize binary size and avoid bundling unused vendor SDKs:

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

Module Reference​

ModuleArtifactDescription
sdk-corecom.vitalera:sdk-coreBuilder, auth, registry, observation types (always required)
sdk-blecom.vitalera:sdk-bleBLE abstraction, standard BLE profiles (required for Bluetooth devices)
provider-omroncom.vitalera:provider-omronOmron blood pressure monitors, thermometers
provider-polarcom.vitalera:provider-polarPolar heart rate monitors (H10, Verity Sense)
provider-lifevitcom.vitalera:provider-lifevitLifevit BPM, oximeter, scale, thermometer
provider-beurercom.vitalera:provider-beurerBeurer BPM, oximeter
provider-smart-peak-flowcom.vitalera:provider-smart-peak-flowSmart Peak Flow (audio-based)
provider-health-connectcom.vitalera:provider-health-connectAndroid Health Connect
sdk-androidcom.vitalera:sdk-androidUmbrella: all providers included

3. Configure Permissions​

Add the required Bluetooth permissions to your 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. Credential Security​

Store your GitHub Packages credentials in local.properties (not committed to version control) or use environment variables:

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

Ensure local.properties is in your .gitignore.

Next Steps​

See the Usage Guide for SDK initialization and device integration.