This is a demonstration app designed for detecting nearby BLE (Bluetooth Low Energy) devices, connecting to them, listing their services and characteristics, and interacting with those characteristics.
Its purpose is to demonstrate the BLE functionalities, Coroutines and Rx interoperability and testing approaches.
recording.mp4
-
Scan for devices: Run the app and it will display a list of nearby BLE devices. Click on a device to proceed.
-
Connect to a device: Once you're in the connection screen, click on the "Connect" button. This will trigger a discovery process for the services and characteristics of the chosen device.
-
Interact with characteristics: Clicking on a characteristic will open a dialog that allows for interactions. Once an action is performed, the dialog closes and the corresponding event should appear in the logs.
This app is made using:
- Jetpack Compose for UI with Material 3 and dark/light mode support
- RxJava 3 for the BLE module
- Coroutines for bridging the BLE functionalities with the Flows on the app module
Stack:
- MVVM architecture (mix of MVVM and MVI)
- RxJava3 in the BLE module
- Coroutines/Flows on the app module for interacting with RxJava3 observables from the BLE module
- Jetpack Compose and Compose Navigation: UI
- Hilt for dependency injection
- KotlinX Serialization for serialization and deserialization of models into and from files
- Retrofit for network requests
- Extended Material icons for vector images
- Accompanist Permissions for Composable permission handling
- DataStore for persisting user preferences
- MockK for mocking in tests
Bluetooth permissions are required (depending on Android version) to allow for the full functionality set.
