3. 蓝牙权限申请与运行时处理

3.1 原理：Android 6~14 蓝牙权限演进

Android 的蓝牙权限模型经历了三次重大变更。Android 6.0 引入运行时权限，蓝牙相关权限从安装时授权变为运行时动态申请；Android 10 增加后台位置限制；Android 12 将传统蓝牙权限拆分为细粒度权限，彻底剥离位置依赖。下表汇总各版本核心差异：

3.2 实现流程

蓝牙权限申请的核心步骤可概括为“检查 SDK → 检测权限 → 动态请求 → 处理结果”。下图展示完整决策路径：

3.3 代码实现

3.3.1 AndroidManifest 声明（兼容写法）

<!-- Android 12+ 新增权限 -->
<uses-permission android:name="android.permission.BLUETOOTH_SCAN" />
<uses-permission android:name="android.permission.BLUETOOTH_CONNECT" />
<uses-permission android:name="android.permission.BLUETOOTH_ADVERTISE" />

<!-- 旧版本位置权限（Android 6–11） -->
<uses-permission android:name="android.permission.ACCESS_FINE_LOCATION"
    android:maxSdkVersion="30" />
<uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION"
    android:maxSdkVersion="30" />

<!-- 基本蓝牙权限（始终需要） -->
<uses-permission android:name="android.permission.BLUETOOTH"
    android:maxSdkVersion="31" />
<uses-permission android:name="android.permission.BLUETOOTH_ADMIN"
    android:maxSdkVersion="31" />

maxSdkVersion 确保低版本清单中不包含 Android 12+ 专用权限，同时高版本清单不声明已废弃的旧权限。

3.3.2 运行时权限请求（Kotlin 兼容函数）

private fun requestBluetoothPermissions() {
    val permissionsToRequest = mutableListOf<String>()
    if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.S) {
        // Android 12+
        if (checkSelfPermission(BLUETOOTH_SCAN) != PERMISSION_GRANTED)
            permissionsToRequest.add(BLUETOOTH_SCAN)
        if (checkSelfPermission(BLUETOOTH_CONNECT) != PERMISSION_GRANTED)
            permissionsToRequest.add(BLUETOOTH_CONNECT)
    } else {
        // Android 6–11
        if (checkSelfPermission(ACCESS_FINE_LOCATION) != PERMISSION_GRANTED)
            permissionsToRequest.add(ACCESS_FINE_LOCATION)
    }
    if (permissionsToRequest.isNotEmpty()) {
        requestPermissions(
            permissionsToRequest.toTypedArray(),
            REQUEST_CODE_BLUETOOTH_PERMISSIONS
        )
    } else {
        onBluetoothPermissionsGranted()
    }
}

override fun onRequestPermissionsResult(
    requestCode: Int,
    permissions: Array<out String>,
    grantResults: IntArray
) {
    super.onRequestPermissionsResult(requestCode, permissions, grantResults)
    if (requestCode == REQUEST_CODE_BLUETOOTH_PERMISSIONS) {
        val allGranted = grantResults.all { it == PERMISSION_GRANTED }
        if (allGranted) {
            onBluetoothPermissionsGranted()
        } else {
            // 检查是否勾选"不再询问"
            val shouldShowRationale = permissions.any {
                shouldShowRequestPermissionRationale(it)
            }
            if (!shouldShowRationale) {
                // 永久拒绝，引导用户去设置
                showPermissionSettingsDialog()
            } else {
                showPermissionRationale()
            }
        }
    }
}

3.4 调试与验证

测试权限场景时，推荐使用以下 adb 命令模拟不同状态：

# 授予所有蓝牙权限
adb shell pm grant 包名 android.permission.BLUETOOTH_SCAN
adb shell pm grant 包名 android.permission.BLUETOOTH_CONNECT
adb shell pm grant 包名 android.permission.ACCESS_FINE_LOCATION

# 撤销特定权限
adb shell pm revoke 包名 android.permission.BLUETOOTH_SCAN

# 重置所有运行时权限（恢复初始状态）
adb shell pm reset-permissions 包名

# 在 Android 12+ 上查看权限授予情况
adb shell dumpsys package 包名 | grep -E "BLUETOOTH|Location"

3.5 常见错误与解决方案

3.6 性能与稳定性优化建议

• 缓存权限状态： 在应用启动时一次性检查所有蓝牙权限，将结果存入内存变量，避免每次操作都触发系统调用。
• 减少弹窗次数： 将多个权限合并到一次 requestPermissions 请求中，避免用户多次拒绝后进入“不再询问”状态。
• 优雅处理“不再询问”： 检测到用户永久拒绝后，弹出对话框提供“前往设置”按钮（Intent(Settings.ACTION_APPLICATION_DETAILS_SETTINGS)），并引导用户手动开启。
• 版本隔离： 使用 @RequiresApi 注解或 if (Build.VERSION.SDK_INT >= 31) 包裹新版权限调用，确保在低版本设备上不出现编译或运行时错误。
• 权限回收检测： 当 Activity/Fragment 进入 onResume 时重新检查权限是否被用户后台撤销，若被撤销则暂停蓝牙操作并提示。