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!

---

---

Recent Changes

0.4.0

• Device ID properties were renamed as they are not UUIDs on Android (breaking change):
  • Device.uuid -> Device.id
  • Service.deviceUUID -> Service.deviceID,
  • Characteristic.deviceUUID -> Characteristic.deviceID
• Changed signature of onDeviceDisconnected, as Device object is always available.
• Updated to Swift 3.0
• Updated to RxAndroidBle 1.1.0 and RxBluetoothKit 3.0.6
• Documentation was moved to ./doc folder and now is generated by ESDoc.
• Fixed state() invalid return type. Implemented state() and onStateChange() for Android.
• Added optional parameter to onStateChange() function.
• Fixed monitorCharacteristicForDevice() for Android when characteristic accepts indications only.
• Updated AndroidManifest.xml configuration.

Documentation

Documentation can be found here.

Configuration & Installation

Automatically

npm install --save react-native-ble-plx
react-native link

Both on iOS and Android continue manually from step 7.

Manually

iOS

1. Add react-native-ble-plx to a project as a dependency in package.json file. For example "react-native-ble-plx": "Polidea/react-native-ble-plx" will install latest version from Polidea's Github repository.
2. Make sure that you have Carthage installed on your system.
3. Execute npm install to fetch and install a library.
4. Open iOS project located in ./ios folder.
5. Move BleClient.xcodeproj located in .node_modules/react-native-ble-plx/ios using drag & drop to Libraries folder in your project.
6. In general settings of a target add libBleClient.a to Linked Frameworks and Libraries.
7. In Build Settings/Search Paths/Framework search paths add path: $(SRCROOT)/../node_modules/react-native-ble-plx/ios/BleClientManager/Carthage/Build/iOS.
8. In Build Settings/Build Options/Always Embed Swift Standard Libraries set to Yes.
9. In Build Phases click on top left button and add New 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

10. Minimal supported version of iOS is 8.0

Android

1. Add react-native-ble-plx to a project as a dependency in package.json file. For example "react-native-ble-plx": "Polidea/react-native-ble-plx" will install latest version from Polidea's Github repository.
2. Execute npm install to fetch and install a library.
3. Open Android project located in ./android folder.
4. 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')

5. 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()
      );
}

6. In build.gradle of app module add following dependency:

dependencies {
   ...
   compile project(':react-native-ble-plx')
   ...

7. Additionaly make sure that min SDK version is at least 18:

android {
    ...
    defaultConfig {
        minSdkVersion 18
        ...

8. 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"
        ...