不同版本的 Android 系统申请蓝牙权限

已于 2025-07-10 12:04:48 修改
阅读量946 收藏 1
点赞数 3
CC 4.0 BY-SA版权
文章标签： android ble
于 2025-04-17 14:09:37 首次发布
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.youkuaiyun.com/zhijiandedaima/article/details/147305037

概述：

动态获取权限说明:

  • 1.Android 6 至 Android 11 需要动态获取 ACCESS_FINE_LOCATION 和 ACCESS_COARSE_LOCATION 权限；
  • 2.Android 10 至 Android 11 蓝牙扫描需要开启 定位开关；
  • 3.Android 12 及以上 需要动态获取 BLUETOOTH_CONNECT 和BLUETOOTH_SCAN 权限；
   <!-- 基础蓝牙权限 -->
    <uses-permission android:name="android.permission.BLUETOOTH" />
    <uses-permission android:name="android.permission.BLUETOOTH_ADMIN" />

    <!-- 位置权限（Android 6.0+ 需要） -->
    <uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />
    <uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION" />

    <!-- Android 11+ 新增的蓝牙扫描权限 -->
    <uses-permission android:name="android.permission.BLUETOOTH_SCAN" />

    <!-- Android 12+ 需要的蓝牙连接权限 -->
    <uses-permission android:name="android.permission.BLUETOOTH_CONNECT" />

    <!-- 如果需要访问蓝牙设备信息 -->
    <uses-permission android:name="android.permission.BLUETOOTH_ADVERTISE" />

    <!-- 如果需要前台服务（适用于后台扫描） -->
    <uses-permission android:name="android.permission.FOREGROUND_SERVICE" />

1. Android 6.0（API 级别 23）以下

在 Android 6.0 之前，权限在应用安装时就会被授予，不需要在运行时请求权限。只需要在 AndroidManifest.xml 中声明所需的蓝牙权限即可。

   <!-- 蓝牙权限 -->
    <uses-permission android:name="android.permission.BLUETOOTH" />
    <uses-permission android:name="android.permission.BLUETOOTH_ADMIN" />

2. Android 6.0（API 级别 23）到 Android 11（API 级别 30）

从 Android 6.0 开始，引入了运行时权限机制，部分危险权限需要在运行时请求。对于蓝牙功能，除了声明蓝牙权限外，还需要请求位置权限，因为蓝牙扫描可能会泄露用户的位置信息。

   <!-- 位置权限 -->
   <!--    <uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />-->
   <!--    <uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION" />-->
   <uses-permission-sdk-23 android:name="android.permission.ACCESS_FINE_LOCATION" />
   <uses-permission-sdk-23 android:name="android.permission.ACCESS_COARSE_LOCATION" />

    <!-- 蓝牙权限 -->
    <uses-permission android:name="android.permission.BLUETOOTH" />
    <uses-permission android:name="android.permission.BLUETOOTH_ADMIN" />

3. Android 12（API 级别 31）及以上

从 Android 12 开始，引入了新的蓝牙权限 BLUETOOTH_CONNECT 和 BLUETOOTH_SCAN，分别用于连接蓝牙设备和扫描蓝牙设备。

  <!-- 位置权限 -->
  <!--    <uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />-->
  <!--    <uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION" />-->
  <uses-permission-sdk-23 android:name="android.permission.ACCESS_FINE_LOCATION" />
  <uses-permission-sdk-23 android:name="android.permission.ACCESS_COARSE_LOCATION" />

    <!-- 新的蓝牙权限 -->
    <uses-permission android:name="android.permission.BLUETOOTH_CONNECT" />
    <uses-permission android:name="android.permission.BLUETOOTH_SCAN" />

    <!-- 旧的蓝牙权限 -->
    <uses-permission android:name="android.permission.BLUETOOTH" />
    <uses-permission android:name="android.permission.BLUETOOTH_ADMIN" />

