HarmonyOS7 权限申请全流程：从声明到动态授权

前言

HarmonyOS 对用户隐私管得很严，这其实是好事。但对你开发来说意味着：要用摄像头、定位、通讯录，光在代码里调 API 不够，得走一套"声明 + 动态申请"的流程。

我见过太多新手卡在"为啥调相机没反应"——答案几乎都是没申请权限。这篇文章把权限全流程讲透，从配置文件到运行时弹窗，一步不漏。

第一步：在 module.json5 声明

任何权限，先在配置里"报备"你要用。以定位为例：

代码实现

"requestPermissions": [ { "name": "ohos.permission.LOCATION", "reason": "$string:location_reason", "usedScene": { "abilities": ["EntryAbility"], "when": "inuse" } } ]

• name：权限常量，必须拼对。
• reason：给用户看的理由，写在string.json里，说清楚"为什么需要"。
• when: "inuse"：仅使用时申请，比always对用户更友好，上架也更容易过。

不声明就调用，系统直接拒绝，连弹窗都没有。声明是前提。

第二步：判断当前是否已授权

运行时先查一下，已授权就直接干，没授权再弹窗。用abilityAccessCtrl：

核心代码

import{abilityAccessCtrl}from'@kit.AbilityKit'asyncfunctioncheckPermission(perm:string):Promise<boolean>{constcontext=getContext()constatManager=abilityAccessCtrl.createAtManager()conststatus=awaitatManager.checkAccessToken(context.applicationInfo.accessTokenId,perm)returnstatus===abilityAccessCtrl.GrantStatus.PERMISSION_GRANTED}

checkAccessToken返回"已授权"或"未授权"。先查再申请，避免每次都弹窗烦用户。

第三步：动态申请（弹窗）

没授权就调requestPermissionsFromUser弹系统授权框：

完整示例

asyncfunctionrequestPermission(perm:string):Promise<boolean>{constatManager=abilityAccessCtrl.createAtManager()constresult=awaitatManager.requestPermissionsFromUser(getContext(),[perm]// 可以一次申请多个)// result.authResults[0] === 0 表示用户同意returnresult.authResults[0]===0}

• 传入权限数组，可批量申请。
• authResults[0] === 0代表用户点了"允许"。非 0 就是拒绝了。

完整流程串起来

asyncfunctiondoWithLocation(){constperm='ohos.permission.LOCATION'if(awaitcheckPermission(perm)){startLocate()// 已授权，直接干活return}if(awaitrequestPermission(perm)){startLocate()// 刚授权，干活}else{promptAction.showToast({message:'定位权限被拒绝，功能不可用'})}}

先查、后申请、再判断结果——这就是标准的"声明→检查→申请→使用"四步。少一步都会出问题。

常见权限对照

常见误区（小白必踩）

下面这段代码可以直接复制到 DevEco Studio 里运行。建议你边读边敲，改一改文末「动手改一改」里的参数，亲眼看看效果。

完整可运行示例：动态权限申请

声明 + 运行时弹窗授权，拿「相机」权限做例子。

代码解析

// 运行时动态申请权限import{abilityAccessCtrl}from'@kit.AbilityKit'@Entry@Componentstruct PermDemo{@Stategranted:boolean=falsebuild(){Column({space:16}){Text(this.granted?'已授权':'未授权').fontSize(20)Button('申请相机权限').onClick(async()=>{constatManager=abilityAccessCtrl.createAtManager()constresult=awaitatManager.requestPermissionsFromUser(getContext(),['ohos.permission.CAMERA'])this.granted=result.authResults[0]===0// 0=允许})}.padding(20)}}

你会看到什么：点按钮弹出系统授权框，点「允许」后文字变「已授权」；点「拒绝」则保持未授权。记住：权限必须先在module.json5的requestPermissions声明，否则这里直接失败。

动手改一改：

• 把['ohos.permission.CAMERA']改成多个权限数组，一次申请多个。
• 在module.json5删掉 CAMERA 声明再跑，观察报错，理解「声明是前提」。
• 用verifyAccessToken先做「已授权就不弹窗」的短路判断，优化体验。

写在最后

权限流程记住四步：配文件声明 → 运行时检查 → 弹窗申请 → 按结果处理。永远先check再request，别一上来就弹窗；拒绝后要给用户友好提示，而不是默默失灵。

把这套封装成一个PermissionUtil.doWith(perm, action)工具，全项目复用——你以后写任何需要权限的功能，一行调用就完事。