Android 蓝牙开发权限适配指南从 API 23 到 Android 14 的 5 个关键变更点在 Android 生态系统中蓝牙权限管理经历了多次重大变革。从 API 23Android 6.0引入运行时权限模型到 Android 14 进一步收紧权限控制开发者需要持续跟进这些变化才能确保应用兼容性。本文将系统梳理这 8 年间 5 个最具颠覆性的权限变更节点并提供面向未来的适配策略。1. Android 6.0API 23运行时权限与定位关联背景Android 6.0 引入的运行时权限模型彻底改变了应用获取敏感权限的方式。对于蓝牙开发而言最关键的改变是蓝牙扫描被认定为可能泄露用户位置信息的行为。关键变更新增ACCESS_FINE_LOCATION权限要求动态权限请求流程强制化扫描结果精度与定位权限挂钩适配方案// 检查并请求定位权限 if (ContextCompat.checkSelfPermission( this, Manifest.permission.ACCESS_FINE_LOCATION ) ! PackageManager.PERMISSION_GRANTED) { ActivityCompat.requestPermissions( this, arrayOf(Manifest.permission.ACCESS_FINE_LOCATION), REQUEST_CODE_LOCATION_PERMISSION ) } // 处理权限请求结果 override fun onRequestPermissionsResult( requestCode: Int, permissions: Arrayout String, grantResults: IntArray ) { when (requestCode) { REQUEST_CODE_LOCATION_PERMISSION - { if (grantResults.isNotEmpty() grantResults[0] PackageManager.PERMISSION_GRANTED) { startBluetoothScan() } } } }注意事项需要同时在 Manifest 声明权限用户拒绝后需提供引导说明定位服务开启状态影响扫描效果2. Android 10API 29后台定位权限分离背景Android 10 对定位权限进行细化拆分防止应用在后台滥用位置信息。关键变更新增ACCESS_BACKGROUND_LOCATION权限前台/后台定位权限分离管理蓝牙扫描行为受应用可见性影响适配策略对比场景所需权限用户提示频率前台扫描ACCESS_FINE_LOCATION每次拒绝后后台持续扫描ACCESS_FINE_LOCATION ACCESS_BACKGROUND_LOCATION特殊权限弹窗代码示例!-- AndroidManifest.xml -- uses-permission android:nameandroid.permission.ACCESS_FINE_LOCATION / uses-permission android:nameandroid.permission.ACCESS_BACKGROUND_LOCATION tools:ignoreProtectedPermissions /提示后台定位权限属于危险权限中的特殊类别需要额外在 Play Console 提交使用说明。3. Android 12API 31蓝牙权限三重分裂背景Android 12 对蓝牙权限体系进行了彻底重构引入更细粒度的控制维度。关键变更传统蓝牙权限废弃maxSdkVersion30新增三大场景化权限BLUETOOTH_SCAN设备发现BLUETOOTH_CONNECT设备连接BLUETOOTH_ADVERTISE广播服务权限矩阵功能所需权限备注扫描设备BLUETOOTH_SCAN可声明 neverForLocation连接设备BLUETOOTH_CONNECT包含配对功能作为外设广播BLUETOOTH_ADVERTISE需配合服务声明兼容性处理fun checkBluetoothPermissions(): Boolean { return if (Build.VERSION.SDK_INT Build.VERSION_CODES.S) { ContextCompat.checkSelfPermission( this, Manifest.permission.BLUETOOTH_SCAN ) PackageManager.PERMISSION_GRANTED ContextCompat.checkSelfPermission( this, Manifest.permission.BLUETOOTH_CONNECT ) PackageManager.PERMISSION_GRANTED } else { ContextCompat.checkSelfPermission( this, Manifest.permission.ACCESS_FINE_LOCATION ) PackageManager.PERMISSION_GRANTED } }4. Android 13API 33附近设备权限强化背景Google 进一步收紧对设备附近敏感信息的访问控制。关键变更引入NEARBY_DEVICES权限组蓝牙扫描默认不返回 MAC 地址需要声明新权限才能获取完整设备信息适配要点在 Manifest 添加uses-permission android:nameandroid.permission.BLUETOOTH_SCAN / uses-permission android:nameandroid.permission.NEARBY_DEVICES /处理新的设备标识符获取方式val deviceId if (Build.VERSION.SDK_INT Build.VERSION_CODES.TIRAMISU) { device.anonymizedAddress ?: unknown } else { device.address }5. Android 14API 34权限审核与用户控制背景Android 14 引入更严格的权限使用审查机制。关键变更新增 部分限制 权限状态用户可单独禁用特定蓝牙功能后台行为限制更加严格最佳实践实现OnPermissionsChangedListener监听权限变化提供优雅降级方案增加权限状态检查点fun checkPartialRestrictions() { val unused if (Build.VERSION.SDK_INT Build.VERSION_CODES.UPSIDE_DOWN_CAKE) { val restrictions packageManager.getUnusedAppRestrictions(this) if (restrictions.isNotEmpty()) { // 处理部分功能被限制的情况 } } }权限适配决策流程图graph TD A[开始] -- B{API Level?} B --|≤22| C[仅需声明权限] B --|23-28| D[请求运行时定位权限] B --|29-30| E[增加后台定位检查] B --|≥31| F[使用新蓝牙权限组] F -- G{需要物理位置?} G --|是| H[声明定位权限] G --|否| I[添加neverForLocation标志] H -- J[处理精确定位开关] I -- K[仅使用蓝牙权限] J -- L[完整功能] K -- M[受限功能模式]面向未来的适配建议分层权限处理构建兼容各API级别的权限检查模块动态功能降级根据实际获取的权限调整功能集用户引导系统设计渐进式权限获取引导流程持续测试矩阵覆盖从API 23到最新版本的真机测试示例模块设计class BluetoothPermissionManager( private val context: Context ) { private val requiredPermissions: ArrayString get() if (Build.VERSION.SDK_INT Build.VERSION_CODES.S) { arrayOf( Manifest.permission.BLUETOOTH_SCAN, Manifest.permission.BLUETOOTH_CONNECT ) } else { arrayOf(Manifest.permission.ACCESS_FINE_LOCATION) } fun checkAllGranted(): Boolean { return requiredPermissions.all { permission - ContextCompat.checkSelfPermission( context, permission ) PackageManager.PERMISSION_GRANTED } } fun requestPermissions(activity: Activity, requestCode: Int) { ActivityCompat.requestPermissions( activity, requiredPermissions, requestCode ) } }在适配过程中建议采用特性检测而非版本检测的原则。例如检查权限可用性而不是简单判断SDK版本这能为未来版本变化提供更好的兼容性保障。