MAUI怎么申请安卓权限 MAUI Android权限请求方法

.NET MAUI 中 Android 权限需三步:1. 在 AndroidManifest.xml 声明权限;2. 运行时调用 Permissions.RequestAsync 按需申请;3. 处理永久拒绝状态并引导用户至设置页。缺一不可,否则功能异常或崩溃。

在 .NET MAUI 中申请 Android 权限,不是只写一行代码就能搞定的事。它需要三步配合:清单声明、运行时请求、状态处理。缺一不可,否则应用可能崩溃或直接被系统拒绝访问。

1. 先在 AndroidManifest.xml 里声明权限

这是最基础但最容易漏的一步。MAUI 不会自动帮你加权限,必须手动编辑 Platforms/Android/AndroidManifest.xml

  • 打开该文件,在 标签内添加相机权限(以相机为例):
  • 如果还要拍照后保存图片,还需加上存储权限:
    (Android 12+ 推荐)
    或旧版兼容写法:
  • 注意:仅声明不请求,调用相机时会抛出 SecurityException;只请求不声明,请求会直接返回 Denied

2. 运行时调用 Permissions.RequestAsync 请求授权

用户安装后不会默认给权限,必须在真正要用功能前主动弹窗申请:

  • 使用标准 API(推荐):
    var status = await Permissions.RequestAsync();
  • 检查结果再执行后续逻辑:
    PermissionStatus.Granted → 安全调用相机
    PermissionStatus.Denied → 用户点了“拒绝”
    ⚠️ PermissionStatus.Disabled → 用户勾选了“不再询问”,需跳转设置页
  • 不要在 App 启动时一次性请求所有权限,应按需、上下文明确地申请(比如点击“拍照”按钮后再触发)。

3. 处理“拒绝且不再提示”的情况

当用户勾选“不再询问”,RequestAsync 会一直返回 Denied,此时必须引导用户手动开启:

  • 检测到 status == PermissionStatus.Denied 且你确认已请求过,可调用:
    await Launcher.OpenAsync("package:com.yourcompany.yourapp");
    (Android 上会跳转到本应用设置页)
  • 更稳妥的做法是先判断是否“被永久拒绝”:
    bool isPermanentlyDenied = status == PermissionStatus.Denied && !await Permissions.CheckStatusAsync().ConfigureAwait(false);
  • 显示友好提示,比如:“相机权限未开启,无法拍照。请前往设置 > 应用 > 权限中开启。”

基本上就这些。关键不是“怎么写”,而是“什么时候写、写在哪、写完怎么兜底”。漏掉任一环,都可能让用户卡在黑屏、白屏或无响应状态。