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

来源:这里教程网 时间:2026-02-21 17:34:38 作者:

在 .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>
显示友好提示,比如:“相机权限未开启,无法拍照。请前往设置 > 应用 > 权限中开启。”

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

相关推荐