aardio 文档

zlib.httpFile.verifiedZip 库模块帮助文档

可信 ZIP 完整解压

zlib.httpFile.verifiedZip 成员列表 #

可信 SHA256 ZIP 落盘校验与完整流式解压;不负责运行时选择、环境激活或安装提交。导入不下载。

zlib.httpFile.verifiedZip.extract(url,sha256,extractDir,options) #

显式需要归档校验时使用:下载到缓存并核对调用者提供的SHA256,再流式解压。extractDir必须不存在;失败可能留下部分目录,由调用方清理。返回 {dir;archivePath;sha256;files;bytes} 或 null,err,kind。
options.archivePath、rootName(单层归档根目录)必填;根目录内容直接解到extractDir。可选finalDir预检最终路径、stop()、onProgress(received,total)。严格使用传入URL,不选择镜像或限定发行来源。
只校验ZIP归档,不对安装后的文件建立hash清单或检查升级;不是所有下载的必经入口,普通下载继续使用zlib.httpFile.download。保留ZIP本身的长度/CRC/写入错误检查;不是不可信归档沙箱。

Markdown 格式