React Native Bluetooth Low Energy library using RxBluetoothKit and RxAndroidBle as it's backend libraries.
Example apps are available in Google Play and App Store!
0.8.0
- Fix regression of Base64 encoding on Android platform. When large chunk of Base64 data was sent from Android it contained new lines characters.
- Updated RxAndroidBle to version 1.4.3.
- Fixed colissions in Characteristic and Service id generation on Android. The collisions had place if multiple devices with the same characteristic/service UUIDs were connected at the same time.
- Fixed dropped notifications right after setup on Android. Before there was small window when notification was monitored and listener for it wasn't mounted.
- Minor documentation updates.
Documentation can be found here.
Contact us at Gitter if you have any questions, feedback or want to help!
If you do not have Carthage installed yet and wish to set up for iOS, please install it first and only then follow the steps given below
npm install --save react-native-ble-plx
react-native link react-native-ble-plx
Both on iOS and Android continue manually from step 7.
- Add
react-native-ble-plx
to a project as a dependency inpackage.json
file. For example"react-native-ble-plx": "Polidea/react-native-ble-plx"
will install latest version from Polidea's Github repository. - Make sure that you have Carthage installed on your system.
- Execute
npm install
to fetch and install a library. - Open iOS project located in
./ios
folder. - Move
BleClient.xcodeproj
located in.node_modules/react-native-ble-plx/ios
using drag & drop toLibraries
folder in your project. - In general settings of a target add
libBleClient.a
to Linked Frameworks and Libraries. - In
Build Settings
/Search Paths
/Framework search paths
add path:$(SRCROOT)/../node_modules/react-native-ble-plx/ios/BleClientManager/Carthage/Build/iOS
. - In
Build Settings
/Build Options
/Always Embed Swift Standard Libraries
set toYes
. - In
Build Phases
click on top left button and addNew Run Script Phase
.
- Shell command:
/usr/local/bin/carthage copy-frameworks
- Input Files:
$(SRCROOT)/../node_modules/react-native-ble-plx/ios/BleClientManager/Carthage/Build/iOS/BleClientManager.framework
$(SRCROOT)/../node_modules/react-native-ble-plx/ios/BleClientManager/Carthage/Build/iOS/RxSwift.framework
$(SRCROOT)/../node_modules/react-native-ble-plx/ios/BleClientManager/Carthage/Build/iOS/RxBluetoothKit.framework
- Minimal supported version of iOS is 8.0
- 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
- Add
react-native-ble-plx
to a project as a dependency inpackage.json
file. For example"react-native-ble-plx": "Polidea/react-native-ble-plx"
will install latest version from Polidea's Github repository. - Execute
npm install
to fetch and install a library. - Open Android project located in
./android
folder. - In
settings.gradle
add following lines:
include ':react-native-ble-plx'
project(':react-native-ble-plx').projectDir = new File(rootProject.projectDir, '../node_modules/react-native-ble-plx/android')
- In
MainApplication.getPackages
import and add BleModule package:
import com.polidea.reactnativeble.BlePackage;
...
public class MainApplication extends Application implements ReactApplication {
...
@Override
protected List<ReactPackage> getPackages() {
return Arrays.<ReactPackage>asList(
new MainReactPackage(),
new BlePackage()
);
}
- In
build.gradle
ofapp
module add following dependency:
dependencies {
...
compile project(':react-native-ble-plx')
...
- Additionaly make sure that min SDK version is at least 18:
android {
...
defaultConfig {
minSdkVersion 18
...
- 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_COARSE_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"/>
<uses-sdk
android:minSdkVersion="18"
...
Add this to your app/proguard-rules.pro
-dontwarn com.polidea.reactnativeble.**