背景

Flutter OH 应用在调用某些系统功能时（如网络、相机、定位、存储等），需要在 ohos 原生侧声明相应权限。若未正确申请权限，可能导致 API 调用失败或应用崩溃。

权限声明位置

  • 在 ohos/entry/src/main/module.json5 文件的 module 内配置 requestPermissions 声明权限：
{
  "module": {
    "name": "entry",
    "type": "entry",
    "description": "$string:module_desc",
    "mainElement": "EntryAbility",
    "deviceTypes": [
      "phone",
      "tablet"
    ],
    "pages": "$profile:main_pages",
    // 权限声明在此处
    "requestPermissions": [
      {
        "name": "ohos.permission.INTERNET"
      }
    ]
  }
}

  • 配置权限之后，需要重新签名

    File → Project Structure → Project → Signing Configs

功能与权限对照表

开发 Flutter OH 应用时，请根据功能场景，在 ohos 原生侧申请相应权限：

表格仅列出常用权限，更多权限请参考 应用权限列表

功能场景所需权限授权方式
网络请求ohos.permission.INTERNET系统授权
获取本应用信息ohos.permission.GET_BUNDLE_INFO系统授权
获取设备位置信息ohos.permission.LOCATION_IN_BACKGROUND
ohos.permission.LOCATION
ohos.permission.APPROXIMATELY_LOCATION		用户授权
相机ohos.permission.CAMERA用户授权
麦克风ohos.permission.MICROPHONE用户授权
通讯录ohos.permission.READ_CONTACTS
ohos.permission.WRITE_CONTACTS		用户授权
日历ohos.permission.READ_CALENDAR
ohos.permission.WRITE_CALENDAR
ohos.permission.READ_WHOLE_CALENDAR
ohos.permission.WRITE_WHOLE_CALENDAR		用户授权
运动数据ohos.permission.ACTIVITY_MOTION用户授权
身体传感器ohos.permission.READ_HEALTH_DATA用户授权
图片和视频ohos.permission.WRITE_IMAGEVIDEO
ohos.permission.READ_IMAGEVIDEO
ohos.permission.MEDIA_LOCATION		用户授权
音乐和音频ohos.permission.WRITE_AUDIO
ohos.permission.READ_AUDIO		用户授权
跨应用关联ohos.permission.APP_TRACKING_CONSENT用户授权
设备发现和连接ohos.permission.ACCESS_BLUETOOTH
ohos.permission.ACCESS_NEARLINK
ohos.permission.DISTRIBUTED_DATASYNC		用户授权
剪切板ohos.permission.READ_PASTEBOARD`用户授权
截屏ohos.permission.CUSTOM_SCREEN_CAPTURE`用户授权
文件夹ohos.permission.READ_WRITE_DOWNLOAD_DIRECTORY
ohos.permission.READ_WRITE_DESKTOP_DIRECTORY
ohos.permission.READ_WRITE_DOCUMENTS_DIRECTORY		用户授权

权限与Profile

  • 开发调试时，权限可以在授权到临时签名文件里
  • 发布应用时，需要 申请发布Profile

问题反馈

Logo
开源鸿蒙跨平台开发者社区

开源鸿蒙跨平台开发社区汇聚开发者与厂商，共建“一次开发，多端部署”的开源生态，致力于降低跨端开发门槛，推动万物智联创新。

更多推荐

Capacitor 应用鸿蒙化实战：用 hionic 把 React 应用跑在 OpenHarmony 上

本文基于 hionic 工具链，将 Vite + React 项目成功迁移至 OpenHarmony 平台。通过 hionic init 初始化 Capacitor 工程，添加 openharmony 平台并同步前端构建产物（dist/），解决 webDir 配置与 libssl.so.3 缺失等关键问题，最终在 DevEco Studio 中完成签名 HAP 构建并运行于模拟器。全程零前端代码修

avatar 开源鸿蒙跨平台开发者社区

Flutter 鸿蒙化实战：qrcode_flutter 适配 OpenHarmony，二维码生成与识别

Flutter 鸿蒙化实战：qrcode_flutter 适配 OpenHarmony## 前言随着鸿蒙生态的快速发展，越来越多的 Flutter 应用需要适配 OpenHarmony 平台。但生态早期，大量常用三方库只有 Android / iOS 实现，鸿蒙侧只能自己造轮子。为了解决这个问题，CPF-Flutter 社区对一批高频使用的 Flutter 三方库做了 OpenHarmony 平台

avatar 开源鸿蒙跨平台开发者社区

搜不到 CPF-Cordova 和 CPF-Ionic？一文讲清鸿蒙 Cordova/Capacitor 生态的正确入口（2026 实测）

鸿蒙上的 Cordova = CPF-Cordova（hcordova），鸿蒙上的 Capacitor/Ionic = CPF-Ionic（hionic），入口都在 AtomGit。本文收纳了两个组织的全部仓库入口、实测版本号、上手命令、插件清单与 10 个高频踩坑实测环境：macOS arm64 / Node 26 / DevEco Studio / OpenHarmony 模拟器 7.0.0.

avatar 开源鸿蒙跨平台开发者社区