Skip to main content
Native Android apps use the Maven artifact com.mentraglass:bluetooth-sdk.

Requirements

  • Android min SDK 28 or newer.
  • Java 17.
  • Android Studio or Gradle.
  • A physical Android phone for Bluetooth, camera, microphone, direct phone photo, and direct phone WebRTC testing.

Gradle Setup

The SDK is published to Maven Central. Keep google() and mavenCentral() configured. The SDK POM pulls in the companion com.mentraglass:lc3Lib codec artifact automatically; do not add it manually unless you have a specific override reason. The packaging rule avoids duplicate libc++_shared.so conflicts when your app also includes native media or camera dependencies.

Permissions

Declare the platform permissions your app uses:
Request runtime permissions before scanning. Some Android 12+ devices require Location permission and Location services before BLE scan callbacks are delivered.

Basic Flow

Local SDK Override

Use this when testing SDK source changes from a local MentraOS checkout. Run the publish command from the SDK Android module with a local Gradle install, then consume the Maven-local artifact from your app:
Then include mavenLocal() before mavenCentral() in the app’s repositories while testing the local artifact.