Skip to main content

openci_virtual_ble 0.1.0 copy "openci_virtual_ble: ^0.1.0" to clipboard
openci_virtual_ble: ^0.1.0 copied to clipboard

PlatformiOS

Connect a Flutter app on an iOS Simulator to a virtual Bluetooth GATT peer for two-device integration tests.

OpenCI virtual BLE simulator client #

This Flutter plugin connects a Debug iOS Simulator to a peer URL returned by the openci_workflow SDK. Its native transport uses URLSessionWebSocketTask. The host runs the Bumble GATT devices. Both simulators run on the same Mac.

Install the plugin as a development dependency in the Flutter app.

flutter pub add --dev openci_virtual_ble

Run the app's Patrol target with ci.patrol.testWithVirtualBle() from openci_workflow. Each simulator receives its WebSocket URL in the endpoint field of tmp/openci-virtual-ble.json inside the app's data container. Pass that URL and the bytes to publish to VirtualBleClient.connect(). Use onPeerValue for discovery, onWrite for incoming data, and write() to send a value and await acknowledgement. OpenCI workflow SDK

Apps that own their BLE protocol in Swift can import openci_virtual_ble and use VirtualBleConnection under #if DEBUG && targetEnvironment(simulator).

The example builds one Flutter app with Patrol. B publishes a readable value, then A reads it and sends a fresh 16-byte value. B displays the bytes it received and echoes them with a second GATT write. Patrol checks the received and acknowledged values on both screens.

From the OpenCI repository root with Flutter 3.47.8, Python 3.13, Xcode and an iOS Simulator runtime:

flutter pub get
dart run openci/virtual_ble_ci.dart

Each run creates its own two simulators and removes them after the test. The workflow uses ci.patrol.testWithVirtualBle() to run the prebuilt Patrol target on each device and collect its UI evidence. The per-device logs, XCTest result bundles, and evidence are kept under example/build/virtual_ble/round-trip-*/. The example uses this local plugin and the workflow uses the SDK from the same checkout.

0
likes
160
points
--
downloads

Documentation

API reference

Publisher

unverified uploader

Weekly Downloads

Connect a Flutter app on an iOS Simulator to a virtual Bluetooth GATT peer for two-device integration tests.

Repository (GitHub)
View/report issues

License

Apache-2.0 (license)

Dependencies

flutter

More

Packages that depend on openci_virtual_ble

Packages that implement openci_virtual_ble