This is React Native Bluetooth Low Energy library wrapping Multiplatform Ble Adapter.
It supports:
- observing device's Bluetooth adapter state
- scanning BLE devices
- making connections to peripherals
- discovering services/characteristics
- reading/writing characteristics
- observing characteristic notifications/indications
- reading RSSI
- negotiating MTU
- background mode on iOS
- turning the device's Bluetooth adapter on
It does NOT support:
- bluetooth classic devices.
- communicating between phones using BLE (Peripheral support)
- bonding peripherals
This version (2.x) breaks compatibility with old RN versions. Please check old README (1.x) for the old instructions or migration guide.
React Native | 2.0.0 |
---|---|
0.62.2 | ✅ |
0.61.5 | ✅ |
0.60.6 | ✅ |
2.0.0
- Update direct dependency to Multiplatform Ble Adapter
- Remove support for RN version < 0.60
- Fixed Typescript
callbackType
type definition.
Interested in React Native project involving Bluetooth Low Energy? We can help you!
Learn more about Polidea's React Native services.
Learn more about Polidea's BLE services.
Documentation can be found here.
Contact us at Polidea.
Contact us at Gitter if you have any questions, feedback or want to help!
- Make sure your Expo project is ejected (formerly: detached). You can read how to do it here and here. (only for expo)
- Follow steps for iOS/Android.
iOS (example setup)
npm install --save react-native-ble-plx
npx react-native link react-native-ble-plx
- Open Xcode workspace located inside
ios
folder and add empty Swift file if you don't have at least one:- Select File/New/File...
- Choose Swift file and click Next.
- Name it however you want, select your application target and create it.
- Accept to create Objective-C bridging header.
- Update your
ios/Podfile
to contain (it may be already there):pod 'react-native-ble-plx', :path => '../node_modules/react-native-ble-plx'
- Enter
ios
folder and runpod update
- Add
NSBluetoothAlwaysUsageDescription
ininfo.plist
file. (it is a requirement since iOS 13) - If you want to support background mode:
- In your application target go to
Capabilities
tab and enableUses Bluetooth LE Accessories
inBackground Modes
section. - Pass
restoreStateIdentifier
andrestoreStateFunction
toBleManager
constructor.
- In your application target go to
Android (example setup)
npm install --save react-native-ble-plx
npx react-native link react-native-ble-plx
- In top level
build.gradle
make sure that min SDK version is at least 18:
buildscript {
ext {
...
minSdkVersion = 18
...
- In
build.gradle
make sure to add jitpack repository to known repositories:
allprojects {
repositories {
...
maven { url 'https://www.jitpack.io' }
}
}
- In
AndroidManifest.xml
, add Bluetooth permissions and update<uses-sdk/>
:
<manifest xmlns:android="http://schemas.android.com/apk/res/android"
...
<uses-permission android:name="android.permission.BLUETOOTH"/>
<uses-permission android:name="android.permission.BLUETOOTH_ADMIN"/>
<uses-permission-sdk-23 android:name="android.permission.ACCESS_FINE_LOCATION"/>
<!-- Add this line if your application always requires BLE. More info can be found on:
https://developer.android.com/guide/topics/connectivity/bluetooth-le.html#permissions
-->
<uses-feature android:name="android.hardware.bluetooth_le" android:required="true"/>
...
Add this to your app/proguard-rules.pro
-dontwarn com.polidea.reactnativeble.**