How to handle BLE permissions with RxAndroidBle on Android 12?

Refer to the permissions section in the README: for API 31+, you need BLUETOOTH_SCAN and optionally BLUETOOTH_CONNECT, with location permissions if deriving user location. Use tools:node attributes in manifest to customize.

RxAndroidBle vs Android's native BLE API: which should I use?

Use RxAndroidBle if you want cleaner code with reactive streams and built-in threading; it reduces boilerplate. Stick with native APIs if you need low-level control or avoid RxJava dependencies, as RxAndroidBle abstracts away some flexibility.

How to set up notifications for BLE characteristics using RxAndroidBle?

Call rxBleConnection.setupNotification(characteristicUuid) to get an Observable, then subscribe to it for value changes. Dispose to disable notifications, as shown in the Change notifications example in the README.

Does RxAndroidBle support background scanning?

Yes, but it requires additional permissions like ACCESS_BACKGROUND_LOCATION for APIs 29-30 and careful manifest configuration. The README provides specific XML snippets for background scanning scenarios.

What are common errors when connecting with RxAndroidBle and how to fix them?

Common errors include status 133 (connection failures) and UndeliverableExceptions; check the FAQ wiki links in the README for troubleshooting. Ensure permissions are granted, Bluetooth is on, and device is in range.

How to test BLE apps with RxAndroidBle without physical devices?

Use MockRxAndroidBle for unit tests with Robolectric, but note it's not actively developed. For integration, mock interfaces or rely on physical devices, as the library's testing section suggests.

Open-Awesome

RxAndroidBle

Apache-2.0Javarelease-1.19.1-rxjava2+rxjava3

A reactive Android Bluetooth Low Energy (BLE) library with RxJava3 interface, simplifying complex BLE operations.

Visit Website GitHub

3.5k stars592 forks0 contributors

What is RxAndroidBle?

RxAndroidBle is an open-source Android library that provides a reactive interface for Bluetooth Low Energy (BLE) communication. It simplifies working with Android's complex BLE APIs by exposing operations as RxJava Observables, handling threading, asynchronous tasks, and error management automatically. It solves the problem of verbose and error-prone BLE implementation on Android.

Target Audience

Android developers building applications that communicate with BLE devices such as fitness trackers, smart home gadgets, medical devices, or IoT sensors. It's particularly useful for those already familiar with RxJava.

Value Proposition

Developers choose RxAndroidBle because it dramatically reduces BLE implementation complexity with its reactive approach, provides robust error handling, and abstracts away Android's threading requirements. Its RxJava integration allows for elegant composition of BLE operations compared to callback-based alternatives.

Overview

An Android Bluetooth Low Energy (BLE) Library with RxJava3 interface

Use Cases

Best For

Building fitness or health apps that connect to BLE heart rate monitors
Developing smart home apps controlling BLE-enabled lights or locks
Creating IoT applications that communicate with sensor devices
Implementing BLE data logging or monitoring tools
Prototyping BLE-enabled Android applications quickly
Apps requiring reliable BLE connection state management

Not Ideal For

Teams with no RxJava experience preferring callback-based or Kotlin coroutine approaches
Projects requiring cross-platform BLE support beyond Android
Applications needing immediate access to cutting-edge Android BLE features not yet abstracted by the library
Production environments with zero tolerance for API instability, given snapshot versions may break

Pros & Cons

Pros

Reactive Stream Composition

Exposes BLE operations as RxJava Observables, allowing developers to chain, merge, and transform scans, reads, and writes with RxJava operators, as demonstrated in the README's multiple operation examples.

Automatic Threading Management

Handles Android threading contracts internally, preventing common pitfalls like UI thread blocking during BLE operations, which is highlighted in the library's philosophy.

Comprehensive Error Handling

Propagates errors through RxJava's onError with detailed JavaDoc for each public method, making it easier to debug connection failures or permission issues.

Configurable Logging

Supports custom logger integration and multiple log levels, enabling deep debugging of BLE interactions without modifying core code, as shown in the logging section.

Cons

RxJava Learning Curve

Requires proficiency in RxJava for effective use, adding overhead for teams not already invested in reactive programming, limiting accessibility for some Android developers.

Complex Permission Setup

Managing permissions across Android versions is intricate and error-prone, with the README detailing lengthy, API-specific manifest additions that can confuse developers.

Stagnant Mocking Support

The mock library for testing (MockRxAndroidBle) is not under active development, hindering reliable integration testing without physical devices, as admitted in the README.

Frequently Asked Questions

Related Projects

FastBle

Android Bluetooth Low Energy (BLE) Fast Development Framework. It uses simple ways to filter, scan, connect, read ,write, notify, readRssi, setMTU, and multiConnection.

Stars5,487

Forks1,243

Last commit1 month ago

Nordic Semiconductor BLE SDK for Android

A library that makes working with Bluetooth LE on Android a pleasure. Seriously.

Stars2,381

Forks456

Last commit4 days ago

Android BluetoothGatt Sample

Multiple samples showing the best practices in connectivity on Android.

Stars1,783

Forks1,351

Last commit11 months ago

android-BluetoothChat

Migrated:

Stars1,005

Forks636

Last commit6 years ago

Community-curated · Updated weekly · 100% open source

Found a gem we're missing?

Open-Awesome is built by the community, for the community. Submit a project, suggest an awesome list, or help improve the catalog on GitHub.

Submit a project Star on GitHub