Examples
Example Android app for SimpleDroidBLE.
The SimpleBLE Explorer Android app lives in examples/simpleble-android.
It demonstrates:
- requesting Android Bluetooth permissions with the Activity Result API,
- explaining Android adapter selection,
- scanning and showing discovered peripherals,
- connecting and disconnecting cleanly,
- listing services and characteristics with capabilities,
- reading a selected characteristic,
- writing with request or command,
- subscribing to notify or indicate characteristics,
- showing errors in the UI,
- stopping scans on activity pause and cleaning up notification/connection work from the ViewModel.
Run it from Android Studio by opening examples/simpleble-android, or from the command line:
cd examples/simpleble-android
./gradlew :app:assembleDebugInstall the APK on an Android API 31+ device with BLE support. For deterministic emulator development, build the PLAIN test build instead:
./gradlew :app:assemblePlainThe repository-only PLAIN build uses the same Kotlin and JNI layers with SimpleBLE's simulated backend. It supports the Explorer scan, connect, service, read, and notification workflow without Bluetooth hardware. Use the regular build on a physical phone before claiming real scan, connection, reconnection, or GATT behavior is verified.