Android Studio Chipmunk蓝牙权限检查报Context类型不兼容错误

1. 修复 incompatible types: cannot be converted to Context 错误 #

ActivityCompat.checkSelfPermission 第一个参数必须是合法的Context实例，直接传this报错的核心原因是当前代码的this不是Context子类：

• 若代码在Fragment中：用 requireContext() 替代this，修改后代码：

  ActivityCompat.checkSelfPermission(requireContext(), Manifest.permission.BLUETOOTH_CONNECT)
  

• 若代码在工具类/非Context类中：调用方法时主动传入Context参数，比如工具类方法定义为：

  public static void checkBluetoothPermission(Context context) {
      if (ActivityCompat.checkSelfPermission(context, Manifest.permission.BLUETOOTH_CONNECT) == PackageManager.PERMISSION_GRANTED) {
          // 执行蓝牙操作
      }
  }
  

• 若代码在Activity中仍报错：检查Activity是否正确继承AppCompatActivity或Activity，确保this属于Context子类

2. 处理废弃API与不安全操作提示 #

Android 12（API 31）起旧蓝牙API被废弃，需适配新权限与API：

权限适配（Manifest配置） #

区分API级别配置权限，避免冗余与权限拒绝：

<!-- API 30及以下旧蓝牙权限 -->
<uses-permission android:name="android.permission.BLUETOOTH" android:maxSdkVersion="30" />
<uses-permission android:name="android.permission.BLUETOOTH_ADMIN" android:maxSdkVersion="30" />
<!-- API 31+ 新蓝牙权限 -->
<uses-permission android:name="android.permission.BLUETOOTH_CONNECT" />
<uses-permission android:name="android.permission.BLUETOOTH_SCAN" android:usesPermissionFlags="neverForLocation" />

替代废弃API #

• 废弃的BluetoothAdapter.enable()改用requestEnable()，通过ActivityResultLauncher处理回调：

  // 定义Launcher（在Activity/Fragment的onCreate中初始化）
  private ActivityResultLauncher<Intent> enableBtLauncher = registerForActivityResult(
      new ActivityResultContracts.StartActivityForResult(),
      result -> {
          if (result.getResultCode() == Activity.RESULT_OK) {
              // 蓝牙开启成功
          } else {
              // 用户拒绝开启蓝牙
          }
      }
  );
  
  // 调用开启蓝牙
  Intent enableBtIntent = new Intent(BluetoothAdapter.ACTION_REQUEST_ENABLE);
  enableBtLauncher.launch(enableBtIntent);
  

• 蓝牙扫描改用BluetoothLeScanner配合ScanCallback，替代旧的startDiscovery()

消除不安全操作提示 #

• 所有蓝牙操作前必须做权限校验，示例：

  int permissionState = ContextCompat.checkSelfPermission(requireContext(), Manifest.permission.BLUETOOTH_CONNECT);
  if (permissionState == PackageManager.PERMISSION_GRANTED) {
      // 执行蓝牙连接/扫描等操作
  } else {
      // 请求权限
      ActivityCompat.requestPermissions(requireActivity(), new String[]{Manifest.permission.BLUETOOTH_CONNECT}, 1001);
  }
  

• 避免模糊类型转换，确保变量类型与蓝牙API返回值一致（比如用BluetoothDevice而非Object接收设备实例）

3. 额外配置要求 #

• Android Studio Chipmunk对应gradle插件7.0+，需将build.gradle(Module)中的compileSdkVersion和targetSdkVersion设置为31及以上
• 测试优先使用API 31+的设备，避免旧系统的权限兼容问题

内容的提问来源于stack exchange，提问作者Jim S.