当前位置：首页 > news >正文

5 鸿蒙应用权限配置快速落地实操 | 鸿蒙开发筑基实战

news 2026/5/29 1:24:38

鸿蒙应用权限配置快速落地实操 | 鸿蒙开发筑基实战

作者：杨建宾（华夏之光永存）

摘要

本文面向鸿蒙开发新手与普通工程师，详细讲解鸿蒙应用权限配置的完整实操流程，包含权限分类、配置文件声明、运行时申请、权限校验等关键步骤。内容全部采用通用标准方案，无复杂原理、无高阶内容，普通人与AI均可无障碍理解，可直接复制使用，快速解决开发中权限缺失、功能异常、审核不通过等常见问题。

一、前言

在鸿蒙应用开发中，几乎所有涉及系统能力的功能（网络、存储、相机、定位等）都需要配置对应的权限。很多新手开发时功能无法运行、真机测试报错、上架审核被打回，大多是权限配置不规范导致的。本文用最简单直接的步骤，带你一次性搞定权限配置全流程。

二、鸿蒙权限基础分类

鸿蒙权限主要分为两大类，开发时先区分清楚：

普通权限
系统默认允许，只需在配置文件声明，无需用户手动授权，如网络访问。
敏感权限
涉及用户隐私，必须在配置文件声明 + 运行时动态申请，如存储、相机、麦克风、定位等。

三、在 module.json5 中声明权限

所有权限必须先在module.json5里声明，这是基础步骤。

示例配置：

"requestPermissions":[{"name":"ohos.permission.INTERNET"},{"name":"ohos.permission.READ_MEDIA","reason":"用于读取图片和文件","usedScene":{"abilities":["EntryAbility"],"when":"inuse"}},{"name":"ohos.permission.CAMERA","reason":"用于拍摄照片","usedScene":{"abilities":["EntryAbility"],"when":"inuse"}}]

要点：

敏感权限必须填写reason和usedScene，否则审核不通过。
权限名严格使用官方ohos.permission.xxx格式，不能自定义。

四、运行时动态申请敏感权限

敏感权限只配置不够，还必须在代码里动态申请。

1. 导入权限模块

importabilityAccessCtrlfrom'@ohos.abilityAccessCtrl';import{BusinessError}from'@ohos.base';

2. 申请权限示例

asyncfunctionrequestPermission(){letatManager=abilityAccessCtrl.createAtManager();try{// 申请存储权限awaitatManager.requestPermissionsFromUser(getContext(),["ohos.permission.READ_MEDIA","ohos.permission.CAMERA"]);console.log("权限申请成功");}catch(err:BusinessError){console.error("权限申请失败:",err);}}

在页面进入或按钮点击时调用该方法即可。

五、权限状态校验

在使用相关功能前，最好先判断权限是否已授予，避免程序崩溃。

asyncfunctioncheckPermission(permission:string){letatManager=abilityAccessCtrl.createAtManager();letstatus=awaitatManager.checkAccessToken(getContext(),permission);returnstatus===abilityAccessCtrl.GrantStatus.PERMISSION_GRANTED;}