WLXBluetoothDevice 是我们在 Wolox 为几个 Bluetooth 4.0 相关项目工作后开发的一个库。对于那些之前使用过 CoreBluetooth 的开发者来说，他们可能会知道这个 API 使用起来并不愉快。CoreBluetooth API 过度依赖于责任过重的代理，其异步性质使得代码变得非常混乱。

WLXBluetoothDevice 是基于 CoreBluetooth 的块级封装库，为您处理大部分繁琐的部分。它的设计目标是：

• 避免需要在多个代理方法中处理复杂的异步逻辑。
• 减少在两个设备之间开始交换数据所需的仪式。
• 内部处理所有 CBCentralManagerDelegate 和 CBPeripheralDelegate 方法，并向用户公开基于块的 API。
• 实现大部分 BLE 应用程序中常用的使用情况和模式。
• 提供清晰的架构，以便在上层构建可维护的代码。
• 简化蓝牙代码的自动化测试。

以下是在 WLXBluetoothDevice 中包含的一些最相关的特性：

• 连接超时
• 重连策略
• 基于块的 API
• 自动特性发现
• 蓝牙连接和发现事件的 NSNotifications。
• 存储服务以记住设备。

依赖关系

我们希望尽量减少对外部依赖的使用，并承诺除非该库解决了巨大的问题，否则不会包含任何其他外部库。WLXBluetoothDevice 的唯一依赖库是 CocoaLumberjack，因为它是一个优秀的库，并建议您使用它。另外，如果需要调试 Bluetooth 连接的情况，可以打开我们的日志记录器，您将获得有关库正在执行哪些操作的大量信息。

未来版本

我们希望 0.1.0 版本是最核心的功能集，然后在此基础上构建更多酷炫的功能。我们计划添加一个 ReactiveCocoa API 作为单独的子规范，因此对于那些喜欢反应式函数式编程的开发者，将有一个基于信号的 API。

一旦 CocoaPods 支持 Swift，我们将将其添加为一级公民，公开一个在 Swift 中感觉更自然化的 API。

使用方法

要运行示例项目，请先克隆仓库，然后从Example目录中运行pod install。要实际使用示例应用程序，您需要一个以特定方式公开某些特性的蓝牙外围设备。这就是我们制作了一个测试iOS应用，使其按照示例项目期望的方式充当外围设备的原因。您可以从此处克隆测试应用程序。

安装

在安装了pods之后，您可以添加以下头文件到您的prefix文件中

#import <WLXBluetoothDevice/WLXBluetoothDevice.h>

文档

您可以在库的wiki中查看文档和使用不同API的示例。如果在wiki中缺少某些内容，您可以添加。

关于

本项目由Guido Marucci Blas维护，并由Wolox编写。

许可证

WLXBluetoothDevice可在MIT许可证下使用。

Copyright (c) 2014 Guido Marucci Blas <[email protected]>

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in
all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
THE SOFTWARE.