Main Activity
Sample MainActivity demonstrating the complete BLE-X library usage.
This activity showcases:
Requesting BLE permissions (Android 12+ compatible)
Scanning for nearby BLE devices
Connecting to a selected device with lifecycle awareness
Reading and writing GATT characteristics
Enabling/disabling notifications
Proper lifecycle handling and resource cleanup
Setup Requirements
Add the following permissions to your AndroidManifest.xml:
<uses-permission android:name="android.permission.BLUETOOTH_SCAN" />
<uses-permission android:name="android.permission.BLUETOOTH_CONNECT" />
<uses-permission android:name="android.permission.BLUETOOTH_ADVERTISE" />
<uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />Content copied to clipboardDeclare the activity in your manifest:
<activity
android:name=".sample.MainActivity"
android:exported="true">
<intent-filter>
<action android:name="android.intent.action.MAIN" />
<category android:name="android.intent.category.LAUNCHER" />
</intent-filter>
</activity>Content copied to clipboard
Usage Flow
User launches the app
App requests necessary BLE permissions
User taps "Scan" to discover nearby BLE devices
User selects a device from the list to connect
App establishes connection and discovers services
User can read/write characteristics and enable notifications
Connection is automatically cleaned up when activity is destroyed