Home Assistant Android应用蓝牙扫描崩溃问题分析

Home Assistant Android应用蓝牙扫描崩溃问题分析

【免费下载链接】android :iphone: Home Assistant Companion for Android 项目地址: https://gitcode.com/gh_mirrors/android5/android

痛点场景：蓝牙扫描为何频繁崩溃？

你是否遇到过这样的场景：在使用Home Assistant Android应用进行蓝牙设备扫描时，应用突然崩溃退出，或者出现权限错误提示？这可能是Android系统蓝牙权限管理和API调用不当导致的常见问题。本文将深入分析蓝牙扫描崩溃的根本原因，并提供完整的解决方案。

崩溃根源：权限缺失与API版本适配

1. Android蓝牙权限体系演变

2. 主要崩溃原因分析

根据代码分析，蓝牙扫描崩溃主要源于以下几个方面：

权限检查缺失

// 错误示例：缺少权限检查直接调用蓝牙API
fun getBluetoothDevices(context: Context): List<BluetoothDevice> {
    val bluetoothManager = context.getSystemService<BluetoothManager>()!!
    val adapter = bluetoothManager.adapter // 可能在此处崩溃
    // ...
}

运行时权限未处理

// 需要处理的运行时权限
val requiredPermissions = if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.S) {
    arrayOf(
        Manifest.permission.BLUETOOTH_SCAN,
        Manifest.permission.BLUETOOTH_CONNECT
    )
} else {
    arrayOf(
        Manifest.permission.BLUETOOTH,
        Manifest.permission.ACCESS_FINE_LOCATION
    )
}

解决方案：完整的权限管理策略

1. 权限检查与请求流程

2. 安全的蓝牙工具类实现

object BluetoothUtils {
    @SuppressLint("MissingPermission")
    fun getBluetoothDevices(context: Context): List<BluetoothDevice> {
        // 首先检查权限
        if (!hasBluetoothPermissions(context)) {
            throw SecurityException("缺少蓝牙权限")
        }
        
        val devices = mutableListOf<BluetoothDevice>()
        val bluetoothManager = context.getSystemService<BluetoothManager>()
        
        bluetoothManager?.adapter?.let { adapter ->
            if (adapter.isEnabled) {
                try {
                    // 获取已配对设备
                    val bondedDevices = adapter.bondedDevices
                    bondedDevices.forEach { device ->
                        devices.add(BluetoothDevice(
                            device.address,
                            device.name ?: device.address,
                            device.bondState == BluetoothDevice.BOND_BONDED,
                            isConnected(device)
                        ))
                    }
                    
                    // 获取已连接设备（需要BLUETOOTH_CONNECT权限）
                    if (hasConnectPermission(context)) {
                        val connectedDevices = bluetoothManager.getConnectedDevices(BluetoothProfile.GATT)
                        connectedDevices.forEach { device ->
                            if (devices.none { it.address == device.address }) {
                                devices.add(BluetoothDevice(
                                    device.address,
                                    device.name ?: device.address,
                                    device.bondState == BluetoothDevice.BOND_BONDED,
                                    isConnected(device)
                                ))
                            }
                        }
                    }
                } catch (e: SecurityException) {
                    Timber.e(e, "蓝牙权限异常")
                    // 处理权限异常，避免应用崩溃
                }
            }
        }
        return devices
    }
    
    private fun hasBluetoothPermissions(context: Context): Boolean {
        return if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.S) {
            ContextCompat.checkSelfPermission(context, Manifest.permission.BLUETOOTH_SCAN) == PackageManager.PERMISSION_GRANTED &&
            ContextCompat.checkSelfPermission(context, Manifest.permission.BLUETOOTH_CONNECT) == PackageManager.PERMISSION_GRANTED
        } else {
            ContextCompat.checkSelfPermission(context, Manifest.permission.BLUETOOTH) == PackageManager.PERMISSION_GRANTED &&
            ContextCompat.checkSelfPermission(context, Manifest.permission.ACCESS_FINE_LOCATION) == PackageManager.PERMISSION_GRANTED
        }
    }
}

3. 异常处理与用户提示

// 在MessagingManager中处理蓝牙命令
when (message) {
    COMMAND_BLUETOOTH -> {
        if (!jsonData[NotificationData.COMMAND].isNullOrEmpty() &&
            jsonData[NotificationData.COMMAND] in DeviceCommandData.ENABLE_COMMANDS) {
            
            // 检查权限
            if (ContextCompat.checkSelfPermission(context, Manifest.permission.BLUETOOTH_CONNECT) != PackageManager.PERMISSION_GRANTED) {
                // 通知用户缺少权限
                notifyMissingPermission("BLUETOOTH_CONNECT", serverId)
            } else {
                handleDeviceCommands(jsonData)
            }
        } else {
            Timber.d("无效的蓝牙命令")
            sendNotification(jsonData)
        }
    }
}

实践指南：避免蓝牙扫描崩溃的最佳实践

1. 权限请求策略表

Android版本	所需权限	运行时请求	注意事项
Android 5.0-5.1	BLUETOOTH	否	仅需声明权限
Android 6.0-11	BLUETOOTH, ACCESS_FINE_LOCATION	是	需要位置权限用于扫描
Android 12+	BLUETOOTH_SCAN, BLUETOOTH_CONNECT	是	新的权限模型

2. 代码安全检测清单

•  在所有蓝牙API调用前添加权限检查
•  处理SecurityException异常
•  适配不同Android版本的权限要求
•  提供友好的用户权限提示
•  在manifest中正确声明所有需要的权限

3. 调试与日志记录

// 添加详细的日志记录
fun getBluetoothDevices(context: Context): List<BluetoothDevice> {
    Timber.d("开始获取蓝牙设备，SDK版本: ${Build.VERSION.SDK_INT}")
    
    if (!hasBluetoothPermissions(context)) {
        Timber.w("缺少蓝牙权限，无法获取设备列表")
        return emptyList()
    }
    
    // ... 设备获取逻辑
}

总结与展望

蓝牙扫描崩溃问题本质上是Android权限体系演进过程中的兼容性问题。通过：

1. 全面权限检查：在每次蓝牙操作前验证权限状态
2. 版本适配：针对不同Android版本使用正确的权限组合
3. 异常处理：妥善处理权限异常，避免应用崩溃
4. 用户引导：提供清晰的权限请求和错误提示

遵循这些最佳实践，可以显著减少Home Assistant Android应用的蓝牙相关崩溃，提升用户体验和应用稳定性。

未来随着Android系统的持续更新，建议持续关注蓝牙权限相关的API变化，及时调整权限管理策略，确保应用的长期兼容性和稳定性。

【免费下载链接】android :iphone: Home Assistant Companion for Android 项目地址: https://gitcode.com/gh_mirrors/android5/android