Skip to main content
Version: 1.0.0

Android Integration Guide

This guide walks you through integrating the Impilo Mobile SDK into your Android application.

Requirements​

  • Android API 26+ (Android 8.0 Oreo)
  • Android Studio Arctic Fox or later
  • Kotlin 1.6+

Installation​

Gradle Setup​

Add the Impilo Mobile SDK to your project's build.gradle:

dependencies {
    implementation 'health.impilo:impilomobilesdk:1.0.0'
}

Import the SDK​

import health.impilo.impilomobilesdk.SDK
import health.impilo.impilomobilesdk.Config
import health.impilo.impilomobilesdk.DeviceType

Configuration​

AndroidManifest.xml Setup​

Add the following permissions to your AndroidManifest.xml for Bluetooth and Health Connect access:

<!-- Bluetooth permissions -->
<uses-permission android:name="android.permission.BLUETOOTH" />
<uses-permission android:name="android.permission.BLUETOOTH_ADMIN" />
<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" />

<!-- Health Connect permissions -->
<uses-permission android:name="android.permission.health.READ_STEPS" />
<uses-permission android:name="android.permission.health.READ_HEART_RATE" />
<!-- Add other health permissions as needed -->

Health Connect Intent Filter​

To handle Health Connect permission requests, add this to your activity:

<intent-filter>
    <action android:name="androidx.health.ACTION_SHOW_PERMISSIONS_RATIONALE" />
</intent-filter>

Initialize the SDK​

import health.impilo.impilomobilesdk.SDK

val sdk = SDK.initialize()
sdk.setupBluetooth(activity)

Runtime Permissions​

Remember to request Bluetooth permissions at runtime for Android 12+:

if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.S) {
    requestPermissions(
        arrayOf(
            Manifest.permission.BLUETOOTH_SCAN,
            Manifest.permission.BLUETOOTH_CONNECT
        ),
        REQUEST_BLUETOOTH_PERMISSIONS
    )
}

Next Steps​

  • Read the SDK Guide for detailed usage instructions
  • Learn about device discovery and pairing
  • Integrate with Health Connect

Need Help?​

For support or additional device integration requests, reach out to sales@impilo.health.