Plugin.BLE 3.3.0-beta.2

.NET 9.0 This package targets .NET 9.0. The package is compatible with this framework or higher.
This is a prerelease version of Plugin.BLE. 
dotnet add package Plugin.BLE --version 3.3.0-beta.2
                    


                    

                
NuGet\Install-Package Plugin.BLE -Version 3.3.0-beta.2
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package. 
<PackageReference Include="Plugin.BLE" Version="3.3.0-beta.2" />
For projects that support PackageReference, copy this XML node into the project file to reference the package. 
<PackageVersion Include="Plugin.BLE" Version="3.3.0-beta.2" />
                    


                            Directory.Packages.props
                        

                    

                
<PackageReference Include="Plugin.BLE" />
                    


                            Project file
For projects that support Central Package Management (CPM), copy this XML node into the solution Directory.Packages.props file to version the package. 
paket add Plugin.BLE --version 3.3.0-beta.2
                    


                    

                
#r "nuget: Plugin.BLE, 3.3.0-beta.2"
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package. 
#:package Plugin.BLE@3.3.0-beta.2
#:package directive can be used in C# file-based apps starting in .NET 10 preview 4. Copy this into a .cs file before any lines of code to reference the package. 
#addin nuget:?package=Plugin.BLE&version=3.3.0-beta.2&prerelease
                    


                            Install as a Cake Addin
                        

                    

                
#tool nuget:?package=Plugin.BLE&version=3.3.0-beta.2&prerelease
                    


                            Install as a Cake Tool

<img src="icon_small.png" width="71" height="71"/> Bluetooth LE plugin for Xamarin & MAUI

Build status: Build status

Xamarin, MAUI and MvvMCross plugin for accessing the bluetooth functionality. The plugin is loosely based on the BLE implementation of Monkey Robotics.

Important Note: With the term "vanilla" we mean the non-MvvmCross version, i.e. the pure Xamarin or MAUI plugin. You can use it without MvvmCross, if you download the vanilla package.

Support & Limitations

Release Notes

Platform Version Limitations
Xamarin.Android 4.3
Xamarin.iOS 7.0
Xamarin.Mac 10.9 (Mavericks) >= 2.1.0
Xamarin.UWP 1709 - 10.0.16299 >= 2.2.0
MAUI (Android, iOS, Mac, WinUI) >= 3.0.0

Nuget Packages

package stable beta downloads
Plugin.BLE NuGet NuGet Beta Downloads
MvvmCross.Plugin.BLE NuGet MvvMCross NuGet MvvMCross Beta Downloads

Usage

Sample app

We provide a sample Xamarin.Forms app, that is a basic bluetooth LE scanner. With this app, it's possible to

  • check the BLE status
  • discover devices
  • connect/disconnect
  • discover the services
  • discover the characteristics
  • see characteristic details
  • read/write and register for notifications of a characteristic

Have a look at the code and use it as starting point to learn about the plugin and play around with it.

How to build the nuget package

  1. Build

    Open a console, change to the folder "dotnet-bluetooth-le/.build" and run cake.

  2. pack the nuget

    nuget pack ../Source/Plugin.BLE/Plugin.BLE.csproj

    nuget pack ../Source/MvvmCross.Plugins.BLE/MvvmCross.Plugins.BLE.csproj

How to contribute

We usually do our development work on a branch with the name of the milestone. So please base your pull requests on the currently open development branch.

Licence

Apache 2.0

Product Compatible and additional computed target framework versions.
.NET net9.0 is compatible.  net9.0-android was computed.  net9.0-android35.0 is compatible.  net9.0-browser was computed.  net9.0-ios was computed.  net9.0-ios18.0 is compatible.  net9.0-maccatalyst was computed.  net9.0-maccatalyst18.0 is compatible.  net9.0-macos was computed.  net9.0-tvos was computed.  net9.0-windows was computed.  net9.0-windows10.0.19041 is compatible.  net10.0 is compatible.  net10.0-android was computed.  net10.0-android36.0 is compatible.  net10.0-browser was computed.  net10.0-ios was computed.  net10.0-ios26.0 is compatible.  net10.0-maccatalyst was computed.  net10.0-maccatalyst26.0 is compatible.  net10.0-macos was computed.  net10.0-tvos was computed.  net10.0-windows was computed.  net10.0-windows10.0.19041 is compatible. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

  • net10.0

    • No dependencies.

  • net10.0-android36.0

    • No dependencies.

  • net10.0-ios26.0

    • No dependencies.

  • net10.0-maccatalyst26.0

    • No dependencies.

  • net10.0-windows10.0.19041

    • No dependencies.

  • net9.0

    • No dependencies.

  • net9.0-android35.0

    • No dependencies.

  • net9.0-ios18.0

    • No dependencies.

  • net9.0-maccatalyst18.0

    • No dependencies.

  • net9.0-windows10.0.19041

    • No dependencies.

NuGet packages (21)

Showing the top 5 NuGet packages that depend on Plugin.BLE:

Package Downloads
MvvmCross.Plugin.BLE

MVVMCross Plugin to access Bluetooth Low Energy functionality on Android, iOS, macOS, and Windows. Read the full documentation on the projects page.
Buttplug.Server.Managers.XamarinBluetoothManager

Xamarin Bluetooth LE (Android/iOS) device support for Buttplug Servers, using Plugin.BLE. (.Net Standard 2.0)
Plugin.BLE.FTMS

Package Description
XBeeLibrary.Xamarin

C# library for Xamarin to interact with Digi International's XBee radio frequency modules from mobile devices.
Moduware.Platform.Core

Library to work with Moduware modular platform.

GitHub repositories (4)

Showing the top 4 popular GitHub repositories that depend on Plugin.BLE:

Repository Stars
VladislavAntonyuk/MauiSamples
.NET MAUI Samples
lswiderski/mi-scale-exporter
Mobile App to export data from Mi Body Composition Scale and upload it to Garmin Connect Cloud
densen2014/BlazorHybrid
关于BlazorHybrid的一切研究. 用 c # 和 Razor 创建本机移动应用和桌面应用。快速开发共享代码库运行于 Windows (Winforms/WPF/UWP)、Android、iOS、macOS、Linux 的应用。
sharpbrick/powered-up
.NET implementation of the LEGO PoweredUp Protocol
Version Downloads Last Updated
3.3.0-beta.2 57 5/11/2026
3.3.0-beta.1 1,828 1/27/2026
3.2.0 64,477 10/26/2025
3.2.0-beta.2 1,296 10/12/2025
3.2.0-beta.1 6,940 3/30/2025
3.1.0 471,523 5/20/2024
3.1.0-rc.1 6,084 5/3/2024
3.1.0-beta.3 3,152 3/25/2024
3.1.0-beta.2 4,617 2/12/2024
3.1.0-beta.1 20,401 11/17/2023
3.0.0 161,266 10/8/2023
3.0.0-rc.1 4,983 9/21/2023
3.0.0-beta.6 3,147 9/5/2023
3.0.0-beta.5 11,644 8/5/2023
3.0.0-beta.4 16,254 5/21/2023
3.0.0-beta.3 25,810 4/17/2023
3.0.0-beta.2 19,062 11/24/2022
3.0.0-beta.1 8,504 11/17/2022
2.2.0-pre5 19,741 7/11/2022
2.2.0-pre4 1,244 6/1/2022
Loading failed

https://github.com/dotnet-bluetooth-le/dotnet-bluetooth-le/blob/master/doc/changelog.md