Kable 0.36.0 版本更新解析：蓝牙开发库的重大改进

Kable 是一个跨平台的 Kotlin 蓝牙开发库，它简化了 Android 和 Apple 平台上的蓝牙低功耗(BLE)开发工作。最新发布的 0.36.0 版本带来了多项重要改进，包括更清晰的协程作用域管理、标准库 UUID 支持以及连接状态增强等特性。

协程作用域管理的改进

在 0.36.0 版本中，Kable 对协程作用域的管理进行了重要重构，使其更加明确和符合直觉。

Peripheral.scope 属性

原先的 Peripheral 类直接继承了 CoroutineScope，这意味着可以直接在 Peripheral 实例上调用 launch 方法。这种设计虽然方便，但不够明确。新版本将协程作用域移动到了 scope 属性中：

// 旧版本
peripheral.launch {
    // 协程代码
}

// 新版本
peripheral.scope.launch {
    // 协程代码
}

同样，取消协程的方式也发生了变化：

// 旧版本
peripheral.cancel()

// 新版本
peripheral.close()
// 或者
peripheral.scope.cancel()

这种改变使代码意图更加清晰，减少了潜在的混淆。

AutoCloseable 支持

Peripheral 现在实现了 AutoCloseable 接口，这使得资源管理更加方便，特别是在只需要短时间使用 Peripheral 的场景中：

peripheral.use { p ->
    p.connect()
    p.write(...)
    p.disconnect()
}

这种模式确保了即使在发生异常的情况下，资源也能被正确释放，减少了资源泄漏的风险。

连接状态增强

新版本对连接状态的处理也进行了改进，使得连接状态的协程作用域管理更加灵活。

连接作用域的可访问性

在之前的版本中，连接协程作用域只能通过 connect 方法的返回值获取。现在，Connected 状态本身也携带了这个作用域：

peripheral.state
    .filterIsInstance<State.Connected>()
    .onEach { (connectionScope) ->
        connectionScope.launch {
            // 这个协程会在断开连接时自动取消
        }
    }
    .launchIn(peripheral.scope)

这种改进使得在响应式编程模式下管理连接相关协程变得更加方便。

标准库 UUID 支持

Kable 现在使用 Kotlin 标准库提供的 UUID 实现，取代了之前使用的第三方库。这一变化带来了更好的兼容性和更简洁的 API。

UUID 使用示例

新版本提供了更简洁的方式来处理蓝牙标准 UUID：

// 使用蓝牙基础UUID构建服务UUID
val serviceUuid = Bluetooth.BaseUuid + 0xAA80

// 使用预定义的描述符UUID
val descriptorUuid = Uuid.descriptor("gatt.client_characteristic_configuration")

这种改进不仅减少了对外部库的依赖，还使得代码更加简洁和类型安全。

平台特定改进

Android 平台

• 简化了"客户端特征配置"描述符的 UUID 定义
• 改进了 GATT 状态异常处理，现在会暴露底层的 Android GATT 状态码

Apple 平台

• 增加了对 32 位(8 位十六进制字符) CBUUID 的支持

其他重要改进

• 允许仅通过公司 ID 进行广播数据过滤
• 将扫描失败的错误代码作为 IllegalStateException 传播
• 将 GATT 请求被拒绝的异常移动到公共模块
• 允许广播制造商数据长度超过过滤数据掩码长度
• 修复了观察者连接时的线程安全问题

总结

Kable 0.36.0 版本带来了多项重要改进，特别是在协程作用域管理、UUID 处理和连接状态管理方面。这些改进使得 API 更加清晰、类型更安全，同时也提高了跨平台一致性。对于现有项目，升级时需要注意协程作用域访问方式和 UUID 使用方式的变化。这些改进总体上使 Kable 更加强大和易用，为蓝牙低功耗开发提供了更好的支持。