在 HarmonyOS（鸿蒙）中，“权限申请”是确保系统安全和用户隐私的关键机制。开发者在使用涉及敏感操作的 API（如定位、摄像头、存储）前，必须向用户申请权限并获得授权，否则调用将失败。

🛡️ 开天辟地 HarmonyOS（鸿蒙）——安全篇：申请权限

✅ 一、什么是权限管理？

权限（Permissions） 是操作系统对应用访问资源的授权机制，HarmonyOS 将权限分为：

  • 普通权限（Normal）：不涉及用户隐私，系统自动授予；
  • 敏感权限（Dangerous）：涉及隐私或关键操作，需用户授权；
  • 系统权限（System）：仅系统或签名应用可使用，如重启、格式化等；

✅ 二、常见敏感权限举例

权限名称功能说明
ohos.permission.CAMERA使用摄像头
ohos.permission.LOCATION访问位置信息（GPS、Wi-Fi等）
ohos.permission.READ_MEDIA读取媒体文件（图片、音频等）
ohos.permission.RECORD_AUDIO麦克风录音
ohos.permission.READ_CONTACTS读取通讯录

✅ 三、权限声明 + 动态申请机制

在 HarmonyOS 中，权限管理分两步走：

🔹 1. 在配置文件 module.json5 中声明权限

"reqPermissions": [
  {
    "name": "ohos.permission.CAMERA",
    "reason": "用于拍摄照片",
    "usedScene": {
      "ability": ["MainAbility"],
      "when": "inuse"
    }
  },
  {
    "name": "ohos.permission.RECORD_AUDIO",
    "reason": "用于音频录制",
    "usedScene": {
      "ability": ["MainAbility"],
      "when": "inuse"
    }
  }
]
  • name: 权限名称
  • reason: 权限用途说明（用于系统弹窗展示给用户）
  • when: 权限使用时机（inuse 表示在前台使用）

🔹 2. 在代码中动态申请权限（JS/eTS）

import { requestPermissionsFromUser, Permissions } from '@ohos.abilityAccessCtrl';
import { getContext } from '@ohos.abilityFeatureAbility';

async function requestCameraPermission() {
  const context = getContext(); // 获取当前 AbilityContext

  const atManager = Permissions.createAtManager(); // 创建权限管理器

  const permissions = ['ohos.permission.CAMERA'];

  try {
    const result = await atManager.requestPermissionsFromUser(context, permissions);
    if (result.authResults[0] === Permissions.GrantStatus.PERMISSION_GRANTED) {
      console.info('已授权 CAMERA 权限');
    } else {
      console.warn('用户拒绝了 CAMERA 权限');
    }
  } catch (error) {
    console.error('申请权限失败:', error);
  }
}

✅ 四、动态权限状态检测

在请求权限前，建议先检查权限是否已授权：

const isGranted = await atManager.verifyAccessToken(context, 'ohos.permission.CAMERA');
if (isGranted === Permissions.GrantStatus.PERMISSION_GRANTED) {
  console.info('已获取权限');
} else {
  console.info('未授权，准备申请权限');
}

✅ 五、系统权限管理弹窗

HarmonyOS 在第一次申请权限时会弹出系统对话框：

  • 显示权限用途（由 reason 提供）
  • 用户可选择：允许一次、始终允许、拒绝

⚠️ 用户如果永久拒绝权限，需引导用户手动在“设置 > 权限管理”中修改授权状态。

✅ 六、最佳实践建议

建议项原因/说明
只在需要使用时申请权限减少用户干扰，提升体验
提供用途说明在弹窗前提示用户为何需要该权限，提升信任感
判断权限状态再申请避免重复弹窗或请求失败
针对拒绝情况提供“引导入口”引导用户前往系统设置打开权限
不滥用敏感权限避免被应用市场下架或拒绝上架，保护用户隐私

✅ 七、eTS 全流程权限申请模板（摄像头）

import { Permissions } from '@ohos.abilityAccessCtrl';
import { getContext } from '@ohos.abilityFeatureAbility';

async function ensureCameraPermission() {
  const context = getContext();
  const atManager = Permissions.createAtManager();
  const CAMERA = 'ohos.permission.CAMERA';

  const granted = await atManager.verifyAccessToken(context, CAMERA);
  if (granted === Permissions.GrantStatus.PERMISSION_GRANTED) {
    console.log('已授权摄像头');
    return true;
  }

  const result = await atManager.requestPermissionsFromUser(context, [CAMERA]);
  if (result.authResults[0] === Permissions.GrantStatus.PERMISSION_GRANTED) {
    console.log('用户同意授权');
    return true;
  } else {
    console.warn('用户拒绝授权');
    return false;
  }
}

✅ 八、权限相关工具和调试方法

工具名称功能说明
DevEco Studio配置权限、调试应用权限行为
hdc shell aac 命令查看/调试 Access Control 权限状态
权限策略日志查看 /var/log/permission.log 文件

✅ 九、常见问题 FAQ

问题原因与解决方案
权限申请弹窗未出现未在 module.json5 正确声明权限
权限总是被拒绝用户永久拒绝授权，需要引导去设置中手动开启
应用无法访问摄像头/麦克风权限未申请成功或未判断授权状态
发布应用被拒申请过多不必要权限、用途描述不清、滥用敏感权限等

✅ 总结

要点内容说明
权限声明在 module.json5 中配置 reqPermissions
动态申请使用 requestPermissionsFromUser() 接口
权限分级普通 / 敏感 / 系统级
用户隐私保护仅按需申请，提前说明用途
分布式支持HarmonyOS 可在多设备间共享权限（需系统层支持）

📌 一句话总结：

在 HarmonyOS 中，权限申请不是附加项，而是用户信任的守门人。妥善处理权限，是构建安全、合规、优秀体验的基础。

如果你需要：

  • 📄 一份权限声明模板（支持多个权限）
  • 🧪 权限测试脚本
  • 💡 拒绝权限后的处理 UI 示例