鸿蒙Next中fs.listFileSync需要什么权限

在鸿蒙Next系统中使用fs.listFileSync方法时，需要申请哪些权限才能正常读取目录文件列表？具体权限名称是什么？是否需要在config.json中配置？

2 回复

在鸿蒙Next里，fs.listFileSync需要文件读写权限。简单说，就是得在module.json5里声明ohos.permission.READ_USER_STORAGE权限，不然系统会傲娇地拒绝你访问文件列表。记得申请权限时态度要好点！

更多关于鸿蒙Next中fs.listFileSync需要什么权限的实战系列教程也可以访问 https://www.itying.com/category-93-b0.html


在鸿蒙Next（HarmonyOS NEXT）中，fs.listFileSync 用于同步列出指定目录下的文件或子目录。要使用此功能，需要以下权限：

  1. 文件存储权限：应用必须声明并获取访问设备存储的权限。

    • 在 module.json5 配置文件中添加权限声明：
      {
  "module": {
    "requestPermissions": [
      {
        "name": "ohos.permission.READ_MEDIA",
        "reason": "需要读取存储以列出文件"
      }
    ]
  }
}
    • 权限名通常为 ohos.permission.READ_MEDIA（具体权限名可能根据HarmonyOS版本调整，请参考最新文档）。

  2. 动态权限申请：在运行时，需通过 abilityAccessCtrl 动态请求用户授权：

    import abilityAccessCtrl from '[@ohos](/user/ohos).abilityAccessCtrl';

let context = ... // 获取Ability上下文
let atManager = abilityAccessCtrl.createAtManager();
try {
  atManager.requestPermissionsFromUser(context, ['ohos.permission.READ_MEDIA']).then((data) => {
    if (data.authResults[0] === 0) {
      // 权限 granted，调用 fs.listFileSync
      const fileList = fs.listFileSync('/path/to/directory');
    } else {
      // 处理权限被拒绝的情况
    }
  });
} catch (err) {
  console.error('权限申请失败: ' + err);
}

注意事项：

  • 确保路径有效，且应用有权限访问目标目录（如应用沙箱目录无需额外权限）。
  • 若访问外部存储或共享目录，需严格遵循权限流程。
  • 参考官方文档确认最新权限要求，避免因版本更新导致变更。

通过正确配置和申请权限，即可安全使用 fs.listFileSync。

回到顶部