flutter_ble_peripheral
This plugin enables a device to be set into peripheral mode, and advertise custom services and characteristics.
2.1.1
4.2K downloads/mo
#4093 most downloaded on pub.dev
juliansteenbakker/flutter_ble_peripheral
What this package is like to depend on
Last release 2 months ago
29 May 2026
Release timing varies
gaps range from 2 weeks to 1.2 years
Nearly every release is documented
notes for 27 of 27 stable releases
Nothing withdrawn
no release was ever pulled
6 years old
29 releases · first in 2020
4 releases in the last 12 months
see the full history below
Release timeline
29 releases · Mar 2020 to May 2026Releases
latest 29-
2.1.129 May 2026Release notes
Open source →Fixes
- [Windows] Fixed crash when Bluetooth adapter is not present or Bluetooth is disabled
- [Windows] Added comprehensive exception handling throughout the plugin to prevent crashes from WinRT API failures
- [Windows] Fixed initial state reporting to correctly show
unsupportedwhen no Bluetooth adapter is available - [Windows] Fixed potential crash from type mismatches in method call arguments
-
2.1.023 Jan 2026Release notes
Open source →New Features
- [iOS/macOS] Added
isBluetoothOnto check Bluetooth power state - [iOS/macOS] Added
hasPermissionusingCBPeripheralManager.authorizationAPI - [iOS/macOS] Added
requestPermissionsupport (returns current state, as permissions are implicit on Apple) - [iOS/macOS] Added
openBluetoothSettingsthat opens Bluetooth settings directly - [Android] Added
isBluetoothOnto check Bluetooth power state - [Android] Added Bluetooth state change listener - UI now updates when Bluetooth is toggled while app is open
- [Dart]
hasPermission()andrequestPermission()now work on iOS/macOS (previously returnedunknown)
Improvements
- [iOS/macOS]
isSupportednow uses peripheral manager state instead of iBeacon check - [iOS/macOS] Permission and Bluetooth state are now properly separated (permission can be checked regardless of power state)
- [Example] Complete redesign with Material 3 UI
- [Example] Added comprehensive startup checks for: BLE support, permissions, Bluetooth state
- [Example] Platform-specific permission dialogs (Apple shows Settings only, Android shows Grant button)
- [Example] Android permission dialog updates when permanently denied
- [Example] Bluetooth off dialog hides "Turn On" button on Apple (not supported)
- [Windows] Updated build configuration
Fixes
- [iOS/macOS]
enableBluetoothnow properly returnsfalse(not supported on Apple platforms)
- [iOS/macOS] Added
-
2.0.121 Nov 2025 -
2.0.004 Nov 2025Release notes
Open source →- [Android] Update java and minsdk to latest
- [Apple] Merge of ios and macos codebase
- Complete rewrite of permission system
Release notes
Open source →- [Android] Update java and minsdk to latest
- [Apple] Merge of ios and macos codebase
- Complete rewrite of permission system
-
1.2.610 Sep 2024 -
1.2.506 Jun 2024Release notes
Open source →- [Android] Added advertiseSet parameter to AdvertiseSettings to enable advertiseSet on Android o and higher devices.
Release notes
Open source →- [Android] Added advertiseSet parameter to AdvertiseSettings to enable advertiseSet on Android o and higher devices.
-
1.2.418 Mar 2024Release notes
Open source →- [iOS & macOS] Fixed an issue which caused the first advertisement not to be broadcast.
Release notes
Open source →- [iOS & macOS] Fixed an issue which caused the first advertisement not to be broadcast.
-
1.2.317 Nov 2023 -
1.2.212 Oct 2023Release notes
Open source →- [Android] Fixed serviceUuid not working. (thanks @Shik1266 !)
- [Android] Updated compileSdk to 34.
Release notes
Open source →- [Android] Fixed serviceUuid not working. (thanks @Shik1266 !)
- [Android] Updated compileSdk to 34.
-
1.2.131 Jul 2023 -
1.2.029 Jun 2023Release notes
Open source →Improvements:
- Added support for windows
- Updated bluetooth permissions system for Android, no need for permission handler anymore.
- Updated dependencies and several other small improvements.
-
1.1.120 Oct 2022Release notes
Open source →Bugs fixed:
- Fixed an issue which caused the enableBluetooth function to reply twice.
- Fixed analyzer issues
- Upgraded dependencies
-
1.1.020 Oct 2022Release notes
Open source →Upgraded android sdk to 33. Added permission check on enableBluetooth function.
-
1.0.005 May 2022Release notes
Open source →Stable release including the changes noted in the beta releases. This release also updates Android dependencies.
-
1.0.0-beta.219 Apr 2022 pre-release -
1.0.0-beta.106 Apr 2022 pre-releaseRelease notes
Open source →BREAKING CHANGES: You now define the data to be advertised using the AdvertiseData() constructor. AdvertiseData is the only supported object in iOS. AdvertiseSettings and other objects are only supported on Android.
NEW:
- You can now make use of the new startAdvertisingSet parameter on Android 26+
-
0.6.018 Jan 2022Release notes
Open source →- Refactored large parts of the code for both Android & iOS.
- Upgraded Android to Android 12 permission system.
- Other minor improvements
-
0.5.021 Jul 2021Release notes
Open source →Added isSupported function to check if BLE advertising is supported by the device.
-
0.5.0+121 Jul 2021 -
0.4.214 Jul 2021 -
0.4.114 Jul 2021Release notes
Open source →Fixed bug on iOS which led to crash Added local name to advertising in iOS Updated Android dependencies
-
0.4.006 Apr 2021 -
0.3.018 Mar 2021Release notes
Open source →Upgraded to null-safety Updated dependencies Changed to pedantic
Bug fixes
- Fixed null-pointer when bluetooth adapter isn't found
-
0.2.026 Aug 2020 -
0.1.012 May 2020Release notes
Open source →Fixed several parts for Android:
- Advertising local name
- Advertising Manufacturer Data
- Advertising Service Data
-
0.0.415 Apr 2020 -
0.0.307 Apr 2020 -
0.0.206 Apr 2020 -
0.0.131 Mar 2020Release notes
Open source →Initial version of the library. This version includes:
- broadcasting a custom UUID