YStudio Y++

ZIP支持库全套用法:压缩解压、追加目录、加密、读条目与删条目

Y++ / YStudio 开发文档 · 一点滴


slug: s2-02-zip title: ZIP支持库全套用法:压缩解压、追加目录、加密、读条目与删条目 summary: 覆盖 ZIP_ 前缀主要命令:压缩到ZIP、解压ZIP/单文件、添加文件目录字节集、删除条目、取列表与信息、是否加密、读文本/字节集,以及两种密码加密方式。 tags: ZIP支持库,压缩,解压,AES,条目 series: supportlib-s2 series_order: 2 type: tutorial


ZIP支持库全套用法:压缩解压、追加目录、加密、读条目与删条目

面板:支持库 → ZIP支持库 → ZIP压缩。命令统一前缀 ZIP_,扁平调用。

硬约束

  1. 包内路径一律用 /,不要用 \。
  2. 密码非空默认 AES-256(加密方式=2);ZipCrypto 用 1。
  3. ZIP_压缩到ZIP 第 2 参可省略:写成 源,, 递归, 密码(中间留空)。
  4. 带密码的追加/删除会重建压缩包。
  5. 压缩级别:-1 默认,0 仅存储,1..9 deflate。
  6. 失败立刻看 ZIP_取最后错误()。
  7. ZIP_解压ZIP 会拒绝含 .. / 绝对路径的恶意条目。

窗口:按钮演示 编辑框日志(多行编辑框即可)

文本 g_根 = ""
文本 g_包 = ""
文本 g_出 = ""

函数 写日志(文本 s) {
    编辑框日志.文本 = 编辑框日志.文本 + s + 换行符
}

函数 主窗口.创建完毕() {
    g_根 = 取临时目录() + "\\ypp_zip_demo"
    g_包 = g_根 + "\\demo.zip"
    g_出 = g_根 + "\\out"
    如果 (路径存在(g_根) == 假) {
        创建目录(g_根)
    }
    写文件(g_根 + "\\a.txt", "第一行")
    写文件(g_根 + "\\b.txt", "第二行")
    创建目录(g_根 + "\\sub")
    写文件(g_根 + "\\sub\\c.txt", "子目录")
    编辑框日志.文本 = "演示目录:" + g_根
}

函数 按钮演示.单击(整数 X, 整数 Y) {
    编辑框日志.文本 = ""

    // ——— 1) 整目录压缩(可省略 zip 路径;这里指定路径)———
    // 写法 A:无密码
    如果 (ZIP_压缩到ZIP(g_根 + "\\a.txt", g_包) == 假) {
        写日志("压缩失败:" + ZIP_取最后错误())
        返回 ()
    }
    写日志("已压单文件 → " + g_包)

    // 写法 B:目录 + 递归 + 密码 AES(加密方式默认 2)
    文本 加密包 = g_根 + "\\enc.zip"
    如果 (ZIP_压缩到ZIP(g_根, 加密包, 真, "123456", 2, -1) == 假) {
        写日志("加密压缩失败:" + ZIP_取最后错误())
    } 否则 {
        写日志("加密目录包:" + 加密包 + " 是否加密=" + 到文本(ZIP_是否加密(加密包)))
    }

    // 写法 C:省略 zip 路径(自动生成在源旁)
    // ZIP_压缩到ZIP(g_根 + "\\b.txt",, 真)

    // ——— 2) 追加:文件 / 目录 / 字节集 ———
    如果 (ZIP_添加文件(g_包, g_根 + "\\b.txt", "docs/b.txt") == 假) {
        写日志("添加文件失败:" + ZIP_取最后错误())
    } 否则 {
        写日志("已追加 docs/b.txt")
    }
    如果 (ZIP_添加目录(g_包, g_根 + "\\sub", "sub", 真) == 假) {
        写日志("添加目录失败:" + ZIP_取最后错误())
    } 否则 {
        写日志("已追加目录 sub/")
    }
    字节集 raw = 到字节集("from-bytes")
    如果 (ZIP_添加字节集(g_包, raw, "mem/payload.bin") == 假) {
        写日志("添加字节集失败:" + ZIP_取最后错误())
    } 否则 {
        写日志("已追加 mem/payload.bin")
    }

    // ——— 3) 查询条目 ———
    写日志("条目数=" + 到文本(ZIP_取条目数(g_包)))
    文本 列表[] = ZIP_取条目列表(g_包)
    文本 项 = ""
    遍历 (项, 列表) {
        写日志("· " + 项)
        如果 (ZIP_条目是否存在(g_包, 项)) {
            写日志("  信息:" + ZIP_取条目信息(g_包, 项))
        }
    }

    // ——— 4) 直接读包内(不解压整包)———
    文本 t = ZIP_读文本(g_包, "docs/b.txt")
    写日志("读文本 docs/b.txt => " + t)
    字节集 bb = ZIP_读字节集(g_包, "mem/payload.bin")
    写日志("读字节集长度=" + 到文本(字节集长度(bb)))

    // ——— 5) 解压:整包 / 单文件 ———
    如果 (路径存在(g_出)) {
        删除目录(g_出, 真)
    }
    创建目录(g_出)
    如果 (ZIP_解压ZIP(g_包, g_出, 真) == 假) {
        写日志("整包解压失败:" + ZIP_取最后错误())
    } 否则 {
        写日志("整包已解到 " + g_出)
    }
    文本 单出 = g_出 + "\\only-b.txt"
    如果 (ZIP_解压文件(g_包, "docs/b.txt", 单出, 真) == 假) {
        写日志("单文件解压失败:" + ZIP_取最后错误())
    } 否则 {
        写日志("单文件解压 => " + 单出)
    }

    // 加密包解压必须带密码
    文本 加密出 = g_根 + "\\out_enc"
    如果 (路径存在(加密出) == 假) {
        创建目录(加密出)
    }
    如果 (ZIP_解压ZIP(加密包, 加密出, 真, "123456") == 假) {
        写日志("加密包解压失败:" + ZIP_取最后错误())
    } 否则 {
        写日志("加密包已解到 " + 加密出)
    }

    // ——— 6) 删除条目 ———
    如果 (ZIP_删除条目(g_包, "mem/payload.bin") == 假) {
        写日志("删条目失败:" + ZIP_取最后错误())
    } 否则 {
        写日志("已删除 mem/payload.bin,剩余条目=" + 到文本(ZIP_取条目数(g_包)))
    }

    写日志("—— 演示结束 ——")
}

命令速查(本篇都用到了)

命令 作用
ZIP_压缩到ZIP 文件/目录打成包;可省略路径、可加密
ZIP_解压ZIP 整包解出
ZIP_解压文件 只解一个包内文件
ZIP_添加文件 / ZIP_添加目录 / ZIP_添加字节集 追加
ZIP_删除条目 删包内路径(重建包)
ZIP_取条目列表 / ZIP_取条目数 / ZIP_取条目信息 查询
ZIP_条目是否存在 / ZIP_是否加密 判断
ZIP_读文本 / ZIP_读字节集 不解压直接读
ZIP_取最后错误 失败原因

对照:ZIP支持库