BluetoothLE Hosting Releases

v5

5.0.0 - TBD

Feature

L2CapChannelExtensions.SendFile(...) — new file-transfer helper on top of an open L2CapChannel with HTTP-transfer-style progress metrics (bytes-per-second, percent-complete, estimated time remaining). Useful for streaming firmware blobs and other large payloads to a connected central. Overloads accept either a file path (length auto-detected) or an arbitrary Stream with an optional totalBytes. Progress callbacks fire ~every 2s plus a final 100% emission on completion. The supporting Shiny.BluetoothLE.TransferProgress record mirrors Shiny.Net.Http.TransferProgress. Lives in Shiny.BluetoothLE.Common, shared with the central library.

Fix Android

BleHostingManager now takes AndroidPlatform through a primary constructor and eagerly initializes its GattServerContext. Previously the context field was declared readonly but never assigned, so every call into the Android hosting manager (advertising, GATT services, request-access, beacon) would have NREd at runtime once the DI container resolved the manager via its compiler-generated parameterless constructor.

Feature

L2CAP CoC peripheral hosting shipped — IBleHostingManager.OpenL2Cap(bool secure, Action<L2CapChannel> onOpen) publishes a PSM and invokes the callback for every accepted central connection. Each L2CapChannel exposes Func<byte[], IObservable<Unit>> Write and IObservable<byte[]> DataReceived, and disposes cleanly via the channel’s IDisposable. Dispose the returned L2CapInstance to stop accepting and release the PSM. Implemented on iOS, Mac Catalyst, macOS (CoreBluetooth CBPeripheralManager.PublishL2CapChannel), Android API 29+ (BluetoothAdapter.ListenUsing[Insecure]L2capChannel), and Linux (BlueZ — raw AF_BLUETOOTH socket with kernel-assigned dynamic PSM ≥ 0x80 and a background accept loop). Windows hosting throws NotSupportedException from OpenL2Cap — WinRT exposes no LE CoC surface.

Enhancement

The public L2CapChannel record moved into Shiny.BluetoothLE.Common (namespace Shiny.BluetoothLE) so both hosting and central libraries share a single type. It now also implements IDisposable with an optional OnDispose hook for platform cleanup (closing streams, releasing sockets).

Feature

macOS support added - peripheral / GATT server hosting via CoreBluetooth

Feature

Linux support added via BlueZ / D-Bus - new Shiny.BluetoothLE.Hosting.Linux package

v4

4.0.0 - March 26, 2026

Feature

Windows support added (No Background Support at this time)

v3

3.2.0 - December 8, 2023

Enhancement

BLE Hosting manager now allows you to check current permissions without requesting

Fix Android

Managed BLE Services won’t always auto-restart post reboot

3.0.0 - September 5, 2023

Enhancement Android

RequestAccess now exists - you can specifically target your permissions to take advantage of Android API 31

Enhancement

All characteristic hooks are now async

Enhancement

New “managed” model for characteristics

Enhancement

Advertise iBeacons is now supported - it exists here instead of Shiny.Beacons because all of the advertising code is here