flutter_blue_plus

• [Internal] use short UUID where possible

• [Fix] guid: uuid was returning 0000 for 16 bit uuid (regression in 1.28.3)
• [Guid] guid.uuid should return lowercase

• [Improve] guid: add uuid short representation

• [Improve] add length checks to MsdFilter & ServiceDataFilter
• [Improve] guid: more consistent handling of 16, 32, vs 128 bit guids

• [Feature] scanning: add withServiceData filter
• [Feature] scanning: add withMsd filter

• [Breaking Change] guid.toString() now returns 16-bit short uuid when possible
• [Breaking Change] return GUIDs for advertisingData.serviceUuids & advertisingData.serviceData instead of String
• [Guid] add support for 16-bit and 32-bit uuids
• [Fix] android: advertised UUIDs were 128-bit instead of the actual length (regression in 1.14.17)

• [Improve] add more checks for bluetooth being off

• [Fix] android: typo compile error (regression in 1.27.3)

• [Fix] accidentally changed advertisementData.localName to nullable (regression in 1.27.3)

• [Perf] scanning: add continuousDivisor option to reduce platform channel & main-thread usage

• [Perf] scanning: only send advertisment keys over platform channel when they exist
• [Rename] advertisementData.localName -> advertisementData.advName

• [Add] android: add forceIndications option to setNotifyValue

This release improves the default scanning behavior.

• [Breaking Change] scanning: make continousUpdates false by default - it is not typically needed & hurts perf. If your app uses startScan.removeIfGone, or your app continually checks the value of scanResult.timestamp or scanResult.rssi, then you will need to explicitly set continousUpdates to true.

• [Fix] android: scanning would not work if continuousUpdates was false (regression in 1.26.5)

• [Add] scanning: withRemoteIds, withNames, withKeywords filters
• [Add] scanning: expose androidScanMode again
• [Add] scanning: continuousUpdates option replaces former allowDuplicates option

• [Add] cancelWhenDisconnected: option to cancel on next disconnection

• [Add] events.onReadRssi
• [Add] events.onCharacteristicWritten
• [Add] events.onDescriptorWritten

• [Fix] android: close gatt after canceling an in-progress connnection (regression in 1.26.1)
• [Improve] android: wait until bonding completes for better reliability

• [Feature] add support for canceling an in progress connection using device.disconnect
• [Fix] connection timeouts did not actually cancel the connection attempt (regression in 1.5.0)
• [Fix] android: update isScanning when onDetachedFromEngine is called (bug in original flutter_blue)

These releases changed multiple things but then changed them back. For brevity, here are the actual changes:

• [Behavior Change] android: listen to Services Changed characteristic to match iOS behavior
• [Fix] android: stop scanning when detached from engine (bug in original flutter_blue)
• [Add] device.advName returns the name found during scanning
• [Add] device.mtuNow synchronously gets the current mtu value
• [Add] events.onDiscoveredServices stream
• [Add] events api: add accessors for errors
• [Rename] events api: most functions & classes were renamed for consistency
• [Rename] device.onServicesChanged -> device.onServicesReset
• [Remove] device.onNameChanged, in favor of only exposing events.onNameChanged

This release makes mtu behavior more similar on android & iOS.

• [Breaking Change] android: request mtu of 512 by default.

This release greatly increases reliability on android & ios.

• [Improve] only allow a single ble operation at a time.

• [Fix] iOS: connect: return error for invalid remoteId (bug in original flutter_blue)
• [Improve] iOS: log warning if CCCD is not found, like we do on android

• [Fix] events API was not accessible through FlutterBluePlus.events

• [Add] FlutterBluePlus.events.mtu

• [Add] FlutterBluePlus.events.onNameChanged
• [Add] FlutterBluePlus.events.onServicesChanged

• [Rename] FlutterBluePlus.connectionEvents -> FlutterBluePlus.events.connectionState
• [Add] FlutterBluePlus.events.onCharacteristicReceived
• [Add] FlutterBluePlus.events.onDescriptorRead
• [Add] FlutterBluePlus.events.bondState

• [Add] FlutterBluePlus.connectionEvents, a stream of all connection & disconnected events
• [Add] FlutterBluePlus.connectedDevices, to get currently connected devices
• [Add] device.isConnected, convenience accessor

• [Fix] cannot retrieve platform name from bondedDevices (regression)
• [Fix] stopScan: should clear results after platform method has been called (bug in original flutter_blue)

• [Remove] FlutterBluePlus.connectedDevices. This API needs more thought.

This release renames connectedSystemDevices.

• [Rename] connectedSystemDevices -> systemDevices, because they must be re-connected by your app

• [Add] new method device.cancelWhenDisconnected(subscription)

• [Add] new method FlutterBluePlus.connectedDevices

This release reverts most of the breaking changes made in 1.18.0.

• [Revert] most breaking changes made to bondState stream in 1.18.0
• [Unchanged] bond lost/failed are replaced by prevBondState
• [Add] method device.prevBondState
• [Fix] android: adapterName must request permission (bug in original flutter_blue)

• [Refactor] bondState: finish refactor started in 1.18.0

• [Fix] bondState: must explicitly check for null prevState (regression in 1.18.0)

• [Fix] bondState: handle null prevState (regression in 1.18.0)

This release improves bondState stream

• [Breaking Change] bondState: directly expose prevBond instead of lost/failed flags

• [Fix] scanResults: clear scan results on stopScan (regression in 1.16.8)

• [Example] accidentally left performanceOverlay enabled (regression in 1.17.4)

• [Example] remove PermissionHandler dependency. It is no longer needed.
• [Example] ScanScreen: use ListView instead of SingleChildScrollView

• [Fix] android: turnOn throws exception if permission denied (bug in original flutter_blue)

This bug affected mtu, lastValueStream, adapterState, & bondState.

• [Fix] newStreamWithInitialValue was not emitting initial value. (regression in 1.16.6)

• [Fix] timeout when connect is called when adapter is off (bug in original flutter_blue)
• [Fix] android: was not calling disconnect callback when adapter turned off (bug in original flutter_blue)
• [Fix] android: connectable flag was not working (regression in 1.7.0)
• [Improve] do not re-get adapterState when we already have it

This release improves lastValue & lastValueStream.

• [Breaking Change/Fix] should update lastValue & lastValueStream when write is called
• [Feature] Android: support onNameChanged & onServicesChanged characteristics
• [Fix] iOS: discoverServices crash "[_NSInlineData intValue]: unrecognized selector sent to instance" (bug in original flutter_blue)
• [Fix] iOS: descriptor.write would timeout or not work (regression somewhere around ~1.7.0)
• [Fix] isNotifying was not updated by setNotifyValue(false) (regression somewhere around ~1.9.0)

• [Fix] Android: onValueReceived was not working on Android 12 & lower (regression in 1.16.3)

• [Fix] Android: onCharacteristicReceived not being called (regression in 1.16.3)

• [Fix] BluetoothDevice: don't wait for timeout if device becomes disconnected (bug in original flutter_blue)

• [Example] cleaned up Characteristic tile code

• [Fix] scanResults & isScanning streams were not re-emitting their current value on listen (regression in 1.5.0)
• [Example] discoverServices: stay on screen after diconnection
• [Example] simplified connectingOrDisconnecting code
• [Example] organize into 'screens' and 'widgets' folders