Swiftpack.co - Package - Polidea/RxBluetoothKit

RxBluetoothKit Swift

CI Status Platform Carthage Compatible

RxBluetoothKit is a Bluetooth library that makes interaction with BLE devices much more pleasant. It's backed by RxSwift and CoreBluetooth and it provides nice API, for both Central and Peripheral modes. All to work with and make your code more readable, reliable and easier to maintain.

Here is a sneak peek of what you can do with RxBluetoothKit:

manager.scanForPeripherals(withServices: [serviceId])
    .take(1)
    .flatMap { $0.peripheral.establishConnection() }
    .flatMap { $0.discoverServices([serviceId]) }
    .flatMap { Observable.from($0) }
    .flatMap { $0.discoverCharacteristics([characteristicId]) }
    .flatMap { Observable.from($0) }
    .flatMap { $0.readValue() }
    .subscribe(onNext: { print("Value: \($0.value)") })

With just 9 lines it started scanning, connecting to the peripheral, discovering service and characteristics and read charecteristic's value!

Central mode features

Peripheral mode features

  • Observing manager states
  • Advertising
  • Observing read & writes
  • Observing subscribe
  • Publishing L2CAP channels
  • And a lot more!

Recent Changes

5.1.2

  • Updated RxSwift to 4.2 with support for XCode 9.4 (#268)

All previous changes

Want to migrate from 4.x to 5.x? Check guidelines here.

Installation

CocoaPods

CocoaPods is a dependency manager for CocoaProjects. To integrate RxBluetoothKit into your Xcode project using CocoaPods specify it in your Podfile:

pod 'RxBluetoothKit'

Then, run the following command: $ pod install

Carthage

Carthage is a decentralized dependency manager that builds your dependencies and provides you with binary frameworks. To integrate RxBluetoothKit into your Xcode project using Carthage specify it in your Cartfile:

github "Polidea/RxBluetoothKit"

Then, run carthage update to build framework and drag RxBluetoothKit.framework into your Xcode project.

Swift Package Manager

Versions >= 4.0 of the library integrate with the Swift Package Manager. In order to do that please specify our project as one of your dependencies in Package.swift file.

Getting Started

Check our Wiki with guidelines to (almost) all library functionalites.

Documentation & Support

Remember to follow Polidea's Blog blog to get all the news and updates!

Requirements

  • iOS 8.0+
  • OSX 10.10+
  • watchOS 4.0+
  • tvOS 11.0+
  • Xcode 7.3+

Swift versions

  • 3.0 version supports Swift 3.0 and 3.1
  • 5.0 version supports Swift 3.2 and 4.0
  • 5.1.2 version supports Swift 4.1

Github

link
Stars: 832
Help us keep the lights on

Dependencies

Used By

Total:

Releases

5.1.3 - Jun 29, 2018

  • Changed back deployment target from 10.0 to 8.0. (#275)

5.1.2 - Jun 21, 2018

  • Updated RxSwift to 4.2 with support for XCode 9.4 (#268)

4.0.3 - Jun 11, 2018

Update Cartfile.resolved and generate binary framework for XCode 9.4.

5.1.1 - Jun 8, 2018

  • Fixed PeripheralManager not public (#264)

5.1.0 - May 28, 2018

  • Added support for CBPeripheralManager. Read PeripheralManager documentation for more info (#166)
  • Deprecated RestoredState and CentralManager.init(queue:options:onWillRestoreCentralManagerState:). From now on please use corresponding CentralManagerRestoredState and CentralManager.init(queue:options:onWillRestoreCentralManagerState:)