权限集合 组装代码

  val permissionList = mutableListOf<String>()
  if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.M) {// Android 6.0到Android 11
      permissionList.add(Manifest.permission.ACCESS_FINE_LOCATION)// 精确位置
      permissionList.add(Manifest.permission.ACCESS_COARSE_LOCATION)// 粗略位置
  }
  if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.S) { // Android 12及以上
      permissionList.add(Manifest.permission.BLUETOOTH_CONNECT)
      permissionList.add(Manifest.permission.BLUETOOTH_SCAN)
  }
  LogUtils.d("权限列表：$permissionList")
        
  PermissionX.init(this)
      .permissions(permissionList)
       .onExplainRequestReason { scope, deniedList ->
           val message = "蓝牙使用需要同意以下权限才能正常使用"
           scope.showRequestReasonDialog(deniedList, message, "允许", "拒绝")
       }
       .onForwardToSettings { scope, deniedList ->
           scope.showForwardToSettingsDialog(
               deniedList, "定位权限设置", "ok", "ignore"
           )
       }
       .request { allGranted, grantedList, deniedList -> }

权限申请完整代码

BasePermissionActivity.kt

package com.aimed.measure.ui.measure

import android.Manifest
import android.app.AlertDialog
import android.bluetooth.BluetoothAdapter
import android.content.BroadcastReceiver
import android.content.Context
import android.content.Intent
import android.content.IntentFilter
import android.content.pm.PackageManager
import android.location.LocationManager
import android.os.Build
import android.provider.Settings
import androidx.viewbinding.ViewBinding
import com.aimed.measure.R
import com.aimed.measure.base.BaseVBActivity
import com.aimed.measure.ext.showToast
import com.aimed.measure.utils.GpsUtil
import com.aimed.measure.utils.LogUtils
import com.aimed.measure.utils.StringUtils
import com.kl.minttisdk.ble.BleConstants
import com.permissionx.guolindev.PermissionX


abstract class BasePermissionActivity<VB : ViewBinding> : BaseVBActivity<VB>() {
    private var permissionCallback: (() -> Unit)? = null
    private val permissionList = mutableListOf<String>()
    var isNeedPermission = false

	// 统设置页面通常不会返回结果数据，导致 onActivityResult() 不被调用，所以采用广播。
    private val gpsStatusReceiver = object : BroadcastReceiver() {
        override fun onReceive(context: Context, intent: Intent) {
            if (LocationManager.PROVIDERS_CHANGED_ACTION == intent.action) {
                LogUtils.d("GPS已开启")
                if (GpsUtil.isGpsEnable(this@BasePermissionActivity)) {
                    if (isBluetoothEnable()) {
                        LogUtils.d("蓝牙已开启")
                        isNeedPermission = true
                        permissionCallback?.invoke()
                    } else {
                        //打开蓝牙
                        enableBluetooth()
                    }
                } else {
                    showToast("位置信息开启失败，请手动开启")
                }
            }
        }
    }

