- [Feature] verbose logs: make function results easier to see
- [Fix] iOS: crash caused by 1-byte advertisements (#1022)
- [Fix] Android: null deref when getting permissions (regression 1.33.3)
- [Fix] Android: asking permission would not work until app restart (regression 1.32.13)
- [Fix] Android: compile bug in 1.33.1
- [Fix] Android: compile bug in 1.33.0
- [BREAKING CHANGE] iOS 18 compatibility:
systemDevices
now requires UUID argument - [Fix] Android: characteristic READ error was not being passed to dart
- [Feature] iOS: add support for State Preservation
- [Improve] Android: ask for both scan permissions at the same time
- [Fix] Android: further improve
disconnect(queue:false)
reliability - [Deprecate] deprecate BluetoothDevice.fromProto(...)
- [Improve] Android: perf: speed up
bytesToHex
- [Fix] Android: calling
disconnect(queue:false)
may sometimes silently fail
- [Feature] Android: add legacy scan option
- [Fix] iOS: was not updating
lastValueStream
ifwithoutResponse:true
- [Fix] android: last byte was cutoff for msd of same manufactuerId (regression 1.32.5)
- [Fix] calling
startScan
multiple times in a row would fail
- [Fix] android: support multiple MSD with the same manufacturer ID
- [Improve] revert 1.32.3 (i.e. go back to 1.32.1 behavior)
- [Fix] fix
SCAN_FAILED_ALREADY_STARTED
on android after adapter is turnedoff
thenon
- [Improve] allow calling
stopScan
even if not currently scanning. (revert 1.32.1)
- [Improve] iOS: fix warning about implicit conversion for showPowerAlert
- [Fix] Android: scan failure were not being pushed to onError
- [Improve] only
stopScan
if currently scanning. prevents 'could not find callback wrapper' log on Android
This realease has a very slight behavior change for adapterState
& connectionState
- [Improve] update
adapterState
stream beforeconnectionState
streams. Simplifies internal autoconnect code.
- [Improve] autoconnect: catch & print errors when autoconnect fails
- [Feature] add
setOptions
function. Used to configure power alert on iOS
- [Fix] android: autoconnect could enter disconnect / connection loop
- [Fix] android: calling
disconnect
should always disable autoconnect, even if already disconnected
- [Fix] forgot to push to mtu stream after disconnection
- [Feature] support advertising
appearance
on Android
- [Fix] autoconnect could not disconnect if there are multiple devices
- [Improve] android: use name
LINK_SUPERVISION_TIMEOUT
instead ofCONNECTION_TIMEOUT
- [Improve] improve reliability of autoconnect on android
- [Feature] add convenience function to get raw
msd
data in advertisement
- [Fix] type 'DeviceIdentifier' is not a subtype of type 'String' (regression 1.31.9)
- [Feature] add
cancelAfterDisconnection
delayed
option forconnectionState
streams - [Feature] add
device.isDisconnected
- [Fix] stream asserts when calling
startScan
twice quickly
- [Fix]
cancelWhenScanComplete
must handle error cases
- [Feature] add
cancelWhenScanComplete
convenience function
- [Improve] Updated README & Example app
- [Fix] iOS: mtu and auto connect are incompatible
- [Fix]
adapterState.first
&connectionState.first
dont work (regression 1.30.7)
- [Fix] Gradle 7 (Flutter 2) would not build (regression 1.7.6)
- [Fix] iOS: scan filters were doing nothing (regression 1.31.0)
This release adds support for multiple scan filters at the same time.
- [Feature] iOS: support multiple scan filters at the same time
- [Improve] assert: fbp only supprts a single
scan
filter at a time
- [Improve] android: discoverServices: add
subscribeToServicesChanged
option
- [Fix]
autoConnect
not always working (bug in 1.30.0) - [Fix] perf:
NewStreamWithInitialValue
was not closing its streams (regression 1.17.2) - [Feature] add
device.isAutoConnectEnabled
- [Improve] ios log more detail
- [Feature] add
adapterStateNow
getter
- [Fix] iOS build error (regression 1.30.4)
- [Fix] android
autoConnect
was broken (regression 1.30.1)
- [Fix] Perf: must close
adapterState
,bondState
&scanResults
BufferStreams - [Improve] iOS: set
kCBConnectOptionEnableAutoReconnect
option - [Improve] requestMtu: add
predelay
argument - [Example] only call
setState
if mounted
- [Fix] android: connect crashes (regression in 1.30.0)
- [Improve] auto connect: assert that mtu is null in
connect
- [Feature] auto connect: remove
setAutoConnect
function added in 1.30.0 and go back to usingconnect:autoConnect
parameter
This release greatly improves autoconnect
support on Android, and adds iOS support.
- [Improve] android: auto connect is no longer canceled when bluetooth is turned off
- [Fix] android:
deadObjectExceptions
when bluetooth is turned off
- [Improve] android: add delay before
requestMtu
is called to work arounddiscoverServices
timeout
- [Fix] android:
CALLBACK_TYPE_FIRST_MATCH
causes scanning issues (regression in 1.27.0) - [Fix] android:
withKeywords
wasn't filtering out adverts that have no scan record (bug in original feature)
- [Fix] android:
remoteId
was wrong (regression in 1.29.10)
- [Fix] android:
isNotifying
was not updated (regression in 1.28.5) - [Improve] accidentally logging 'canceling connection in progress' every time
- No changes. This version was accidentally skipped.
- [Fix] android: crash due to wrong type cast (regression in 1.29.7)
- [Fix] scan errors should be pushed to
scanResults
stream (bug in originalflutter_blue
) - [Fix] android: scan: when
continuousUpdates
isfalse
, don't filter non-duplicate adverts (bug in original feature) - [Improve] make sure
continuousDivisor
only applies whencontinuousUpdates
is true
- [Improve] default
continuousDivisor
should be 1 - [Improve]
continuousDivisor
should be applied after scan filters
- [Fix] iOS: 'service not found' if service supports short uuid (regression 1.28.5)
- [Improve] android: handle
turnOn
user rejected
- [Fix] characteristics with same UUID could return wrong
properties
ordescriptors
(regression in 1.20.4)
- [Improve] more refinements to
onScanResults
- [Breaking Change]
scanResults
: do not clear results afterstopScan
. If you want results cleared useonScanResults
instead. - [Add]
lastScanResults
to synchronously get the most recent results
- [Fix]
setAdvertisingDataType
crash on android 10 and below (regression in 1.28.10)
- [Fix]
isNotifying
was not set to false on disconnection (regression in 1.28.9)
- [Fix] crash if
rssi
was zero on android (regression in 1.27.2)
- [Rename]
giud.uuid
->guid.str
&guid.uuid128
->guid.str128
- [Add] connect:
timeout
argument is now optional. infinite timeout is possible on iOS
- [Perf] android: filter out devices without names if
scan.withKeywords
is set - [Fix] calling scan multiple times would breifly push
isScanning=false
- [Improve]
servicesList
: return empty instead of null
- [Improve] to make FBP easier to use, never clear
knownServices
- [Fix] android: GUID issues related to scanning (regression in 1.28.3)
- [Fix] android: GUID starting with 0000 were misinterpretted (regression in 1.28.5)
- [Improve] simplify api: clear
knownServices
on reconnection instead of disconnection - [Improve] dont clear
bondState
cache when device is disconnected. unecessary.
- [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
GUID
s foradvertisingData.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 tosetNotifyValue
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 usesstartScan.removeIfGone
, or your app continually checks the value ofscanResult.timestamp
orscanResult.rssi
, then you will need to explicitly setcontinousUpdates
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 formerallowDuplicates
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
whenonDetachedFromEngine
is called (bug in originalflutter_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 exposingevents.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 originalflutter_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 originalflutter_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 originalflutter_blue
)
- [Refactor]
bondState
: finish refactor started in 1.18.0
- [Fix]
bondState
: must explicitly check for nullprevState
(regression in 1.18.0)
- [Fix]
bondState
: handle nullprevState
(regression in 1.18.0)
This release improves bondState
stream
- [Breaking Change]
bondState
: directly exposeprevBond
instead of lost/failed flags
- [Fix]
scanResults
: clear scan results onstopScan
(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 ofSingleChildScrollView
- [Fix] android:
turnOn
throws exception if permission denied (bug in originalflutter_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 originalflutter_blue
) - [Fix] android: was not calling
disconnect
callback when adapter turned off (bug in originalflutter_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
whenwrite
is called - [Feature] Android: support
onNameChanged
&onServicesChanged
characteristics - [Fix] iOS:
discoverServices
crash "[_NSInlineData intValue]: unrecognized selector sent to instance" (bug in originalflutter_blue
) - [Fix] iOS:
descriptor.write
would timeout or not work (regression somewhere around ~1.7.0) - [Fix]
isNotifying
was not updated bysetNotifyValue(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
- [Rename]
isAvailable
->isSupported
- [Example] Refactor: hugely refactored to use stateful widgets
- [Example] Fix: stream already listened to error
- [Improve]
connectionState
&mtu
: use broadcast stream
- [Fix] iOS: iOS Unhandled Exception: type 'int' is not a subtype of type 'bool' (regression in 1.16.3)
- [Improve] android: prepend logs with '[FBP]'
- [Java] rename
com.boskokg.flutter_blue_plus
->com.lib.flutter_blue_plus
to be more generic
- [Fix]
setLogLevel
would be ignored due to being called twice (regression in 1.10.0) - [Improve] android: use log level consistently
- [Improve] iOS: use log level macro
- [Fix] Android:
setNotify
would timeout if CCCD descriptor does not exist (regression in 1.5.0) - [Android] fix deprecations
- [Improve]
removeIfGone
: only push to scanResults when list changes
- [Fix] platform check in
onNameChanged
&onServicesChanged
was incorrect
- [Add] iOS: add support for
onServicesChanged
&onNameChanged
This release simplifies BluetoothDevice construction.
- [Breaking Change] remove
BluetoothDevice.type
&BluetoothDevice.localName
from constructor for simplicity - [Breaking Change] remove
servicesStream
&isDiscoveringServices
deprecated functions - [Rename]
localName
->platformName
to reflect platform specific behavior - [Fix]
setNotifyValue
must takedescWrite
mutex (bug in originalflutter_blue
) - [Fix]
localName
was broken when usingconnectedSystemDevices
(regression in 1.15.10) - [Add] Android:
getPhySupport
- [Fix] iOS:
localName
does not match Android (bug in originalflutter_blue
) - [Fix] flutterRestart: error was thrown if device did not have bluetooth adapter (regression in 1.14.19)
- [Fix] iOS: adapter turnOff: edge case when adapter is turned off while scanning (bug in original
flutter_blue
) - [Fix] iOS: adapter turnOff: disconnect handlers not firing when adapter turned off (bug in original
flutter_blue
) - [Fix] iOS: adapter turnOff: API MISUSE when adapter is turned off (bug in original
flutter_blue
) - [Cleanup] Hot Restart: use separate
connectedCount
method for clarity
- [Fix] if any platform exception happens, fbp will deadlock (regression in 1.14.20)
- [Fix] android: turning bluetooth off would not fully disconnect devices (regression in 1.14.19)
- [Fix] iOS: turning bluetooth off would not fully disconnect devices (regression in 1.14.19)
- [Readme] add v1.15.0 migration guides
- [Fix]
firstWhereOrNull
conflict (regression in 1.15.0)
- [Fix] some typos in disconnect exceptions (regression in 1.15.3)
- [Improve] prefer dart exceptions over platform exceptions when device is disconnected
- [Fix]
stopScan
was not awaiting for invokeMethod (regression in 1.15.0)
- [Fix]
FlutterBluePlus.scanResults
should always return list copy to avoid iteration exceptions (regression in 1.15.0)
Overview:
- [Refactor] simplify scanning api
- [Feature] add
removeIfGone
option tostartScan
Breaking Changes & Improvements:
- [Simplify] removed
FlutterBluePlus.scan
. UseFlutterBluePlus.scartScan(oneByOne: true)
instead. - [Simplify] removed
allowDuplicates
option forscartScan
. It is not supported on android. We always filter duplicates anyway. - [Simplify] removed
macAddresses
option forscartScan
. It was not supported on iOS, and is overall not very useful. - [Simplify]
startScan
now returnsFuture<void>
instead ofFuture<List<ScanResult>>
. It was redundant and confusing. - [Improve] if you
await startScan
it will complete once the scan starts, instead of when it ends - [Improve] if you call
startScan
twice, it will cancel the previous scan, instead of throwing an exception
- [Fix] Android:
setNotifyValue
: "(code: 5) notifications were not updated" (regression in 1.14.23) - [Fix] Hot Restart: stop scanning when hot restarting (bug in original
flutter_blue
)
- [Fix]
setNotifyValue
& others must be cleared after disconnection (regression in 1.14.21)
- [Fix] Android: Hot Restart: could get stuck in infinite loop (regression in 1.14.19)
- [Refactor] dart: store
lastValue
at global level so Desc & Chr classes are fully immutable
- [Fix] iOS: Hot Restart: could get stuck in infinite loop (regression in 1.14.19)
- [Fix] Hot Restart: close all connections when dart vm is restarted (bug in original
flutter_blue
)
- [Fix] Android: crash
uuid128
null deref (regression in 1.14.17)
- [Fix] Android: shortUUID: characteristic not found (bug in original
flutter_blue
)
- [Fix] macOS: lower required version to 10.11 (equivalent to iOS 9.0)
- [Rename]
allowSplits
->allowLongWrite
- [Fix] Android: "dataLen longer than allowed" (regression in 1.14.13)
- [Fix] iOS: onMtu was not called (bug in original
flutter_blue
) - [Feature] iOS & Android:
writeCharacteristic
: addallowLongWrite
option to do longer writes
- [Fix] Android:
autoconnect
was not working. (regression sometime after 1.4.0) - [Cleanup] Android: cleanup
bmAdvertisementData
- [Improve] iOS: check that characteristic supports READ, WRITE, WRITE_NO_RESP properties and throw error otherwise
- [Deprecate] dart:
isDiscoveringServices
&servicesStream
. They can be easily implemented yourself
- [Fix] iOS: scan results with empty manufacturer data was not parsed (bug in original
flutter_blue
)
- [Fix] iOS:
disconnectReasonCode
&disconnectReasonString
are mixed up (bug from when feature was added)
- [Feature] Dart: add
device.disconnectReason
- [Improve] Dart: breaking change: rename
bondState()
->bondState
- [Fix] Dart: calling
connect
ordisconnect
multiple times should not re-push to connectionState stream (regression in 1.14.0) - [Fix] Android: calling
connect
ordisconnect
multiple times could fail(regression in 1.14.7) - [Fix] Android: security exception on
startScan
for some phones (regression in 1.13.4) - [Fix] Dart: various streams could push values out of order (bug in original
flutter_blue
)
[Fix] Android: connected & disconnected states not received (regression in 1.14.4)
[Fix] iOS: disconnect
would timeout if already disconnected (regression in 1.14.0)
- [Improve] Dart:
adapterState
,bondState
,mtu
,connectiontate
could miss changes due to race conditions
- [Improve] Dart: deprecate
disconnecting
&connecting
states, they're not actually streamed by Android or iOS - [Improve] Dart: increase default connection timeout 15 -> 35 seconds to slightly exceed android & iOS defaults
- [Improve] Example: unsubscribe snackbar showed 'Subscribe: Success' incorrectly
- [Improve] Example: add snackbar color blue & red for success & fail
- [Improve] Example: add spinner while connecting or disconnecting
- [Improve] Example: do not continually call
connectedSystemDevice
& RSSI
- [Improve] Example: was using deprecated variable name
- [Improve] Dart:
knownServices
should be fully cleared on disconnection - [Improve] Dart: error handling: return more descriptive timeout exceptions
- [Improve] Dart: each
FlutterBluePlusException
should have unique code for handling
This release improves bonding support.
- [feature] Android: expose
BluetoothDevice.bondState
- [remove] changes regarding bond state made in 1.13.0 in favor of exposing bondState
- [refactor] BluetoothDevice & Android bond handling to improve reliablility & error handling.
- [Fix] Dart: BluetoothDevice:
connect
&disconnect
and others could incorrectly timeout (bug in originalflutter_blue
) - [Fix] Dart: BluetoothDevice:
getBondState
,getMtu
,getConnectionState
could skip values (bug in originalflutter_blue
) - [Fix] Dart: clear
servicesList
after disconnection. Android requires you calldiscoverServices
again - [Improve] Example: Subscribe button was not updating
- [Improve] Android: prefer
result.error
over exceptions - [Improve] Example: show snackbars on success as well
- [Fix] Android:
discoverServices
never returns (regression in 1.13.0) - [Fix] Android:
turnOn
&turnOff
must check for permissions (bug in originalflutter_blue
) - [Fix] Android:
startScan
should not requiredBLUETOOTH_CONNECT
permission (bug in originalflutter_blue
)
- [Fix] Dart: be extra careful to only call connect & disconnect when necessary (regression in 1.13.0)
- [Fix] Dart: connect should be no-op if already connected (regression in 1.13.1)
- [Improve] Dart: BluetoothDevice: use mutexes to prevent multiple in flight requests
- [Fix] Android/iOS: on connection failure, return right away (bug in original
flutter_blue
) - [Improve] Android/iOS: on connection failure, return error code and error string
This release improves bonding support.
- [Fix] Android:
discoverServices
& others can fail if currently in the process of bonding (bug in originalflutter_blue
) - [Improve] Android:
createBond
: check for success and throw exception on failure - [Improve] Android:
removeBond
: returnFuture(void)
instead ofFuture(Bool)
, and throw exception on failure
- [Fix] Android: min sdk is currently 21, not 19 (bug in original
flutter_blue
) - [Fix] Android:
getOrDefault
not available in AndroidSdkLevel < 24 (regression in 1.7.0) - [Improve] Android: log: BOND changes
- [rename] Android:
pair
->createBond
- [Fix] iOS:
FlutterBluePlus.isAvailable
'int' is not a subtype of type 'FutureOr' (regressed in 1.12.10)
- [Fix] Android: null ptr deref during
ScanResult
connectionState
(regressed in 1.10.6) ^^^ connectionState was added to scanResults last week. It was not a good idea, and is now fully removed.
- [Fix] Android: potential null dereference if the platform does not have bluetooth (bug in original
flutter_blue
) - [Fix] Android:
DeadObjectException
: close all connections when bluetooth is turned off (bug in originalflutter_blue
)
- [Fix] iOS:
isAvailable
returns false the first time, incorrectly (bug in originalflutter_blue
) - [Fix] iOS: descriptors, must handle
NSData
,NSString
, &NSNumber
correctly (bug in originalflutter_blue
) - [Improve] Android:
turnOff
is deprecated in Android
- [Fix] Dart:
servicesStream
: 'bad state: Stream has already been listened to' (bug in originalflutter_blue
) - [Fix] Dart: remove unecessary print (regression in 1.11.7)
- [Fix] Android: add blank
AndroidManifest.xml
to fix build errors in older flutter (regression in 1.12.0) - [Fix] Android/iOS: infinite recursion when included services includes itself (bug in original
flutter_blue
) - [Fix] iOS:
FlutterBluePlus.isOn
returns 'no' first time even though it is on (bug in originalflutter_blue
) - [Improve] Dart: mutex should make sure writes happen in the same order as called
- [Improve] Dart:
setLogLevel
color now optional
- [Fix] Android: null ptr in
setPreferredPhy
&setConnectionPriority
(regression in 1.7.0)
- [Fix] iOS: mtu returned on iOS was 3 too small (bug in original
flutter_blue
) - [Improve] Dart: simplify mutexes. improves throughput for chrs that support
write
&writeWithoutResponse
- [Improve] Dart: verbose logging: brown == data from platform
- [Improve] Dart: add more logging when in verbose mode, with color
- [Fix] Android: build error typo (regression in 1.12.3)
- [Fix] Android:
mConnectionState
&mMtu
not cleared whenonDetachedFromEngine
(regression in 1.10.10)
- [Fix] Example: Android: add back
INTERNET
permission for debug and profile modes. needed for debugging (regression in 1.12.0) - [Improve] Android: create
BluetoothManager
duringonMethodCall
, as opposed to app startup
- [Improve] Android: simplify
build.grade
to not set specific gradle version. it is uneeded
This release simplifies permissions.
- [Improve] Android: remove permissions from plugin. It is easier for user to specify everything
- [Fix] Dart:
scan
could be initiated twice causing bad state (bug in originalflutter_blue
) - [Fix] Dart: read & write mutexs must always come from the
MutexFactory
to properly prevent race conditions
- [Fix] Android/iOS:
setLogLevel
,getAdapterState
,getAdapterName
returning error when adapter not available
- [Fix] Dart: ensure only 1 mutex per characteristic to prevent race issues and dropped packets (bug in original
flutter_blue
) - [perf] Dart:
writeWithoutResponse
should use at least 1 mutex perremoteId
, to improve throughput - [Improve] Example: word wrapping on smaller screens
- [Fix] Dart:
writeWithoutResponse
should have its own mutex to prevent dropped packets (bug in originalflutter_blue
)
- [Fix] iOS: crash
discoverServices
crash after bluetooth adapter is toggled on/off (regressed sometime after 1.4.0) - [Improve] Example: dismiss
DeviceScreen
when bluetooth adapter is turned off - [Improve] Android/iOS: log
adapterState
andconnectionState
as strings
- [Fix] Android: null ptr exception getting Mtu (regression in 1.10.10)
- [Fix] Dart:
writeWithoutResponse
should wait for completion, to prevent dropped packets (bug in originalflutter_blue
)
- [Improve] Android: remove
shouldClearGattCache
connect option. It should be discouraged (called manually) (added in ~1.6.0)
- [Improve] Dart: add back
servicesList
, but with simpler api
This release removes recent changes to the API causing issues.
- [remove] Dart:
includeConnectedSystemDevices
scan setting, it was too complicated - [remove] Dart:
servicesList
(introduced in 1.10.6) - [rename] Dart:
connectedDevices
->connectedSystemDevices
- [Fix] Android: platform exception when scanning with
includeConnectedSystemDevices
(regression in 1.10.6) - [Fix] Dart: characteristic write crashed for negative values (regression in 1.7.0)
- [Fix] Dart:
connectionState
should only be concerned with our appsconnectionState
(bug in originalflutter_blue
)
- [Fix] Android:
turnOn
andturnOff
could timeout if already on or already off (regression in 1.10.0)
- [Fix] Android:
requestMtu
(regression in 1.10.6)
- [Improve] Dart:
disconnect
should wait for disconnect to complete
- [Improve] Dart: for convenience, scan results now also include connected devices see:
includeConnectedDevice
- [Improve] Dart: add
connectionState
toScanResult
- [Improve] Dart: add
BluetoothDevice.servicesList
for convenience, which callsdiscoverServices
automatically. - [rename] Dart:
BluetoothDevice.services
->BluetoothDevice.servicesStream
- [Fix] iOS: "API MISUSE: Cancelling connection for unused peripheral."
- [Improve] iOS: remove unecessary search of already connected devices during connection
- [Improve] iOS: add
remoteId
to error strings when connection fails, etc
- [Improve] Android: handle scan failure.
- [Improve] Dart: add verbose log level and remove unused log levels
- [Fix] Dart:
setLogLevel
recursion (regression in 1.10.0) - [Improve] iOS: use
NSError
instread of obj-c exceptions to avoid uncaught exceptions
- [Improve] Example: add error handling to descriptor read & write
This release improves error handling and reliability.
- [BREAKING CHANGE] Dart:
turnOn
&turnOff
now wait for completion, return void instead of bool, and can throw - [BREAKING CHANGE] Dart: use static functions for
FlutterBluePlus
instead ofFlutterBluePlus.instance
. Multiple instances is not supported by any platform. - [Improve] readme: add error handling section
- [Improve] iOS: handle missing bluetooth adapter gracefully
- [Improve] iOS:
getAdapterState
&&getConnectionState
are more robust - [Improve] Android: log method call in debug, and more consistent log messages
- [Improve] Example: show nicer looking errors
- [Improve] Example: prefer
try/catch
overcatchError
as dart debugger doesn't work withcatchError
as well
- [Fix] iOS:
serviceUUIDs
always null in scan results (regression in 1.7.0) - [Fix] Example: snackbar complaining about invalid contexts
- [Fix] iOS: characteristic read not working. (regression in 1.9.0)
- [Improve] Dart: handle
device.readRssi
failure inrssiStream
gracefully
- [Fix] iOS:
setNotify
returning error even though it succeeded (regression in 1.9.0) - [Fix] Dart:
Characteristic.isNotifying
was not working (regression in 1.9.0) - [Improve] Dart: add back uuid convenience variable for
BluetoothDescriptor
(deprecated in 1.8.6) - [Improve] Example: only show READ/WRITE/SUBSCRIBE buttons if the characteristic supports it
- [Improve] Example: add error handling
- [Fix] Dart:
readRssi
: "Invalid argument: Instance of 'DeviceIdentifier'" (regression in 1.9.0)
- [Fix] Dart: crash in scanning due to assuming uuid is Guid format when it might not (regression in 1.9.0)
- [Improve] Dart:
BluetoothCharacteristic.onValueReceived
should only stream successful reads (bug in 1.9.0) - [Improve] Dart: add convenience accessors for
BluetoothService.uuid
andBluetoothCharacteristic.uuid
as (deprecated in 1.8.6) - [Improve] Example: add macos support
This release marks the end of major work to improve reliability and simplicity of the FlutterBluePlus codebase. Please submit bug reports.
- [Breaking Change/Fix] Android: When
read
is calledonValueChangedStream
is pushed to as well. This change was made to make both platforms behave the same way. It is an unavoidable limitation of iOS. See: #419 - [Fix] Android/iOS: mtu check minus 3 issue (reggression in 1.8.3)
- [Fix] Dart:
BluetoothCharacteristic.state
variable not working (reggression in 1.8.6) - [Fix] Dart:
FlutterBluePlus.state
variable not working (reggression in 1.8.6) - [rename]
BluetoothCharacteristic.value
->lastValueStream
- [rename]
BluetoothDescriptor.value
->lastValueStream
- [rename]
BluetoothCharacteristic.onValueChangedStream
->onValueReceived
- [rename]
BluetoothDescriptor.onValueChangedStream
->onValueReceived
- [refactor] Dart:
adapterState
to usemethodChannel
- [refactor] Dart: various 'bm' message schemas to use simpler characteristic structure
- [refactor] Dart:
BmSetNotificationResponse
removed. It is simpler to reuseBmWriteDescriptorResponse
- [refactor] Android: move
secondaryServiceUuid
code its owngetServicePair
function - [refactor] Android: android
MessageMaker
to be a bit more legible
- [Fix] Android/iOS:
connectionState
not being updated (regression in 1.8.6) - [Fix] Android:
adapterState
shouldve beengetAdapterState
(regression in 1.8.6)
- [Improve] Dart: add 15 seconds default timeout for ble communication
- [rename] Dart:
BluetoothDevice.id
->remoteId
- [rename] Dart: uuid ->
characteristicUuid
/serviceUuid
/descriptorUuid
- [rename] Dart:
FlutterBluePlus.name
->adapterName
- [rename] Dart:
BluetoothDevice.name
->localName
- [rename] Dart:
FlutterBluePlus.state
->adapterState
- [rename] Dart:
BluetoothDevice.state
->connectionState
- [Improve] iOS: add support for
autoReconnect
(iOS 17 only)
- [Fix] iOS: check for nil peripheral. (regression in 1.8.3)
- [Fix] Android: clean up gatt servers
onDetachedFromEngine
(bug in originalflutter_blue
)
- [Improve] Android: make connectivity checks more robust
- [Improve] Android:
writeCharacteristic
: return error if longer than mtu - [Improve] Android: add device connection checks
- [Improve] iOS: add mtu size checks
- [Improve] iOS: add device connection checks
- [refactor] iOS: unify try catch blocks
- [Improve] Android: support sdk 33 for
writeCharacteristic
andwriteDescriptor
- [Improve] Android: calling
connect
on already connected device is now considered success - [Improve] Android: return more specific error for
locateGatt
issue - [Improve] Android:
shouldClearGattCache
is now called after connection, not before
- [Fix] Android: characteristic properties check was incorrect (regression in 1.7.8)
This release improves error handling.
- [Improve] android/ios: handle errors for
charactersticRead
- [Improve] android/ios: handle errors for
readDescriptor
- [Improve] android/ios: handle errors for
discoverServices
- [Improve] android/ios: handle errors for
mtu
- [Improve] android/ios: handle errors for
readRssi
- [Improve] android/ios: pass error string for
setNotifyValue
- [Improve] android/ios: pass error string for
charactersticWrite
- [Improve] android/ios: pass error string for
writeDescriptor
- [Improve] Android: add more useful errors for read and write characterist errors
- [Fix] Dart: scanning: "Bad state: Cannot add event after closing" (regression in 1.5.0)
- [Improve] Android: set
autoConnect
to false by default - [Improve] Example: remove
pubspec.lock
so users default to latest version
- [Fix] Dart:
BmBluetoothService.is_primary
was not set (regression in 1.7.0) - [Fix] Android:
BmAdvertisementData.connectable
was not set (regression in 1.7.0) - [Fix] Android: success was not set for
writeCharacteristic
,setNotification
,writeDescriptor
(regression in 1.7.0) - [Improve] Android: update to gradle 8
- [Improve] Android: dont request
ACCESS_FINE_LOCATION
by default (Android 12+)
- [Fix] Android:
BluetoothAdapterState
not being updated (regression in 1.7.0) - [Improve] Example: fix deprecations
- [Improve] Dart: remove
analysis_options.yaml
- [Fix] Android: Android 13 access fine location error (bug in original
flutter_blue
)
- [Fix] Android: exception thrown when
descriptor.write
is called (regression in 1.7.0)
- [Fix] Android: exception thrown when
characteristic.write
is called (regression in 1.7.0) - [Fix] Android:
bmCharacteristicProperties
was not being set correctly (regression in 1.7.0)
- [Fix] iOS: when connecting, exception is thrown (regression in 1.7.0)
This release removes Protobuf.
- [refactor] removed protobuf dependency
- [Fix] Android:
turnOn
andturnOff
not working (regression in 1.6.1) - [Fix] Dart:
guid
exception withserviceUUID
is empty (bug in originalflutter_blue
) - [Improve] Android:
compileSdkVersion
31 -> 33 - [Improve] Android: increase
minSdkVersion
19 -> 21 to remove lollipop checks - [Improve] Android: FineLocation permission is now optional. See
startScan
- [Improve] iOS: allow connecting without scanning if you save and reuse the
remote_id
- [Fix] Android: compile error (regression in 1.6.0)
- [Improve] Android: significantly clean up all code
This release reformats a bunch of Android code.
- [Fix] Dart: close
BufferStream
listen on stopScan (regression in 1.5.0) - [Improve] Dart: don't repropogate Mutex error
- [Improve] Dart: better stacktrace on error for Characteristic Read/Write
- [Improve] MacOS: use symbolic links to iOS version, to keep internal code in sync
- [Improve] Android: reformat code
- [Fix] Android: setNotification was throwing exception (regression in 1.5.0)
- [Fix] Dart: issue where startScan can hang forever (regression in 1.5.0)
- [Fix] Dart: some scanResults could be missed due to race condition (bug in original
flutter_blue
) - [Improve] Dart: dont export util classes & functions. they've been made library-private.
- [Improve] iOS: prepend all iOS logs with '[FBP-iOS]' prefix
- [Improve] iOS: log errors on failure
- [Improve] iOS: logs now adhere to logLevel
This release closes many open issues on Github.
- [Fix] Dart:
writeCharacteristic
(and other similar functions) exception could be missed (bug in originalflutter_blue
) - [Fix] Dart:
setNotifyValue
should check for success and throw error on failure (bug in originalflutter_blue
) - [Fix] Dart: race conditions in
connect
,disconnect
,readRssi
,writeCharacteristic
,readCharacteristic
(bug in originalflutter_blue
) - [Fix] iOS: Bluetooth adapter being stuck in unknown state (bug in original
flutter_blue
) - [Fix] iOS: dropping packets during bulk write without response (bug in original
flutter_blue
) - [Improve] Example: android permissions
- [Improve] Dart: add isScanningNow variable
- [Improve] add support for macOS
- [Improve] Android: replace deprecated bluetooth enable with
Enable-Intent
- [Improve] Android: Removed
maxSdkVersion=30
in manifest - [Improve] Android: add function:
setPreferredPh
- [Improve] Android: add function:
removeBond
- [Improve] Android: add function:
requestConnectionPriority
- [Improve] Android: allow for simultaneous MAC and ServiceUuid ScanFilters
- [Improve] Android: request location permission on Android 12+ when scanning (needed on some phones)
- [Improve] iOS: Use
CBCentralManagerOptionShowPowerAlertKey
for better UI popups - [Improve] Dart: Removed RxDart and other dependencies
-
Android: Add clear gatt cache method #142 (thanks to joistaus)
-
Android: Opt-out of the
neverForLocation
permission flag for theBLUETOOTH_SCAN
permission. (thanks to navaronbracke)If
neverForLocation
is desired, opt back into the old behavior by adding an explicit entry to your Android Manifest:<uses-permission android:name="android.permission.BLUETOOTH_SCAN" android:usesPermissionFlags="neverForLocation" />
-
Android: Scan BLE long range -devices #139 (thanks to jonik-dev)
-
Android: Prevent deprecation warnings #107 (thanks to sqcsabbey)
-
Allow native implementation to handle pairing request #109 (thanks to JRazek)
- Reverted: Ios: fixed manufacturer data parsing #104 (thanks to sqcsabbey)
- Ios: fixed manufacturer data parsing #104 (thanks to sqcsabbey)
- Ios: Fixed an error when calling the connect method of a connected device #106 (thanks to figureai)
- Android: Scan Filter by Mac Address #57 (thanks to Zyr00)
- Upgrading to linter 2.0.1, excluding generated ProtoBuf files from linting. (thanks to MrCsabaToth)
- connect timeout fixed (thanks to crazy-rodney, sophisticode, SkuggaEdward, MousyBusiness and cthurston)
- Add timestamp field to ScanResult class #59 (thanks to simon-iversen)
- Add FlutterBlue.name to get the human readable device name #93 (thanks to mvo5)
- Fix bug where if there were multiple subscribers to FlutterBlue.state and one cancelled it would accidentally cancel all subscribers (thank to MacMalainey and MrCsabaToth)
- Read RSSI from a connected BLE device #1 (thanks to sophisticode)
- Fixed a crash on Android OS 12 (added check for BLUETOOTH_CONNECT permission) (fixed by dspells)
- Added BluetoothDevice constructor from id (MAC address) (thanks to tanguypouriel)
- The previous version wasn't disconnecting properly and the device could be still connected under the hood as the cancel() was not called. (fixed by killalad)
- dependencies update (min micro version updating)
- Remove connect to BLE device after BLE device has disconnected #11 (fixed by sophisticode)
- fixed Dart Analysis warnings
- Copyright reverted to Paul DeMarco
- Possible crash fix caused by wrong raw data (fixed by narrit)
- Ios : try reconnect on unexpected disconnection (fixed by EB-Plum)
- Android: Add missing break in switch, which causes exceptions (fixed by russelltg)
- Android: Enforcing maxSdkVersion on the ACCESS_FINE_LOCATION permission will create issues for Android 12 devices that use location for purposes other than Bluetooth (such as using packages that actually need location). (fixed by rickcasson)
- First public release
- Supporting Android 12 Bluetooth permissions. #940
- Delay Bluetooth permission & turn-on-Bluetooth system popups on iOS #964
- The timeout was throwing out of the Future's scope #941
- Expose onValueChangedStream #882
- Android: removed V1Embedding
- Android: removed graddle.properties
- Android: enable background usage
- Android: cannot handle devices that do not set CCCD_ID (2902) includes BLUNO #185 #797
- Android: add method for getting bonded devices #586
- Ios: remove support only for x86_64 simulators
- Ios: Don't initialize CBCentralManager until needed #599
- mtuRequest returns the negotiated MTU
- Android: functions to turn on/off bluetooth
- Android: add null check if channel is already teared down
- Android: code small refactoring (fixed AS warnings)
- Android: add null check if channel is already teared down
- Ios: widen protobuf version allowed
- Android migrate to mavenCentral.
- Android support build on Macs M1
- Android protobuf-gradle-plugin:0.8.15 -> 0.8.17
- Ios example upgrade to latest flutter 2.5
- deprecated/removed widgets fixed in example
- Migrate the plugin to null safety.
- Fix Android project template files to be compatible with protobuf-lite.
- Add experimental support for MacOS.
- Add
allowDuplicates
option tostartScan
. - Fix performance issue with GUID initializers.
- Fix for FlutterBlue constructor when running on emulator.
- Return error when attempting to
discoverServices
while not connected.
- Fix incorrect value notification when write is performed.
- Add
toString
to each bluetooth class. - Various other bug fixes.
- Support v2 android embedding.
- Various bug and documentation fixes.
- Fix compilation issue with iOS.
- Bump protobuf version to 1.0.0.
- Update project files for Android and iOS.
- Remove dependency on protoc for iOS.
- Add
mtu
andrequestMtu
to BluetoothDevice.
- Fix duplicate characteristic notifications when connection lost.
- Fix duplicate characteristic notifications when reconnecting.
- Add minimum SDK version of 18 for the plugin.
- Documentation updates.
- Breaking change. API refactoring with RxDart (see example).
- Log a more detailed warning at build time about the previous AndroidX migration.
- Ensure that all channel calls to the Dart side from the Java side are done on the UI thread. This change allows Transactions to work with upcoming Engine restrictions, which require channel calls be made on the UI thread. Note this is an Android only change, the iOS implementation was not impacted.
- Breaking change. Migrate from the deprecated original Android Support Library to AndroidX. This shouldn't result in any functional changes, but it requires any Android apps using this plugin to also migrate if they're using the original support library.
- Upgrade Android Gradle plugin to 3.3.0.
- Refresh iOS build files.
- Set the verbosity of log messages with
setLogLevel
. - Updated iOS and Android project files.
autoConnect
now configurable for Android.- Various bug fixes.
- Fixed bug where setNotifyValue wasn't properly awaitable.
- Various UI bug fixes to example app.
- Removed unnecessary intl dependencies in example app.
- Breaking change. Manufacturer Data is now a
Map
of manufacturer ID's. - Service UUID's, service data, tx power level packets fixed in advertising data.
- Example app updated to show advertising data.
- Various other bug fixes.
- Updated to use the latest protobuf (^0.9.0+1).
- Updated other dependencies.
scan
withServices
to filter by service UUID's (iOS).- Error handled when trying to scan with adapter off (Android).
- Runtime permissions for Android.
scan
withServices
to filter by service UUID's (Android).- Scan mode can be specified (Android).
- Now targets the latest android SDK.
- Dart 2 compatibility.
- Now allows simultaneous notifications of characteristics.
- Fixed bug on iOS that was returning
discoverServices
too early.
- iOS support added.
- Bug fixed in example causing discoverServices to be called multiple times.
- Various other bug fixes.
- Breaking change. Upgraded to Gradle 4.1 and Android Studio Gradle plugin 3.0.1. Older Flutter projects need to upgrade their Gradle setup as well in order to use this version of the plugin. Instructions can be found here.
- Bug fixes
- Breaking changes:
startScan
renamed toscan
.ScanResult
now returns aBluetoothDevice
.connect
now takes aBluetoothDevice
and returns Stream.- Added parameter
timeout
toconnect
. - Automatic disconnect on deviceConnection.cancel().
- Breaking change. Removed
stopScan
from API, usescanSubscription.cancel()
instead. - Automatically stops scan when
startScan
subscription is canceled (thanks to @brianegan). - Added
timeout
parameter tostartScan
. - Updated example app to show new scan functionality.
- Added state and onStateChanged for BluetoothDevice.
- Updated example to show new functionality.
- Fixed image for pub.dartlang.org.
- Characteristic notifications/indications.
- Merged in Guid library, removed from pubspec.yaml.
- Initial Release.