在 .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>显示友好提示,比如:“相机权限未开启,无法拍照。请前往设置 > 应用 > 权限中开启。”
基本上就这些。关键不是“怎么写”,而是“什么时候写、写在哪、写完怎么兜底”。漏掉任一环,都可能让用户卡在黑屏、白屏或无响应状态。
