HarmonyOS NEXT 应用开发：大文件拷贝示例

介绍

文件拷贝是应用开发中的一个常见场景，通常有两种方式：一是直接读写文件的全部内容，二是使用 buffer 多次读写。前者的优点在于使用简单，但是在大文件场景下内存占用较高，影响应用性能；后者的优点在于内存占用较小，但是编程稍显复杂。本例将展示如何使用 buffer 来将大文件的 rawfile 复制到应用沙箱。

使用说明

1. 点击 Start Copy 按钮开始复制
2. 当复制进度达到 100% 之后，点击 Preview 按钮进行文件的预览，以验证文件复制的正确性
3. 如果要反复验证本场景，请在复制完成之后，点击 Reset 按钮，重置进度，再进行后续验证

实现思路

1. 根据 rawfile 文件名获取其所属 hap 包的 RawFileDescriptor，其内部包含真正 rawfile 文件的长度、在 hap 包中的偏移量，hap 包的 fd

let data: resourceManager.RawFileDescriptor = this.context.resourceManager.getRawFdSync(this.fileName);

2. 打开即将写入的目标文件

let targetPath: string = this.context.filesDir + "/" + this.fileName;
let destFile: fs.File = fs.openSync(targetPath, fs.OpenMode.CREATE | fs.OpenMode.READ_WRITE);

3. 创建 buffer，用于读写文件内容

let buffSize: number = BigFileCopyConstants.BUFF_SIZE;
let buffer: ArrayBuffer = new ArrayBuffer(buffSize);

4. 使用 buffer 进行文件内容的循环读写，只要实际读入 buffer 的内容长度不为 0，就表示文件内容没有读取完毕，就将读到的内容写入目标文件。注意，这里使用了 buffSize 来控制想要读取内容的长度，因此需要注意在循环体内对其进行更新

let off: number = 0; // 记录读取位置的偏移（相较于文件起始偏移）
let len: number = 0; // 本次读取内容的实际长度
let readedLen: number = 0; // 记录已读文件长度
while (len = fs.readSync(data.fd, buffer, { offset: data.offset + off, length: buffSize })) {
  readedLen += len;
  fs.writeSync(destFile.fd, buffer, { offset: off, length: len });
  off = off + len;
  if ((data.length - readedLen) < buffSize) {
    buffSize = data.length - readedLen;
  }
}

5. 因为复制的是图片文件，复制完毕之后使用 Image 组件加载该图片进行显示，以验证复制过程的正确性

Image(BigFileCopyConstants.SANDBOX_PREFIX + this.targetFilePath)

工程结构 & 模块类型

bigfilecopy                                        // har 类型
|---constants
|    |---BigFileCopyConstants                      // 常量
|---view
|    |---BigFileCopyView.ets                       // 视图层 - 文件复制页面

总结

通过上述步骤，实现了基于 Buffer 的大文件拷贝功能。相比一次性读取，该方法显著降低了内存峰值占用，适合处理大型资源文件。开发者在实际应用中可根据文件大小动态调整 Buffer 大小以平衡性能与内存消耗。