Android Integration

Android is the most complete platform for Protection Mode and background BLE ownership.

What the SDK owns

• Protection method and event channels
• Foreground-service-backed Protection runtime wiring
• Merged plugin manifest pieces for the SDK-owned Android path
• Runtime readiness and diagnostics exposed to Dart

What the host app owns

• Runtime permission UX
• App bootstrap that creates the SDK instance
• App-level notification channel branding
• Product-specific BLE or safety UX around the SDK

Required setup

1. Declare Bluetooth, location, and notification permissions in AndroidManifest.xml — see the Permissions Checklist
2. Keep foreground service requirements aligned with your app policy when using Protection Mode
3. Bootstrap with EixamConnectSdk.bootstrap(...)

Protection Mode behavior

remarque

Protection Mode is off by default. The host app must arm it explicitly.

• When armed, Android provides the strongest background path
• Host UI should inspect diagnostics if readiness evaluation is blocked

Validation checklist

1. Bootstrap the SDK
2. Request permissions explicitly
3. Connect a device if your flow requires it
4. Run evaluateProtectionReadiness()
5. Call enterProtectionMode()
6. Inspect watchProtectionStatus() and watchProtectionDiagnostics()