鸿蒙Next外部存储如何实现

在鸿蒙Next系统中，如何实现外部存储的读写操作？具体需要调用哪些API接口？是否支持USB设备或SD卡等常见外部存储介质？开发时需要注意哪些权限配置和兼容性问题？

2 回复

鸿蒙Next外部存储？简单说就是“借地盘存东西”！用ohos.file.fs API，像搭积木一样操作U盘、SD卡。先申请权限，再用getExternalStorageDir()找地盘，最后用openSync()读写文件——就像在别人家冰箱存零食，记得用完说谢谢（释放资源）！

更多关于鸿蒙Next外部存储如何实现的实战系列教程也可以访问 https://www.itying.com/category-93-b0.html


在鸿蒙（HarmonyOS）Next中，外部存储的实现主要通过用户文件访问框架（User File Access Framework, UFAF） 来管理，确保数据安全和隐私保护。以下是关键步骤和代码示例：

1. 权限申请

在 module.json5 中声明存储权限：

{
  "module": {
    "requestPermissions": [
      {
        "name": "ohos.permission.READ_USER_STORAGE",
        "reason": "需要读取外部存储"
      },
      {
        "name": "ohos.permission.WRITE_USER_STORAGE",
        "reason": "需要写入外部存储"
      }
    ]
  }
}

2. 选择文件（用户授权）

使用 picker 让用户选择文件，无需直接路径访问：

import { picker } from '@kit.FileKit';

// 选择单个文件
let photoPicker = new picker.PhotoViewPicker();
photoPicker.select().then((photoSelectResult) => {
  let uri = photoSelectResult.photoUris[0];
  console.info('文件URI:', uri);
}).catch((err) => {
  console.error('选择失败:', err);
});

3. 文件读写操作

通过 fileIo 和 fileUri 处理文件：

import { fileIo, fileUri } from '@kit.FileKit';

// 读取文件内容
async function readFile(uri: string) {
  let file = await fileIo.open(uri, fileIo.OpenMode.READ_ONLY);
  let content = await fileIo.readText(file.fd);
  console.info('文件内容:', content);
  fileIo.close(file.fd);
}

// 写入文件
async function writeFile(uri: string, data: string) {
  let file = await fileIo.open(uri, fileIo.OpenMode.WRITE_ONLY | fileIo.OpenMode.CREATE);
  await fileIo.write(file.fd, data);
  fileIo.close(file.fd);
}

4. 安全注意事项

  • 无直接路径访问：鸿蒙禁止通过绝对路径操作外部存储，必须通过 Uri 和安全框架。
  • 用户授权：所有文件操作需经用户选择或授权，避免隐私泄露。

总结

鸿蒙Next通过 UFAF 和 Picker 机制实现外部存储的安全访问，开发者需遵循权限申请和用户交互流程。代码示例涵盖了文件选择、读写等常见场景，实际开发中需根据业务调整。

回到顶部