Salt la continutul principal

Android SDK

The Vitalera Android SDK v2 is a Kotlin Multiplatform library that provides device discovery, connection, and typed observation collection for medical devices on Android.

Table of Contents​

Overview​

The SDK uses a modular provider architecture. Each device vendor (Omron, Polar, Lifevit, Beurer) is a separate Gradle module. Include only the providers your app needs, or use the umbrella module (sdk-android) for all providers.

Key capabilities:

  • Provider Plugin System: Register only the device providers you need via addProvider().
  • Flow-Based Discovery: Scan for devices using Kotlin Flow with filters and timeouts.
  • Typed Observations: Receive BloodPressureObservation, HeartRateObservation, WeightObservation, and 30+ other typed classes instead of generic key-value maps.
  • DPoP Authentication: Organization license key with DPoP-bound tokens. 7-day offline grace period.
  • Connected Mode: Resolve patients and post observations to the Vitalera backend.
  • Health Connect Integration: Read from Google Health Connect via the provider-health-connect module.

Requirements​

  • Min Android API: 24 (Android 7.0 Nougat)
  • JDK: 17
  • Architecture: ARM or x86 physical device (BLE features require physical hardware)
  • Bluetooth permissions: BLUETOOTH_SCAN, BLUETOOTH_CONNECT, ACCESS_FINE_LOCATION (API 31+)

Note: The Vitalera patient mobile app requires Android 9 (Pie) / API 28 or higher.

Getting Started​

  1. Follow the Installation Guide to add the SDK dependencies.
  2. Obtain a clientId (organization license key) from sdk@vitalera.com.
  3. See the Usage Guide for initialization, discovery, connection, and data collection.
  4. Review the Changelog for version history.

Support​

For questions or issues, contact support@vitalera.io.