Clone this project and add it to your project:

1. In settings.gradle file add the following lines:

if (file('../Android-BLE-Library').exists()) {
    includeBuild('../Android-BLE-Library')
}

2. Sync project and build it.

The library uses Java 1.8 features. If you're using Android Studio below 4.2, make sure your build.gradle includes the following configuration:

    compileOptions {
        sourceCompatibility JavaVersion.VERSION_1_8
        targetCompatibility JavaVersion.VERSION_1_8
    }
    // For Kotlin projects additionally:
    kotlinOptions {
        jvmTarget = "1.8"
    }

1. getGattCallback() method has been deprecated. Instead, simply move the inner methods to the BleManager class. See this PR.
2. Support for server only implementation using attachClientConnection(BluetoothDevice). Call it instead of connect(BluetoothDevice) to use the device as server-only.
3. Data provider for read requests (server side) was added.
4. Cancellation support for flows and suspended methods added to :ble-kts.

1. More :ble-ktx extensions.
   1. .suspendForResponse() and .suspendForValidResponse() extension methods added to read and write requests.
   2. .asResponseFlow() and .asValidResponseFlow() methods added to ValueChangedCallback.
   3. .stateAsFlow() and .bondingStateAsFlow() in BleManager now return the same flow when called multiple times.
   4. Progress indications for split outgoing data and merged incoming data can be observed as Flow using splitWithProgressFlow(...) and mergeWithProgressFlow(...).
2. A new then(...) method added to ValueChangedCallback which will be called when the callback has been unregistered, or the device has invalidated services (i.e. it has disconnected). Useful to release resources.
3. A new option to remove a handler from each Request using setHandler(null), which will make the callbacks called immediately from the worker looper.
4. Option to filter logs by priority. By default only logs on Log.INFO or higher will now be logged. Use getMinLogPriority() to return a different value if needed. Logs with lower priority will not be produced at all, making the library less laggy (parsing incoming data to hex takes notable time).
5. Added support for Big Endian format types with the new Data.FORMAT_xxx_BE types. Also, FORMAT_xxx have been deprecated in favor of FORMAT_xxx_LE.
6. All user callbacks (before, with, then, fail, ...) are now wrapped in try-catch blocks.

1. :ble-ktx module added with support for coroutines and Flow.
   1. .suspend() methods added in Requests.
   2. asFlow() method added to ValueChangedCallback.
   3. Connection and bonding state available as Flow.
   4. New helper methods to get a BluetoothGattCharacteristic with given required properties and instance id added to BluetoothGattService.
2. JsonMerger class added, which should help with use cases when a device sends a JSON file in multiple packets.
3. :ble-livedata migrated to Java with some API changes, as sealed classes are no longer available.
4. Support for new onServicesChanged() callback, added in API 31 (Android 12).
5. Option to cancel pending Bluetooth LE connection using ConnectRequest.cancelPendingConnection().

When using coroutines, use .suspend() method in Request, instead of enqueue() or await().

To register to notifications and indications (or incoming write requests for server) use

setNotificationCallback(characteristic)
   .merge(JsonMerger()) // Example of how to use JsonMerger, optional
   .asFlow()

1. GATT Server support. This includes setting up the local GATT server on the Android device, new requests for server operations:
   • wait for read,
   • wait for write,
   • send notification,
   • send indication,
   • set characteristic value,
   • set descriptor value.
2. New conditional requests:
   • wait if,
   • wait until.
3. BLE operations are no longer called from the main thread.
4. There's a new option to set a handler for invoking callbacks. A handler can also be set per-callback.

Version 2.2 breaks some API known from version 2.1.1. Check out migration guide.