企业官网建设流程全解析

HarmonyOS @ohos.zlib (Zip模块) 使用指南：从入门到实战

模块类型：系统内置模块
关键词：文件压缩、文件解压、Zip、zlib、ArkTS

效果

一、模块概述

@ohos.zlib是 HarmonyOS 提供的文件压缩与解压模块，基于 zlib 算法库实现，支持对文件进行压缩（compressFile）和解压（decompressFile）操作。该模块同时提供同步和异步两种调用方式，适用于文件归档、批量传输、缓存管理等场景。

核心能力一览

二、API 详解

2.1 导入模块

importzlibfrom'@ohos.zlib';import{BusinessError}from'@ohos.base';

2.2 Options 配置项

compressFile和decompressFile共享同一个Options接口：

interfaceOptions{level?:CompressLevel;// 压缩等级，默认 COMPRESS_LEVEL_DEFAULT_COMPRESSIONmemLevel?:MemLevel;// 内存等级，默认 MEM_LEVEL_DEFAULTstrategy?:CompressStrategy;// 压缩策略，默认 COMPRESS_STRATEGY_DEFAULT_STRATEGY}

CompressLevel 枚举值：

经验提示：日常场景使用DEFAULT_COMPRESSION即可，在速度与压缩率之间取得平衡。对于大文件且对速度敏感的场景，可选BEST_SPEED。

2.3 compressFile —— 压缩文件

// 异步回调方式zlib.compressFile(inFile:string,// 待压缩的文件或目录路径outFile:string,// 输出的 .zip 文件路径options:Options,// 压缩选项callback:AsyncCallback<void>):void;// Promise 方式zlib.compressFile(inFile:string,outFile:string,options:Options):Promise<void>;

2.4 decompressFile —— 解压文件

// 异步回调方式zlib.decompressFile(inFile:string,// .zip 压缩文件路径outFile:string,// 解压目标目录路径options:Options,// 解压选项callback:AsyncCallback<void>):void;// Promise 方式zlib.decompressFile(inFile:string,outFile:string,options:Options):Promise<void>;

三、实战示例：压缩与解压完整流程

3.1 场景说明

实现一个完整的文件操作链路：

1. 创建临时目录和测试文件
2. 将目录压缩为.zip文件
3. 将.zip文件解压到另一个目录
4. 验证解压结果

3.2 完整代码

importzlibfrom'@ohos.zlib';importfsfrom'@ohos.file.fs';import{BusinessError}from'@ohos.base';import{Context}from'@kit.AbilityKit';import{hilog}from'@kit.PerformanceAnalysisKit';constTAG='ZlibDemo';/** * 步骤一：创建测试文件 */functioncreateTestFile(filePath:string):void{letfile:fs.File|null=null;try{file=fs.openSync(filePath,fs.OpenMode.READ_WRITE|fs.OpenMode.CREATE);constcontent='Hello HarmonyOS! This is a zlib compression test file.';fs.writeSync(file.fd,content);hilog.info(0x0001,TAG,`文件创建成功:${filePath}`);}catch(err){hilog.error(0x0001,TAG,`创建文件失败:${(errasBusinessError).message}`);}finally{if(file!==null){fs.closeSync(file);}}}/** * 步骤二：压缩文件（回调方式） */functioncompressDemo(context:Context):void{constsourceDir=`${context.cacheDir}/demo_source`;constzipPath=`${context.cacheDir}/demo.zip`;// 确保源目录存在try{fs.mkdirSync(sourceDir);}catch(_e){// 目录已存在}// 创建测试文件createTestFile(`${sourceDir}/readme.txt`);createTestFile(`${sourceDir}/data.txt`);// 执行压缩constoptions:zlib.Options={level:zlib.CompressLevel.COMPRESS_LEVEL_DEFAULT_COMPRESSION,memLevel:zlib.MemLevel.MEM_LEVEL_DEFAULT,strategy:zlib.CompressStrategy.COMPRESS_STRATEGY_DEFAULT_STRATEGY};zlib.compressFile(sourceDir,zipPath,options,(err:BusinessError)=>{if(err!==null&&err.code!==0){hilog.error(0x0001,TAG,`压缩失败: code=${err.code}, msg=${err.message}`);return;}hilog.info(0x0001,TAG,`压缩成功，输出:${zipPath}`);});}/** * 步骤三：解压文件（Promise 方式） */asyncfunctiondecompressDemo(context:Context):Promise<void>{constzipPath=`${context.cacheDir}/demo.zip`;constextractDir=`${context.cacheDir}/demo_extracted`;constoptions:zlib.Options={level:zlib.CompressLevel.COMPRESS_LEVEL_DEFAULT_COMPRESSION};try{awaitzlib.decompressFile(zipPath,extractDir,options);hilog.info(0x0001,TAG,`解压成功，输出目录:${extractDir}`);}catch(err){constbizErr=errasBusinessError;hilog.error(0x0001,TAG,`解压失败: code=${bizErr.code}, msg=${bizErr.message}`);}}

3.3 调用入口

// 在页面的 aboutToAppear 或按钮点击中调用compressDemo(context);decompressDemo(context);

四、两种调用方式对比

推荐：优先使用 Promise 方式，配合async/await可使代码更清晰可读。

五、注意事项

5.1 路径规范

• inFile和outFile必须是应用沙箱路径（如context.cacheDir、context.filesDir）。
• 解压目标目录不需要预先创建，decompressFile会自动创建。

5.2 权限说明

@ohos.zlib操作的是应用沙箱内的文件，无需额外申请权限。

5.3 大文件处理

对于较大文件（>50MB），建议：

1. 将压缩/解压操作放在Worker 线程中执行，避免阻塞主线程。
2. 使用COMPRESS_LEVEL_BEST_SPEED提升压缩速度。
3. 关注内存占用，适当降低memLevel。

5.4 错误码

六、最佳实践总结

✅ 使用沙箱路径，确保数据安全 ✅ 大文件放 Worker 线程，保持 UI 流畅 ✅ 始终处理错误回调，避免静默失败 ✅ 操作完成后及时关闭文件描述符 ✅ 根据场景选择合适的压缩等级