react-native-ble-plx

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.6.0

• Added basic API to support background mode. When BleManager is constructed you can pass restoreStateIdentifier and restoreStateFunction to BleManagerOptions object to enable support for background mode. More info about usage can be found in documentation.
• All subscriptions and promises are properly "Destroyed" when destory() function is called.
• Fixed bug on Android where notification messages could be duplicated or skipped.
• Updated RxAndroidBle to version 1.3
• Updated README file.
• Updated library logo

All previous changes

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

• 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.
• 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 to Libraries 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 to Yes.
• 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

• Minimal supported version of iOS is 8.0
• If you want to support background mode:
  • In your application target go to Capabilities tab and enable Uses Bluetooth LE Accessories in Background Modes section.
  • Pass restoreStateIdentifier and restoreStateFunction to BleManager constructor.

Android

• 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.
• 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 of app 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"
        ...