4. 蓝牙低功耗扫描权限 BLUETOOTH_SCAN：Android 12+ 新增、声明与动态请求

4.1 原理

Android 12（API 31）将传统 BLUETOOTH 权限拆分为三个细粒度运行时权限，其中 BLUETOOTH_SCAN 专门用于执行蓝牙低功耗（BLE）扫描操作。该权限属于 dangerous 级别，因此不仅需要在清单中声明，还必须在运行时向用户动态请求。

在 Android 12 及更高版本上，如果仅声明旧版 BLUETOOTH 权限而不声明 BLUETOOTH_SCAN，系统将抛出 SecurityException。对于 Android 11 及以下设备，仍需保留 BLUETOOTH 和 BLUETOOTH_ADMIN 权限以保证兼容。

4.2 实现流程

4.3 声明与动态请求

4.3.1 清单声明

在 AndroidManifest.xml 中同时声明新权限与兼容性权限，确保覆盖所有设备版本：

<uses-permission android:name="android.permission.BLUETOOTH_SCAN" />
<uses-permission android:name="android.permission.BLUETOOTH_CONNECT" />
<uses-permission android:name="android.permission.BLUETOOTH" android:maxSdkVersion="30" />
<uses-permission android:name="android.permission.BLUETOOTH_ADMIN" android:maxSdkVersion="30" />
<!-- 如果扫描用于位置，还需声明位置权限 -->
<uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" android:maxSdkVersion="30" />

4.3.2 运行时动态请求（Kotlin）

使用 ActivityResultLauncher 请求权限，代码更加安全简洁：

class ScanActivity : AppCompatActivity() {
    private lateinit var scanLauncher: ActivityResultLauncher<String>
    private val requiredPermission = Manifest.permission.BLUETOOTH_SCAN

    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        scanLauncher = registerForActivityResult(
            ActivityResultContracts.RequestPermission()
        ) { granted ->
            if (granted) {
                startBleScan()
            } else {
                // 用户拒绝：展示说明或引导设置
                showPermissionDeniedDialog()
            }
        }
    }

    private fun checkAndRequestScanPermission() {
        if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.S) {
            when {
                ContextCompat.checkSelfPermission(this, requiredPermission)
                        == PackageManager.PERMISSION_GRANTED -> {
                    startBleScan()
                }
                shouldShowRequestPermissionRationale(requiredPermission) -> {
                    // 向用户解释为何需要此权限
                    showRationaleDialog()
                }
                else -> {
                    scanLauncher.launch(requiredPermission)
                }
            }
        } else {
            // 旧设备使用 BLUETOOTH + BLUETOOTH_ADMIN
            startBleScanLegacy()
        }
    }

    private fun startBleScan() {
        // 使用 BluetoothLeScanner 开始扫描
    }
}

4.4 调试

通过 adb 模拟授予或撤销权限，便于测试：

# 授予 BLUETOOTH_SCAN 权限
adb shell pm grant com.example.bleapp android.permission.BLUETOOTH_SCAN

# 撤销权限
adb shell pm revoke com.example.bleapp android.permission.BLUETOOTH_SCAN

# 查看应用已授予的权限列表
adb shell dumpsys package com.example.bleapp | grep "permission"

4.5 部署注意事项

• targetSdkVersion 必须为 31+ 才能使用新权限，但 minSdkVersion 可保持较低（如 21）。
• 在 Google Play 发布时，如果应用面向 12+ 设备但仅声明旧权限，可能被拒绝或运行时崩溃。
• 若 BLE 扫描用于获取位置，仍需请求 ACCESS_FINE_LOCATION（Android 11 及以下）或 ACCESS_FINE_LOCATION / ACCESS_COARSE_LOCATION（Android 12+ 可选）。

4.6 常见错误

4.7 性能与稳定性优化

• 权限请求时机：在即将开始扫描时请求，而非应用启动时，降低用户感知负担。
• 缓存授权状态：使用 SharedPreferences 记录此前是否被永久拒绝，避免重复弹出无意义的请求。
• 后台扫描限制：Android 12+ 对后台扫描有额外限制，应配合前台服务或高优先级扫描。权限只保证前台扫描合法。
• 线程安全：权限检查与回调始终在主线程执行，不要在其他线程调用 checkSelfPermission。