    fun requestPermission(callback: (() -> Unit)?) {
        permissionCallback = callback
		val permissionList = mutableListOf<String>()
        permissionList.add(Manifest.permission.WRITE_EXTERNAL_STORAGE)
        if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.M) {// Android 6.0到Android 11
            permissionList.add(Manifest.permission.ACCESS_FINE_LOCATION)// 精确位置
            permissionList.add(Manifest.permission.ACCESS_COARSE_LOCATION)// 粗略位置
        }
        if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.S) { // Android 12及以上
            permissionList.add(Manifest.permission.BLUETOOTH_CONNECT)
            permissionList.add(Manifest.permission.BLUETOOTH_SCAN)
        }
        LogUtils.d("权限列表：$permissionList")
        LogUtils.d("SDK版本：${Build.VERSION.SDK_INT}")

        PermissionX.init(this)
            .permissions(permissionList)
            .onExplainRequestReason { scope, deniedList ->
                val message = "蓝牙使用需要同意以下权限才能正常使用"
                scope.showRequestReasonDialog(deniedList, message, "允许", "拒绝")
            }
            .onForwardToSettings { scope, deniedList ->
                scope.showForwardToSettingsDialog(
                    deniedList, "蓝牙使用需要同意以下权限才能正常使用", "允许", "拒绝"
                )
            }
            .request { allGranted, grantedList, deniedList ->
                if (allGranted) {
                    if (GpsUtil.isGpsEnable(this)) {
                        if (isBluetoothEnable()) {
                            LogUtils.d("蓝牙已开启")
                            isNeedPermission = true
                            permissionCallback?.invoke()
                        } else {
                            //打开蓝牙
                            enableBluetooth()
                        }
                    } else {
                        showOpenGpsDialog()
                    }
                } else {
                    showToast(getString(R.string.aimed_common_permission))
                }
            }
    }

    /**
     * 请求打开蓝牙
     */
    private fun enableBluetooth() {
        try {
            val openIntent = Intent(BluetoothAdapter.ACTION_REQUEST_ENABLE)
            startActivityForResult(openIntent, BleConstants.ACTION_ENABLE_BLUETOOTH)
        } catch (e: SecurityException) {
            // 处理异常情况，例如提示用户权限被拒绝
            LogUtils.d("请先授予蓝牙权限")
            showToast("请先授予蓝牙权限")
        }
    }

    private fun showOpenGpsDialog() {
        // 创建一个 AlertDialog.Builder 实例
        AlertDialog.Builder(this)
            .setTitle("位置信息未启用") // 设置标题
            .setMessage(StringUtils.getString(R.string.aimed_local_not_open)) // 设置内容
            .setPositiveButton(
                "前往设置"
            ) { dialog, which -> // 用户点击“确定”按钮后的逻辑

                // 注册广播接收器
                val filter = IntentFilter(LocationManager.PROVIDERS_CHANGED_ACTION)
                registerReceiver(gpsStatusReceiver, filter)

                startActivity(Intent(Settings.ACTION_LOCATION_SOURCE_SETTINGS))
                dialog.dismiss()
            }
            .setNegativeButton(
                "取消"
            ) { dialog, which -> // 用户点击“取消”按钮后的逻辑
                dialog.dismiss()
            }
            .setCancelable(false) // 禁止用户通过点击外部关闭弹窗
            .show() // 显示弹窗
    }

    /**
     * 请求打开蓝牙回调
     * @param requestCode
     * @param resultCode
     * @param data
     */
    override fun onActivityResult(requestCode: Int, resultCode: Int, data: Intent?) {
        super.onActivityResult(requestCode, resultCode, data)
        LogUtils.d("onActivityResult：$requestCode")
        if (requestCode == BleConstants.ACTION_ENABLE_BLUETOOTH && resultCode == RESULT_OK) {
            isNeedPermission = true
            permissionCallback?.invoke()
        }
    }

    /**
     * 表示检查设备是否支持低功耗蓝牙（BLE）
     */
    fun isSupportBle(): Boolean {
        return this.packageManager.hasSystemFeature(PackageManager.FEATURE_BLUETOOTH_LE)
    }

    /**
     * 检查设备是否支持蓝牙（包含BLE和经典蓝牙）
     */
    fun isSupportBluetooth(): Boolean {
        val bluetoothAdapter = BluetoothAdapter.getDefaultAdapter()
        return bluetoothAdapter != null
    }

    /**
     * 蓝牙是否开启
     */
    fun isBluetoothEnable(): Boolean {
        val bluetoothAdapter = BluetoothAdapter.getDefaultAdapter()
        return bluetoothAdapter != null && bluetoothAdapter.isEnabled
    }
    
    override fun onDestroy() {
        super.onDestroy()
        // 注销广播接收器
        unregisterReceiver(gpsStatusReceiver)
    }
}

GpsUtil .java

