如何解决Kotlin类文件中精确定位权限请求报错问题？

以下是针对精确定位（ACCESS_FINE_LOCATION）权限请求报错的常见解决步骤：

1. 确认Manifest文件权限声明 #

首先检查AndroidManifest.xml中是否正确添加了精确定位权限，Android 12及以上版本若需同时请求粗略定位，也需声明对应权限：

<uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />
<!-- Android 12+ 可选，若需同时请求粗略定位则添加 -->
<uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION" />

2. 适配动态权限请求逻辑 #

Android 6.0（API 23）及以上版本，危险权限需动态申请，以下是Kotlin实现代码：

private val REQUEST_LOCATION_PERMISSION = 1001

// 请求定位权限
fun requestLocationPermission() {
    if (ContextCompat.checkSelfPermission(this, Manifest.permission.ACCESS_FINE_LOCATION)
        != PackageManager.PERMISSION_GRANTED
    ) {
        val permissions = if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.S) {
            // Android 12+ 可同时请求精确定位和粗略定位
            arrayOf(
                Manifest.permission.ACCESS_FINE_LOCATION,
                Manifest.permission.ACCESS_COARSE_LOCATION
            )
        } else {
            arrayOf(Manifest.permission.ACCESS_FINE_LOCATION)
        }
        ActivityCompat.requestPermissions(this, permissions, REQUEST_LOCATION_PERMISSION)
    } else {
        // 权限已授予，执行定位操作
        startLocationUpdates()
    }
}

// 处理权限请求结果
override fun onRequestPermissionsResult(
    requestCode: Int,
    permissions: Array<out String>,
    grantResults: IntArray
) {
    super.onRequestPermissionsResult(requestCode, permissions, grantResults)
    if (requestCode == REQUEST_LOCATION_PERMISSION) {
        if (grantResults.isNotEmpty() && grantResults[0] == PackageManager.PERMISSION_GRANTED) {
            startLocationUpdates()
        } else {
            Toast.makeText(this, "需要开启精确定位权限才能使用功能", Toast.LENGTH_SHORT).show()
        }
    }
}

// 示例：执行定位操作
private fun startLocationUpdates() {
    // 这里编写你的定位逻辑，比如使用FusedLocationProviderClient
}

3. 处理权限拒绝后的场景 #

如果用户拒绝权限并勾选了「不再询问」，需引导用户到应用设置页开启权限：

fun handlePermissionDenial() {
    if (!ActivityCompat.shouldShowRequestPermissionRationale(
            this,
            Manifest.permission.ACCESS_FINE_LOCATION
        )
    ) {
        // 引导到应用设置页
        val intent = Intent(Settings.ACTION_APPLICATION_DETAILS_SETTINGS).apply {
            data = Uri.fromParts("package", packageName, null)
        }
        startActivity(intent)
    } else {
        // 向用户解释权限必要性后再次请求
        AlertDialog.Builder(this)
            .setTitle("权限说明")
            .setMessage("精确定位权限用于获取您的当前位置，为您提供对应服务")
            .setPositiveButton("确定") { _, _ -> requestLocationPermission() }
            .setNegativeButton("取消", null)
            .show()
    }
}

4. 检查定位服务状态 #

即使权限授予成功，若设备定位服务未开启，仍会导致定位失败，需检查并引导开启：

// 判断定位服务是否开启
fun isLocationEnabled(): Boolean {
    val locationManager = getSystemService(Context.LOCATION_SERVICE) as LocationManager
    return locationManager.isProviderEnabled(LocationManager.GPS_PROVIDER) ||
            locationManager.isProviderEnabled(LocationManager.NETWORK_PROVIDER)
}

// 引导用户开启定位服务
fun promptEnableLocation() {
    if (!isLocationEnabled()) {
        AlertDialog.Builder(this)
            .setTitle("定位服务未开启")
            .setMessage("请开启定位服务以获取精确定位")
            .setPositiveButton("去开启") { _, _ ->
                startActivity(Intent(Settings.ACTION_LOCATION_SOURCE_SETTINGS))
            }
            .setNegativeButton("取消", null)
            .show()
    }
}

内容的提问来源于stack exchange，提问作者Mohamed Yasser Eladawy