如何在Flutter中通过自定义弹窗设置位置权限授权

核心实现逻辑 #

• 优先展示自定义权限提示弹窗，而非直接触发系统原生权限请求
• 用户点击「同意」时，再调用系统权限API正式申请位置权限
• 用户点击「不同意」时，记录权限拒绝状态，可选提示用户后续手动开启权限

iOS 代码示例 #

// 显示自定义权限弹窗
func showCustomLocationPermissionAlert() {
    let alert = UIAlertController(title: "需要位置权限", message: "我们需要获取您的位置来提供更好的服务", preferredStyle: .alert)
    
    // 同意按钮逻辑
    let allowAction = UIAlertAction(title: "同意", style: .default) { _ in
        self.requestSystemLocationPermission()
    }
    
    // 不同意按钮逻辑
    let denyAction = UIAlertAction(title: "不同意", style: .cancel) { _ in
        self.handlePermissionDenied()
    }
    
    alert.addAction(allowAction)
    alert.addAction(denyAction)
    self.present(alert, animated: true)
}

// 调用系统权限请求
private func requestSystemLocationPermission() {
    let locationManager = CLLocationManager()
    switch CLLocationManager.authorizationStatus() {
    case .notDetermined:
        // 根据业务需求选择 whenInUse 或 always 权限
        locationManager.requestWhenInUseAuthorization()
    case .denied, .restricted:
        // 已拒绝权限，提示用户去设置开启
        self.showGoToSettingsPrompt()
    default:
        // 已授权，直接执行后续逻辑
        self.onLocationPermissionGranted()
    }
}

// 处理权限拒绝逻辑
private func handlePermissionDenied() {
    // 持久化记录拒绝状态，避免重复弹窗
    UserDefaults.standard.set(true, forKey: "locationPermissionDenied")
    
    // 可选：提示用户后续可手动开启
    let promptAlert = UIAlertController(title: "权限已拒绝", message: "您可以在设置中重新开启位置权限", preferredStyle: .alert)
    promptAlert.addAction(UIAlertAction(title: "知道了", style: .default))
    self.present(promptAlert, animated: true)
}

// 引导用户前往设置的弹窗
private func showGoToSettingsPrompt() {
    let alert = UIAlertController(title: "位置权限已关闭", message: "请前往应用设置开启位置权限", preferredStyle: .alert)
    let settingsAction = UIAlertAction(title: "去设置", style: .default) { _ in
        guard let settingsUrl = URL(string: UIApplication.openSettingsURLString) else { return }
        UIApplication.shared.open(settingsUrl)
    }
    alert.addAction(settingsAction)
    alert.addAction(UIAlertAction(title: "取消", style: .cancel))
    self.present(alert, animated: true)
}

// 权限授予后的业务逻辑
private func onLocationPermissionGranted() {
    // 执行需要位置权限的操作，比如初始化定位服务
}

Android 代码示例 #

private const val LOCATION_PERMISSION_REQUEST_CODE = 1001

// 显示自定义权限弹窗
fun showCustomLocationPermissionDialog() {
    AlertDialog.Builder(this)
        .setTitle("需要位置权限")
        .setMessage("我们需要获取您的位置来提供更好的服务")
        .setPositiveButton("同意") { _, _ ->
            requestSystemLocationPermission()
        }
        .setNegativeButton("不同意") { _, _ ->
            handlePermissionDenied()
        }
        .create()
        .show()
}

// 请求系统位置权限
private fun requestSystemLocationPermission() {
    val permissions = arrayOf(
        Manifest.permission.ACCESS_FINE_LOCATION,
        Manifest.permission.ACCESS_COARSE_LOCATION
    )
    if (ContextCompat.checkSelfPermission(this, Manifest.permission.ACCESS_FINE_LOCATION) != PackageManager.PERMISSION_GRANTED) {
        ActivityCompat.requestPermissions(this, permissions, LOCATION_PERMISSION_REQUEST_CODE)
    } else {
        onLocationPermissionGranted()
    }
}

// 处理权限请求结果
override fun onRequestPermissionsResult(requestCode: Int, permissions: Array<out String>, grantResults: IntArray) {
    super.onRequestPermissionsResult(requestCode, permissions, grantResults)
    if (requestCode == LOCATION_PERMISSION_REQUEST_CODE) {
        if (grantResults.isNotEmpty() && grantResults[0] == PackageManager.PERMISSION_GRANTED) {
            onLocationPermissionGranted()
        } else {
            handlePermissionDenied()
        }
    }
}

// 处理权限拒绝逻辑
private fun handlePermissionDenied() {
    // 持久化记录拒绝状态
    getSharedPreferences("AppSettings", Context.MODE_PRIVATE)
        .edit()
        .putBoolean("locationPermissionDenied", true)
        .apply()
    
    // 可选：提示用户去设置开启
    AlertDialog.Builder(this)
        .setTitle("权限已拒绝")
        .setMessage("您可以在应用设置中重新开启位置权限")
        .setPositiveButton("去设置") { _, _ ->
            val intent = Intent(Settings.ACTION_APPLICATION_DETAILS_SETTINGS)
            val uri = Uri.fromParts("package", packageName, null)
            intent.data = uri
            startActivity(intent)
        }
        .setNegativeButton("知道了", null)
        .create()
        .show()
}

// 权限授予后的业务逻辑
private fun onLocationPermissionGranted() {
    // 执行需要位置权限的操作，比如初始化定位服务
}

关键注意事项 #

• 必须先展示自定义弹窗，禁止直接调用系统权限请求API，否则会跳过自定义弹窗直接弹出系统原生窗口
• 若用户已拒绝权限并勾选「不再询问」，调用系统权限请求不会触发弹窗，需直接引导用户前往设置页面
• 通过持久化存储（如UserDefaults/SharedPreferences）记录权限状态，避免重复弹出自定义弹窗

内容的提问来源于stack exchange，提问作者Muhammad Muddassar