bluetooth

  
Use the Android platform's Bluetooth features with backward-compatible APIs.
Latest Update Stable Release Release Candidate Beta Release Alpha Release
November 29, 2023 - - - 1.0.0-alpha02

Declaring dependencies

To add a dependency on Bluetooth, you must add the Google Maven repository to your project. Read Google's Maven repository for more information.

Add the dependencies for the artifacts you need in the build.gradle file for your app or module:

Groovy

dependencies {
    
    implementation "androidx.bluetooth:bluetooth:1.0.0-alpha02"
}

Kotlin

dependencies {
    
    implementation("androidx.bluetooth:bluetooth:1.0.0-alpha02")
}

For more information about dependencies, see Add build dependencies.

Feedback

Your feedback helps make Jetpack better. Let us know if you discover new issues or have ideas for improving this library. Please take a look at the existing issues in this library before you create a new one. You can add your vote to an existing issue by clicking the star button.

Create a new issue

See the Issue Tracker documentation for more information.

There are no release notes for this artifact.

Version 1.0

Version 1.0.0-alpha02

November 29, 2023

androidx.bluetooth:bluetooth:1.0.0-alpha02 and androidx.bluetooth:bluetooth-testing:1.0.0-alpha02 are released. Version 1.0.0-alpha02 contains these commits.

New Features

  • Lower minSdkVersion to 21

API Changes

  • GattServerConnectFlow#updateServices becomes a suspend function (I0237d)
  • Change AdvertiseParams.durationMillis to Long (If6771)
  • Convert openGattServer to Flow (Icef54)
  • Throw ScanException on scan fail and set scanner to setLegacy(false) by default (Ib337c)
  • Throw AdvertiseException on advertise fail (I0e691)
  • Add general bluetooth exception to catch (I0130d)
  • Convert advertise to Flow and change maximum duration (I32fd8)
  • Add serviceData and serviceSolicitationUuids to ScanResult (I6d7f0)
  • Change durationMillis from Long to Duration (I89d49)
  • Add rssi, and periodicAdvertisingInterval to ScanResult (I60b51)
  • Add serviceSolicitationUuid and solicitationUuidMask to ScanFilter (Ic2206)
  • Added GattServerSessionScope#subscribedCharacteristics (I0edab)
  • Add serviceSolicitationUuids to AdvertiseParams (Ic9aa7)
  • Change AdvertiseParams.durationMillis from Int to Long (I6873f)
  • GattServerSessionScope#notify does not return but throws an exception if it fails (Ifc26f)

Bug Fixes

  • Extract scan functionality (I4d43f)

Version 1.0.0-alpha01

September 20, 2023

androidx.bluetooth:bluetooth:1.0.0-alpha01 and androidx.bluetooth:bluetooth-testing:1.0.0-alpha01 are released. Version 1.0.0-alpha01 contains these commits.

New Features

  • This is the initial release of AndroidX Bluetooth APIs that provides a Kotlin API surface covering Bluetooth LE scanning and advertising, and GATT client and server use cases. It provides a minimal API surface, clear thread model with async and sync operations, and ensures all methods be executed and provides the results.