Skip to main content
Version: 0.1.0

iOS Integration

The SDK includes an iOS Protection adapter and participates in the same Dart public contract. However, background BLE ownership on iOS is not as mature as Android — integrate with that expectation in mind.

Host app expectations

  • Provide notification UX
  • Declare Bluetooth usage descriptions in Info.plist
  • Prepare UIBackgroundModes only when your product genuinely needs background execution
  • Treat Protection Mode on iOS as capability-aware, not as equivalent to Android

Integration

Use the same public bootstrap path as Android:

final sdk = await EixamConnectSdk.bootstrap(
const EixamBootstrapConfig(
appId: 'partner-app',
environment: EixamEnvironment.production,
),
);

Then request permissions and inspect readiness before arming Protection Mode.

For required Info.plist keys, see the Permissions Checklist.

Troubleshooting

tip

If iOS reports partial coverage or degraded readiness, inspect diagnostics first before assuming parity with the Android runtime.

Partial coverage on iOS can be expected depending on current iOS runtime ownership support.