首页
/ Kable 0.37.0版本发布:蓝牙开发库的重要更新

Kable 0.37.0版本发布:蓝牙开发库的重要更新

2025-07-08 12:52:19作者:劳婵绚Shirley

项目简介

Kable是一个跨平台的蓝牙开发库,支持Android、iOS、JavaScript等多个平台,为开发者提供了简洁易用的API来处理蓝牙设备的连接、通信等操作。它采用Kotlin Multiplatform技术构建,能够帮助开发者用统一的代码基础实现多平台的蓝牙功能。

权限管理变更

本次0.37.0版本最重要的变化是权限管理方式的调整。在此之前,Kable库会自动声明所需的Android权限,而现在这一责任转移给了库的使用者。开发者需要自行配置应用所需的蓝牙相关权限。

为了保持向后兼容性,项目提供了一个新的kable-default-permissions模块,包含了之前默认声明的权限。开发者可以选择引入这个模块来保持原有行为,或者根据应用实际需求自定义权限配置。

主要功能更新

扫描过滤增强

新版本增加了通过服务数据(service data)进行蓝牙设备扫描过滤的支持。这使得开发者能够更精确地定位目标设备,特别是在存在多个相似设备的场景下,提高了扫描效率和准确性。

JavaScript平台改进

JavaScript平台现在支持通过设备标识符(Identifier)直接创建Peripheral对象。这一改进简化了已知设备的连接流程,开发者无需再进行完整的扫描过程即可与特定设备建立连接。

API清理

0.37.0版本对已弃用的API进行了升级处理,这表明项目团队正在推进API的现代化进程,建议开发者检查自己的代码并迁移到最新的API。

平台特定更新

Android平台

除了前面提到的权限管理变更外,Android平台现在通过独立的kable-default-permissions模块提供默认权限配置。这种模块化设计给予了开发者更大的灵活性,可以根据应用的实际需求选择最合适的权限配置方案。

技术维护更新

项目团队持续进行依赖库的版本更新,包括:

  • Kotlin Wrappers BOM更新至2025.3.20版本
  • Kotlin Multiplatform更新至2.1.20版本
  • EqualsVerifier测试工具更新至3.19.2版本

这些更新确保了项目能够利用最新的语言特性和工具支持,同时保持依赖组件的安全性和稳定性。

升级建议

对于正在使用Kable的开发者,升级到0.37.0版本时需要注意:

  1. 检查并处理Android权限配置,可以选择引入kable-default-permissions模块或自定义权限
  2. 评估是否可以利用新的服务数据过滤功能优化设备扫描逻辑
  3. 检查并替换任何已弃用的API调用
  4. JavaScript平台开发者可以考虑使用新的Peripheral创建方式简化代码

这个版本体现了Kable项目在保持核心功能稳定的同时,不断优化开发者体验和API设计的努力。权限管理的变更虽然带来了一定的适配工作,但长期来看提供了更大的灵活性和控制权。

登录后查看全文
热门项目推荐