OpenHarmony应用权限管理全解析：从理论到实战（1）

程序员小周1

已于 2025-02-14 11:30:49 修改

阅读量617

点赞数 22

文章标签： harmonyos 鸿蒙

于 2025-02-14 11:28:32 首次发布

本文链接：https://blog.youkuaiyun.com/qq_66531269/article/details/145629410

版权

一、课程目标

本文章将系统讲解OpenHarmony应用权限管理的核心要点，帮助开发者：

1. 掌握`system_grant`（系统授权）与`user_grant`（用户授权）的区别与使用场景；

2. 学会应用权限的申请流程，包括配置文件声明与动态请求用户授权。

二、权限类型：system_grant vs user_grant

1. system_grant（系统授权）

特点：安装应用时由系统自动授予，无需用户手动操作。（只需要声明权限就可以）
适用场景：涉及基础功能且无需敏感数据的权限，如网络访问、设备信息读取等。
配置方式：在module.json5中声明权限。

2. user_grant（用户授权）

特点：需在应用运行时通过弹窗请求用户授权，用户同意后才生效。
适用场景：涉及用户隐私或敏感操作的权限，如摄像头、麦克风、位置等。
配置方式：在module.json5中声明权限，并通过代码动态请求

三、权限申请实操指南

1.明确需求

在openharmony找到我们需要权限的授权方式，权限级别下节我们再讲解

官网链接：OpenAtom OpenHarmony

2. 声明权限（配置文件）

在module.json5中添加权限声明

官网链接：OpenAtom OpenHarmony

1. system_grant（系统授权）

比如说我们申请网络权限

"requestPermissions": [{
"name": "ohos.permission.INTERNET"
}],

2. user_grant（用户授权）

"requestPermissions": [
  {
    "name": "ohos.permission.MICROPHONE",
    "reason": "$string:module_desc",
    "usedScene": {
      "abilities": [
        "UIAbility"
      ],
      "when": "inuse"
    }
  }
],

ctr加左键可以配置申请权限的原因

假如我这里改成hello world

那后面拉起授权弹窗时：

3. 动态请求用户授权（user_grant）

在代码中调用API拉起授权弹窗：

import abilityAccessCtrl from '@ohos.abilityAccessCtrl';
import { Permissions } from '@ohos.abilityAccessCtrl';
import common from '@ohos.app.ability.common';
const context = getContext(this) as common.UIAbilityContext
@Entry
@Component
struct Index {
  @State message: string = 'Hello World';
  async   aboutToAppear(): Promise<void> {
    await this.requestMicrophone()
  }
  async  requestMicrophone(){
    const permissions:Array<Permissions> = ['ohos.permission.MICROPHONE']
    const atManger = abilityAccessCtrl.createAtManager()
    const requestResult =await atManger.requestPermissionsFromUser(
      context,
      permissions
    )
  }

  build() {
    Row() {
      Column() {
        Text(this.message)
          .fontSize(50)
          .fontWeight(FontWeight.Bold)
      }
      .width('100%')
    }
    .height('100%')
  }
}