public class GpsUtil {
    /**
     * GPS 或网络定位服务是否启用
     */
    public static boolean isGpsEnable(Context context) {
        if (context == null) {
            return false;
        }
        if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.P) {
            // Android 10+ 无需检查位置服务状态，只需要检查位置权限
            return true;
        } else {
            // Android 10 及以下需要检查位置服务
            LocationManager locationManager = (LocationManager) context.getSystemService(Context.LOCATION_SERVICE);
//            List<String> providers = locationManager.getAllProviders();
//            LogUtils.d("位置信息：" + providers.toString());

            boolean gps = locationManager.isProviderEnabled(LocationManager.GPS_PROVIDER);
            boolean network = locationManager.isProviderEnabled(LocationManager.NETWORK_PROVIDER);
            boolean fused = locationManager.isProviderEnabled(LocationManager.FUSED_PROVIDER);//融合多种数据源（GPS、Wi-Fi、基站、传感器）计算位置，由 Google Play 服务提供。
            return gps || network || fused;
        }
    }
}
唐诺
关注
Android 12 蓝牙权限适配指南
DhGrad_Bias的博客
09-20 1244
随着 Android 12 的发布，Google 引入了一些新的变化和限制，特别是在蓝牙权限方面。本文将介绍如何适配 Android 12 中的蓝牙权限，并提供相应的源代码示例。请确保在使用这些权限之前，您已经向用户请求了相应的运行时权限。否则，您的应用程序将无法正常使用蓝牙功能。通过遵循以上步骤可以成功适配 Android 12 中的蓝牙权限，确保您的应用程序能够正常使用蓝牙功能。请注意，以上示例代码仅用于说明目的，您需要根据自己的应用程序逻辑进行适当的修改和调整。如果您还有其他问题，请随时提问。
Android 12 蓝牙相关适配记录
loveseal518的博客
02-07 466
排查第三方APP在Android 13手机上启动后就闪退，查阅了Android相关变更，初步判断本质还是未适配Android 12 蓝牙相关新权限。接下来在你的代码中动态申请这几处权限，业务逻辑中如果未获得权限之前不要去做蓝牙操作。androidmanifest中增加3个权限，并确保exported为true。build.gradle中 提高api至31。Android 12 蓝牙相关适配记录。特别注意线上平台收集信息不全。
Android开发——实现蓝牙扫描设备功能所需权限和服务
furkaies的博客
07-24 1320
Android
Android 蓝牙开发 - 蓝牙相关权限（蓝牙基本权限、Android 12 蓝牙新增权限、位置权限）
最新发布
weixin_52173250的博客
05-20 1127
Android 蓝牙开发 - 蓝牙相关权限（蓝牙基本权限、Android 12 蓝牙新增权限、位置权限）
Android6.0的蓝牙权限问题
paul_zzq的博客
04-26 7503
#Android6.0的蓝牙权限问题 在Adroid6.0以前，申请权限只需在manifest文件下申请相应的权限即可，但是Android6.0后，像一些危险权限，比如操作SD卡的写入，相机，录音等，是需要在java代码中去申请的。 本篇文章，主要是讲Android6.0系统中扫描蓝牙的权限的申请。 首先，我们需要检查当前手机的系统版本，检查系统版本的原因，显而易见，如果是系统
Android 蓝牙开发 入门级（史上最全）
热门推荐
u013302168的博客
03-07 1万+
蓝牙是一种无线技术标准，用于短距离内的数据交换。在Android设备上，蓝牙技术允许进行设备发现、配对、连接以及数据传输。技术始于爱立信公司 1994 方案，它是研究在移动电话和其他配件间进行低功耗、低成本无线通信连接的方法。发明者希望为设备间的通讯创造一组统一规则（标准化协议）用来解决用户间相互不兼容的移动电子设备。 在开始开发之前，需要在Android项目的AndroidManifest.xml文件中声明蓝牙相关的权限。对于基本的蓝牙操作，需要以下权限： 从Android 6.0（API级别23）开
android12蓝牙适配
ming0gy的博客
03-06 1380
根据google官方资料，Android 12（API 31） 引入了 BLUETOOTH_SCAN、BLUETOOTH_ADVERTISE 和 BLUETOOTH_CONNECT 权限，可让您的应用扫描附近的设备，而无需请求位置权限。这几个权限是运行时权限，用于查找蓝牙设备、使某个设备可被其他设备检测到，或者与已配对的蓝牙设备通信，必须主动申请。
Android 12 蓝牙适配
晨曦
04-26 1万+
Android 12.0蓝牙适配前言正文一、Android版本中蓝牙简介二、新建项目① 配置settings.gradle和build.gradle② 配置AndroidManifest.xml三、打开蓝牙① 打开蓝牙意图② 请求BLUETOOTH_CONNECT权限意图四、蓝牙扫描① 扫描者② 扫描回调③ 扫描方法④ 执行扫描 前言   在我的申请下，公司终于购买了一台基于Android12.0的手机，然后我就开心的拿去安装测试了，发现程序崩溃了，于是我这里就写下来，Android12.0的蓝牙适配方法。
Android 12 蓝牙适配 Java版
晨曦
01-06 6623
  本身已经写过一篇关于蓝牙适配的文章了，不过因为是Kotlin，很多读者看不懂，对此我深感无奈，一开始也没有想过再写Java版本的，但是后面发现看不懂的越来越多了，我意识到不对劲了，因此我觉得再写一个Java版本的。   在Android系统版本中，蓝牙的变化有，但是不多，这里简要说明一下。  在Android12.0中新增加了三个运行时权限，我们依次来说明一下，这里我们依然创建一个项目来说明，新建一个Android12Bluetooth-Java项目，如下图所示： 点击Finish，完成项目的创建。然后
