Skip to content

2.1.0

Latest
Latest

Choose a tag to compare

View all tags
@kylebrowning kylebrowning released this 01 Sep 02:32
2.1.0
e71d514

BLE in the iOS Simulator

BLESwift 2.1.0 makes BLE work in the iOS Simulator, where CoreBluetooth is non-functional. Purely additive — no breaking API changes.

Added

  • Simulator link — new BLESwiftLink, BLESwiftSimulatorLink, and BLESwiftProvider products plus a bleswift-provider executable. Call SimulatorLink.install() in your simulator build and every subsequently-constructed Central() / PeripheralHost() is routed over a localhost TCP link to a bleswift-provider process on the host Mac, which serves it from the Mac's real radio (--passthrough), an in-process virtual radio, or both. Endpoint is configurable via BLESWIFT_LINK, and SimulatorLink.isProviderReachable() probes for a running provider. See the "Running in the iOS Simulator" DocC article.
  • Virtual devices — a declarative JSON fixture format (bleswift-provider --fixture) for virtual devices with advertisements and GATT databases, plus Provider.addVirtualDevice(_:advertising:) for hosting virtual devices written in Swift and driving them through a VirtualDeviceHandle.
  • BackendRegistry (BLESwiftCore) — process-wide optional backend factories consulted by Central(configuration:) / PeripheralHost(configuration:) when building their default backend. Nothing registered means CoreBluetooth is constructed exactly as before.
  • BLESwiftExplorer — an Advertise tab driving PeripheralHost, and --auto-advertise / --auto-scan launch arguments for automated runs.
  • Two-simulator end-to-end test (Scripts/sim-to-sim-e2e.sh) and CI job: two simulator apps meet on the provider's virtual radio — one advertising, one scanning and connecting — with no Bluetooth hardware and no entitlements.

Fixed

  • HostSession no longer counts backend-refused duplicate addService requests against maximumHostedServices, so repeated duplicate adds can't exhaust the service budget (#26).
  • CentralSession's L2CAP pump now identity-checks before forwarding inbound bytes, so a torn-down bridge can't write a dead channel's bytes under a re-issued channel id (#27).
  • Provider.addVirtualDevice registrations that race an overlapping stop() are rolled back instead of stranding the device on the radio (#29).
  • A failed Provider.start() (e.g. port already in use) now rolls back its fixture registrations, so a retry doesn't double-register fixtures and strand vended handles (#30).
  • Hardened provider session lifecycle and L2CAP bookkeeping (#39), plus review-finding fixes across the virtual radio, composites, and link shutdown (#41).

Known limitation

  • The --passthrough L2CAP path pairs channel-open completions by arrival order per peripheral (CoreBluetooth's callback carries nothing naming the open it answers); a completion arriving after a reconnect-and-reopen can be taken for the new open. Documented in the "Running in the iOS Simulator" article; virtual devices are unaffected (#28).

Full Changelog: 2.0.0...2.1.0

Assets 2
Loading