STF项目中蓝牙权限兼容性问题分析与解决方案

背景介绍

在DeviceFarmer的STF（Smartphone Test Farm）项目中，近期引入的蓝牙功能更新导致了部分Android设备的兼容性问题。这个问题主要出现在较旧版本的Android设备上，特别是当系统尝试授予BLUETOOTH_CONNECT权限时，设备会抛出"Unknown permission"异常。

问题现象

开发团队在日志中发现了两类典型的错误情况：

1. HUAWEI HWANA设备（Android 10，SDK 29）：系统报错显示"java.lang.IllegalArgumentException: Unknown permission: android.permission.BLUETOOTH_CONNECT"，表明系统无法识别该权限。

2. HUAWEI P9设备（Android 6.0，SDK 23）：同样报出权限未知的错误，并输出了完整的pm命令帮助信息，说明系统完全不支持该权限。

技术分析

权限兼容性问题根源

BLUETOOTH_CONNECT是Android 12（API级别31）引入的新运行时权限。在此之前，蓝牙权限管理方式有所不同：

• Android 11及更早版本：使用BLUETOOTH和BLUETOOTH_ADMIN权限
• Android 12+：引入更细粒度的权限控制，包括BLUETOOTH_CONNECT、BLUETOOTH_SCAN等

影响范围

这个问题影响了：

1. 所有Android 11及以下版本的设备（API级别30及以下）
2. 部分定制ROM的设备，即使运行较新Android版本也可能存在问题

解决方案

版本兼容性处理

正确的做法是根据设备SDK级别动态调整权限请求：

if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.S) {
    // 只在Android 12+设备上请求BLUETOOTH_CONNECT权限
    requestPermissions(new String[]{Manifest.permission.BLUETOOTH_CONNECT}, REQUEST_CODE);
} else {
    // 旧版本使用传统蓝牙权限
    requestPermissions(new String[]{Manifest.permission.BLUETOOTH}, REQUEST_CODE);
}

STF项目中的具体实现

在STFService中，应该：

1. 检测设备SDK级别
2. 只对兼容设备授予新权限
3. 对旧设备保持原有权限配置
4. 记录详细的调试日志以帮助问题诊断

最佳实践建议

1. 兼容性测试：新功能开发时应覆盖不同Android版本测试
2. 渐进增强：新特性应在支持它的设备上启用，不影响基础功能
3. 明确支持范围：在项目文档中清晰定义支持的Android版本
4. 错误处理：对可能失败的权限请求要有完善的错误处理和回退机制

总结

在Android生态系统中，处理权限兼容性问题是一项常见挑战。通过合理的版本检测和条件逻辑，可以确保新功能在不兼容的设备上优雅降级，而不会影响核心功能。STF项目中的这个案例很好地展示了如何在保持向后兼容性的同时引入新特性。