Android12中蓝牙权限适配
aidou1314的博客
03-16 8319
Android中蓝牙权限适配 android.permission.BLUETOOTH android.permission.BLUETOOTH_ADMIN android.permission.BLUETOOTH_SCAN android.permission.BLUETOOTH_ADVERTISE android.permission.BLUETOOTH_CONNECT
【Android 】蓝牙常用的权限申请
m0_73884485的博客
04-23 2535
【代码】【Android 】蓝牙常用的权限申请。
Android 如何实现动态申请权限
08-19
正常权限是指那些不会对用户隐私和安全造成影响的权限，例如蓝牙权限、网络权限等，而危险权限是指那些可能对用户隐私和安全造成影响的权限，例如摄像头权限、麦克风权限等。 在应用程序中，需要申请权限的步骤是：...
Android 6.0 蓝牙搜索不到设备原因,MIUI权限申请机制方法
01-04
为提供更高的数据保护 Android6.0版本上增加了关于Wifi和蓝牙的权限。 蓝牙搜索到设备需要用到定位服务，所以在开发中 targetSdkVersion 大于等于23（6.0） 需要在代码中进行权限获取 需要在配置文件中申请两个权限...
android申请蓝牙动态权限,Android权限动态申请
weixin_42202724的博客
05-26 3677
Android 6.0以后一些权限只在清单文件中申请是不能使用的，所以要动态申请，如：相机权限、内存卡读写权限、通话状态权限等，但是当使用到才申请用户体验太差，所以就在进入到首页或启动页时统一申请使用的所用权限。一、首先要在清单文件中注册权限(动态申请的权限也需要先在清单文件中注册)二、在首页Activity中申请final int REQUEST_PERMISSION_LOCATION = 10...
android申请蓝牙的权限,Android Studio 真机调试捕获异常申请和蓝牙权限代码
weixin_39853210的博客
06-04 1357
Android Studio 真机调试捕获异常申请和蓝牙权限代码第一步：在Android的manifest.xml文档中加入下面的声明：android:name="android.hardware.bluetooth_le"android:required="true" />第二步：在onCreate()方法加入如下两行：checkAndRequestPermission();//第一步：t...
android 6.0蓝牙服务开启,Android6.0蓝牙权限申请及开启蓝牙
weixin_33724759的博客
05-26 3245
1、需要申请如下权限android:name="android.hardware.bluetooth_le"android:required="true" />2、申请运行时权限/*** 检查蓝牙权限*/public void checkBlePermission() {if (ContextCompat.checkSelfPermission(this,Manifest.permissio...
Android 蓝牙权限申请适配全机型优化指南
weixin_51522235的博客
11-16 6031
Android 蓝牙权限申请适配全机型优化指南
蓝牙开发之-Android12及以下权限申请 及蓝牙详细流程图
qq_17189617的专栏
12-29 3314
- 申明该权限不适用于安卓12及以上 -->-- 申明该权限不适用于安卓12及以上 -->Log.i("权限","-----onPermissionsGranted-------")Log.i("权限","-----onPermissionsGranted-------")-- 申明手机需要支持BLE -->-- 申明手机需要支持蓝牙 -->"此功能需要位置信息权限与附近的设备权限，请设置","此功能需要位置信息权限与附近的设备权限，请设置",--声明后台定位权限-->权限通过后 再去检测下。
Android蓝牙各个版本需要申请的权限
weixin_39788742的博客
10-30 953
我们在进行android蓝牙Ble开发的时候，时常会以为系统版本特性的差异，导致没有按照引导动态申请对应的权限，以下是各个版本使用蓝牙时需要申请的权限：一：android13以上:二：android12-android12L：三：其余：
android studio申请蓝牙权限
03-22
### 如何在 Android Studio 中正确申请蓝牙权限 为了确保应用程序能够在运行时访问设备的蓝牙功能，开发者需要遵循特定流程来请求必要的权限。以下是关于如何在 Android Studio 中正确申请蓝牙权限的相关说明。 #### 权限声明 在 `AndroidManifest.xml` 文件中，必须显式声明所需的蓝牙权限。通常情况下，至少需要以下两个基本权限： - **BLUETOOTH**: 允许程序连接到已配对的蓝牙设备并发现可检测的设备。 - **BLUETOOTH_ADMIN**: 允许程序发起设备可见性请求以及扫描其他蓝牙设备。 此外，在 Android 12 (API Level 31) 及更高版本中，还需要额外声明位置权限[^3]。 ```xml <uses-permission android:name="android.permission.BLUETOOTH"/> <uses-permission android:name="android.permission.BLUETOOTH_ADMIN"/> <!-- 针对 Android 12 或更高的 API --> <uses-permission android:name="android.permission.ACCESS_FINE_LOCATION"/> ``` #### 运行时权限处理 自 Android 6.0 (API Level 23) 开始，某些敏感权限（如蓝牙）需通过动态方式获取用户的授权。这意味着即使已在清单文件中声明了所需权限，仍可能需要进一步确认用户是否同意授予这些权限[^4]。 ##### 检查当前权限状态 可以利用 ContextCompat 类中的 checkSelfPermission 方法判断目标权限的状态。如果返回值为 PackageManager.PERMISSION_GRANTED，则表示已经获得该权限；反之则尚未得到许可。 ```java if (ContextCompat.checkSelfPermission(this, Manifest.permission.BLUETOOTH) != PackageManager.PERMISSION_GRANTED || ContextCompat.checkSelfPermission(this, Manifest.permission.ACCESS_FINE_LOCATION) != PackageManager.PERMISSION_GRANTED){ // 请求缺失的权限 } ``` ##### 提交权限请求 当检测到缺少必要权限时，应调用 requestPermissions 向用户发出提示框询问其意愿。此操作会触发 onRequestPermissionsResult 回调函数以便后续逻辑执行。 ```java ActivityCompat.requestPermissions( this, new String[]{Manifest.permission.BLUETOOTH, Manifest.permission.ACCESS_FINE_LOCATION}, REQUEST_CODE_BLUETOOTH_PERMISSION); ``` 注意：REQUEST_CODE_BLUETOOTH_PERMISSION 是一个自定义常量用于区分不同的权限组请求场景。 --- ###
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值