UniApp打包鸿蒙APP全流程（详细配置并添加UniApp所需鸿蒙系统权限指南）

一、 为什么权限配置如此重要？

在进行 HarmonyOS应用开发 时，权限是保护用户隐私的第一道防线。UniApp 的各种系统 API（如定位、相机、文件存取等）在鸿蒙端运行时，必须在原生工程中预先声明对应的权限，否则系统会直接拦截调用请求。

二、 核心配置步骤

1. 定位配置文件

首先，您需要使用 DevEco Studio 打开 HBuilderX 导出的鸿蒙工程项目。找到目录：entry/src/main/module.json5。这是鸿蒙应用的核心配置文件。

2. 添加 requestPermissions 节点

在 module.json5 的 module 对象内，找到或新建 requestPermissions 数组，按需添加以下格式的代码：

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

三、 常见权限名称参考

以下是根据 UniApp开发教程 总结的常用权限对照表：

• 相机权限：ohos.permission.CAMERA
• 麦克风权限：ohos.permission.MICROPHONE
• 位置权限：ohos.permission.APPROXIMATELY_LOCATION
• 媒体库写权限：ohos.permission.WRITE_IMAGEVIDEO

四、 注意事项与总结

在完成权限添加后，别忘了在 resources/base/element/string.json 中配置对应的 reason 说明，这不仅是鸿蒙系统的规范，也能提升用户授权的成功率。正确的配置是 UniApp鸿蒙打包 成功的基石。