Android Beacon Library 2.21版本中长扫描强制启用设置问题解析

背景介绍

在Android Beacon Library 2.21.0-beta2版本中，开发团队引入了一个新的Settings API，旨在提供更灵活的方式来配置库的行为。这个新API设计用来替代传统的AndroidManifest.xml配置方式，使开发者能够以编程方式动态调整库的设置。

问题描述

新API中有一个关键功能是控制"长扫描强制启用"(longScanForcingEnabled)的设置。这个设置对于需要持续扫描蓝牙信标的应用程序非常重要，特别是在Android 7.1及以上版本的设备上。当启用此设置时，可以防止系统在30分钟后自动停止扫描。

然而，在2.21.0-beta2版本中，开发者发现通过新API设置longScanForcingEnabled属性并没有实际生效。这意味着开发者仍然需要依赖旧的AndroidManifest.xml配置方式，这显然违背了新API的设计初衷。

技术细节

longScanForcingEnabled设置主要用于解决Android系统的一个限制：在Android 7.1及以上版本中，系统会在30分钟后自动停止后台扫描以节省电量。对于需要长时间运行的信标扫描应用来说，这是一个严重的问题。

正确的配置方式应该是：

val settings = Settings(
    longScanForcingEnabled = true
)
beaconManager.replaceSettings(settings)

但在受影响版本中，这种配置方式无法正常工作。类似的问题也出现在RSSI过滤器实现类(settings.getRssiFilterImplClass)的设置上。

解决方案

开发团队在后续的2.21.0-beta5版本中修复了这个问题。修复后，开发者可以完全通过新的Settings API来配置这些参数，不再需要依赖AndroidManifest.xml。

最佳实践

对于需要使用长时间扫描功能的开发者，建议：

1. 确保使用2.21.0-beta5或更高版本
2. 在应用初始化时通过代码配置Settings
3. 不再需要在AndroidManifest.xml中添加相关配置
4. 对于关键功能，仍然应该测试配置是否生效

总结

这个问题的修复标志着Android Beacon Library向更现代化的配置方式迈出了重要一步。通过完全支持编程式配置，开发者现在可以更灵活地管理库的行为，特别是在需要动态调整扫描参数的场景下。这也为未来可能引入的更多运行时配置选项奠定了基础。