ZIPFoundation

开发框架 2.8k 419 Swift 上架 2026-11-08 在 GitHub 打开

ZIP Foundation 是一个专为 Swift 生态系统打造的高性能 ZIP 压缩文件处理库。它基于 Apple 原生的 libcompression 框架构建，能够在 iOS、macOS、t...

#手机/移动开发 #iOS代码库 #压缩、解压缩

项目信息

所有者: weichsel
Star: 2.8k
Fork: 419
开源协议: —
主要语言: Swift
发布时间: 2017-06-26
最近更新: 2026-09-12

项目更新

0.9.202025-09-24
这版主要补上非 Darwin 平台的短板：压缩包中的文件修改日期属性可以正常读取，路径字符串也支持 437 代码页解码，Windows 一类平台上遇到特殊字符路径不再出错。同时清掉几处资源隐患——Archive.makeBackingConfiguration 的资源泄漏、Data.readChunk 的内存泄漏，以及调试模式下的内存对齐崩溃。MemoryFile 与 ftello 相关操作的错误处理更细致，String 转 Data 改用非可选 API，隐私清单里的 API 类型 ID 也已修正。README 示例换成了非废弃写法，CI 与 lint 配置同步整理。
0.9.192024-04-03
本次更新集中修复了打包与合规层面的几处问题：修正了隐私清单（Privacy Manifest）文件，修复了包清单中触发的弃用警告，并更正了 podspec 里的资源打包说明。三处改动都不涉及功能变化，主要是让项目在新版 Xcode 与 CocoaPods 下能干净地通过校验，集成时不会再冒出警告或资源加载遗漏的问题，升级即可。
0.9.182024-01-27
这版主要堵住了一处路径逃逸漏洞：新增符号链接包含性校验，强制目标路径留在允许的目录内，防止通过构造软链接读写到预期之外的位置。同时修复了平台版本要求被误报为警告的问题，遇到权限错误时的报错信息也更具体，方便定位是哪一步拒绝了访问。升级后无需额外配置，软链接相关的访问行为会自动按更严格的规则校验。
0.9.172023-09-28
本版为库新增了 visionOS 平台支持，并补齐 Xcode 隐私清单，方便上架审核。Archive 现在提供抛出错误的初始化方法，初始化失败时能直接拿到异常，而不必再依赖后续操作间接暴露问题。另外还改进了符号链接的处理逻辑，以及底层错误的透传——遇到 IO 或权限类问题时，抛出的错误更贴近真实原因，排查起来更省事。
0.9.162022-12-07
这次小版本更新主要在 API 和文档两方面。Entry 新增了 isCompressed 访问器，方便开发者直接判断某个条目在压缩包中是否经过压缩，不必再自行解析相关标志位。另外更新了 README 和文档，把此前表述含糊的地方补齐；随机测试数据生成器中的一处过时用法也一并修掉了，避免在未来版本弃用后导致测试报错。整体属于维护性更新，没有破坏性变更，升级无需改动现有代码。
0.9.152022-09-20
ZipFoundation 这版开始支持 Android 构建，虽然还只是初步适配，但对需要跨平台打包的项目来说是个明确的信号：后续可以在 Android 侧直接复用这套压缩能力。另外修了两个 CRC32 相关的 bug——非最终压缩流的 CRC32 计算有误，以及通过 FileManager.unzipItem 解压时校验和判断不准确。后者影响更实际：之前用它解压某些文件可能会报校验失败或放过损坏数据，升级后校验结果才算可靠。如果你在 CI 上跑多轮压缩解压，建议尽快升到这一版。
0.9.142022-09-19
v1.0.1 修复了一个数据完整性问题：删除条目后，对应的 extra 字段数据会丢失。这次更新后，删除操作只清理目标条目本身，不会再连带清掉这些附加字段，已删除的数据也能正确保留或按预期清理。对依赖 extra 字段存储扩展信息的用户来说，此前的丢失可能造成数据缺口，升级后建议复查一下历史数据。
0.9.132021-12-01
本次更新新增了 ZIP64 支持，现在可以创建和读取超过 4GB 的大型压缩包，单个条目数也不再受限。同时修复了几个问题：计算条目总数时的 UInt16 溢出、内存中归档删除条目失效，以及归档替换过程中 fopen() 失败导致的崩溃。另外，若编译环境提供了 zlib，CRC32 计算会交由其处理，性能有明显提升。
0.9.122021-02-22
本次更新主要围绕稳定性与性能修复展开。写入侧新增了防护：只读归档中的条目不允许被删除，同时对传入零字节缓冲区的 API 误用做了拦截。读取侧修复了若干问题，包括计算中央目录记录末尾时 UInt16 溢出、解压所需 ZIP 版本号识别错误、零字节条目未触发 consumer 闭包，以及对 .symlink 和 .directory 条目错误套用 .deflate 压缩。另外，目录条目的识别更准确了，通过下标查找条目的性能有所提升，Swift 包描述中的 URL 格式也做了统一。
0.9.112020-03-26
本次更新为 ZIP 归档新增了内存中读写的支持，无需落盘即可创建与解析压缩包，对临时处理、测试场景尤其友好。同时修复了数个问题：(de)压缩过程中一处内存安全隐患，序列化 ZIP 内部结构到 Data 时的悬垂指针警告，经 CocoaPods 集成时缺少 Swift 5 语言版本声明，以及添加条目时 preferredEncoding 可选参数使用不一致的行为。压缩配置相关文档也做了补充，方便开发者正确选择参数。