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

@ohos/hvigor FileUtil用法
 

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


一、核心方法说明

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

|  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 官方文档 深入使用。

评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值