纯血鸿蒙APP实战开发——大文件拷贝案例

原创

小帅聊鸿蒙

发布于 2025-02-08 20:41:21

750

介绍

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

效果图预览

使用说明

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

实现思路

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

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

打开即将写入的目标文件

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

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

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

DD一下：`欢迎大家关注公众号<程序猿百晓生>，可以了解到一下知识点。`

1.OpenHarmony开发基础
2.OpenHarmony北向开发环境搭建
3.鸿蒙南向开发环境的搭建
4.鸿蒙生态应用开发白皮书V2.0 & V3.0
5.鸿蒙开发面试真题（含参考答案） 
6.TypeScript入门学习手册
7.OpenHarmony 经典面试题(含参考答案)
8.OpenHarmony设备开发入门【最新版】
9.沉浸式剖析OpenHarmony源代码
10.系统定制指南
11.【OpenHarmony】Uboot 驱动加载流程
12.OpenHarmony构建系统--GN与子系统、部件、模块详解
13.ohos开机init启动流程
14.鸿蒙版性能优化指南
.......

使用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;
      }
    }

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

    Image(BigFileCopyConstants.SANDBOX_PREFIX + this.targetFilePath)

高性能知识点

不涉及

工程结构&模块类型

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