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

在 .NET MAUI 中申请 Android 权限,不是只写一行代码就能搞定的事。它需要三步配合:清单声明、运行时请求、状态处理。缺一不可,否则应用可能崩溃或直接被系统拒绝访问。
1. 先在 AndroidManifest.xml 里声明权限
这是最基础但最容易漏的一步。MAUI 不会自动帮你加权限,必须手动编辑 Platforms/Android/AndroidManifest.xml:
- 打开该文件,在
<manifest></manifest>标签内添加相机权限(以相机为例):<uses-permission android:name="android.permission.CAMERA"></uses-permission> - 如果还要拍照后保存图片,还需加上存储权限:
<uses-permission android:name="android.permission.READ_MEDIA_IMAGES"></uses-permission>(Android 12+ 推荐)
或旧版兼容写法:<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE"></uses-permission> - 注意:仅声明不请求,调用相机时会抛出
SecurityException;只请求不声明,请求会直接返回Denied。
2. 运行时调用 Permissions.RequestAsync 请求授权
用户安装后不会默认给权限,必须在真正要用功能前主动弹窗申请:
- 使用标准 API(推荐):
var status = await Permissions.RequestAsync<permissions.camera>();</permissions.camera> - 检查结果再执行后续逻辑:
✅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<permissions.camera>().ConfigureAwait(false);</permissions.camera> - 显示友好提示,比如:“相机权限未开启,无法拍照。请前往设置 > 应用 > 权限中开启。”
基本上就这些。关键不是“怎么写”,而是“什么时候写、写在哪、写完怎么兜底”。漏掉任一环,都可能让用户卡在黑屏、白屏或无响应状态。