鸿蒙编译框架@ohos/hvigor FileUtil用法

@ohos/hvigor FileUtil用法

在鸿蒙(HarmonyOS)开发中,@ohos/hvigorFileUtil 是用于文件操作的实用工具类,提供了跨平台的文件读写、路径处理等常用方法。以下是其核心用法和示例:


一、核心方法说明

|-----|------|---|-----------------------------------|----------------------------------------------------------------------------|---|
| 方法名 | 功能描述 | | --------------------------------- | -------------------------------------------------------------------------- | |

| readFile(path: string) | 异步读取文件内容(返回 Promise<string>) |

| writeFile(path: string, content: string) | 异步写入文件内容(自动创建目录) |

| copyFile(src: string, dest: string) | 异步复制文件(支持覆盖) |

| deleteFile(path: string) | 异步删除文件 | |

| mkdirs(dirPath: string) | 递归创建目录 |

| exists(path: string) | 检查文件或目录是否存在(返回 Promise<boolean>) |

| listFiles(dirPath: string) | 列出目录下所有文件(返回 Promise<string[]>) |

| normalizePath(path: string) | 标准化路径(跨平台处理路径分隔符) |


二、基础用法示例

1. 读取文件内容
复制代码
import { FileUtil } from '@ohos/hvigor';

async function readConfig() {
  const content = await FileUtil.readFile('src/main/resources/config.json');
  console.log('配置文件内容:', content);
}
2. 写入文件
复制代码
async function generateVersionFile() {
  const version = '1.0.0';
  await FileUtil.writeFile('build/version.txt', `Version: ${version}`);
}
3. 复制资源文件
复制代码
async function copyAssets() {
  await FileUtil.copyFile('assets/raw/icon.png', 'build/res/icon.png');
}
4. 递归创建目录
复制代码
async function prepareDirs() {
  await FileUtil.mkdirs('build/generated/code');
}

三、实战场景

场景 1:动态生成配置文件
复制代码
import { FileUtil } from '@ohos/hvigor';

class ConfigGeneratorPlugin implements HvigorPlugin {
  apply(context: HvigorContext) {
    context.taskRegistry.registerTask('generateConfig', async () => {
      const config = {
        apiUrl: 'https://api.example.com',
        debug: context.getBuildType() === 'debug'
      };
      await FileUtil.writeFile(
        'build/generated/config.json', 
        JSON.stringify(config, null, 2)
      );
    });
  }
}
场景 2:清理构建产物
复制代码
async function cleanBuild() {
  const files = await FileUtil.listFiles('build');
  for (const file of files) {
    await FileUtil.deleteFile(file);
  }
}

四、路径处理技巧

结合 FileUtil.normalizePath 处理跨平台路径:

复制代码
const winPath = 'src\\main\\resources';
const unixPath = FileUtil.normalizePath(winPath); // 转换为 'src/main/resources'

五、错误处理

复制代码
async function safeRead(path: string) {
  try {
    if (await FileUtil.exists(path)) {
      return await FileUtil.readFile(path);
    }
    return '';
  } catch (err) {
    console.error('文件操作失败:', err.message);
    throw err;
  }
}

六、与 Node.js fs 模块对比

| 特性 | FileUtil | Node.js fs | |---------------------|-------------------------------------|--------------------------------|

| API 风格 | Promise-based | Callback/Promise/Sync 混合 |

| 目录自动创建 | 写文件时自动创建父目录 | 需要手动处理 |

| 跨平台路径 | 内置 normalizePath | 需依赖 path 模块 |

| 鸿蒙集成 | 深度集成 Hvigor 构建流程 | 通用文件操作 |


七、注意事项

  1. 路径基准 :相对路径基于 模块根目录 (含 hvigorfile.ts 的目录)
  2. 性能优化 :批量操作建议使用 listFiles + 循环处理
  3. 权限问题:确保对目标目录有写权限

通过 FileUtil 可以更便捷地实现构建流程中的文件操作,建议结合 Hvigor 官方文档 深入使用。

相关推荐
Devil枫2 小时前
HarmonyOS 广告服务 ArkTS 实现指南:从激励广告到多形式适配
华为·harmonyos
猫林老师5 小时前
HarmonyOS 5 性能优化全攻略:从启动加速到内存管理
华为·性能优化·harmonyos
GIS小小研究僧6 小时前
华为电脑 银河麒麟系统 使用CrossOver安装微软Office2016
华为·电脑·银河麒麟
猫林老师7 小时前
HarmonyOS 5 手势系统与高级交互动效开发实战
华为·交互·harmonyos
chensi_077 小时前
uniapp x 鸿蒙开发之调试证书签名配置
服务器·uni-app·harmonyos
搬砖的小码农_Sky10 小时前
鸿蒙(HarmonyOS)应用开发技能栈
harmonyos·鸿蒙系统
D.....l11 小时前
Hi3861 OpenHarmony鸿蒙开发(嵌入式方向) (一)
华为·harmonyos
代码797214 小时前
【无标题】使用 Playwright 实现跨 Chromium、Firefox、WebKit 浏览器自动化操作
运维·前端·深度学习·华为·自动化
yenggd14 小时前
华为bgp路由的各种控制和团体属性及orf使用案例
网络·华为
COWORKSHOP14 小时前
华为芯片泄密案警示:用Curtain e-locker阻断内部数据泄露
运维·服务器·前端·数据库·安全·华为