πRelease log
π2026-11-20 β v2.0.0 capability expansion (unreleased)β
These changes are merged to the main branch of the GeneralZip repository (PR #1, PR #2); the component version has moved to 2.0.0 but no release tag has been cut yet β the NuGet version will be noted here once published.
- Implicit bootstrap (breaking refactor): the Rust native core is now assembled automatically when
GeneralZipFormatRegistry.Defaultis first constructed β the core is loaded, 7z/RAR providers are registered per capability bits, and the native codec delegates are injected; custom registries are covered by the codec router'sEnsureBridge()fallback.GeneralZip.Initialize()andGeneralZipNative.Initialize()have been removed β useNativeCoreLoader.TryLoad()to probe core availability - One-line archive operations: the facade gains
Append/AppendAsync(append entries to an existing ZIP archive),Remove/RemoveAsync(delete entries by name) andConvert/ConvertAsync(cross-format conversion) β readβrewrite semantics; converting an encrypted archive automatically inherits its algorithm and password, never silently producing a plaintext output - Stream-to-stream overloads:
Compress/Extract/Testgain StreamβStream overloads β compress, extract, and integrity-test memory/network streams without touching disk - Glob entry filters: extraction gains
ExtractionOptions.IncludePatterns/ExcludePatterns(**cross-layer matching, character classes); exclude patterns win over include patterns - ZIP extended compression methods:
ArchiveWriteOptions.ZipCompressionMethodadds BZip2 (method 12) / Zstd (method 93) / LZMA (method 14, method-14 EOPM framing), interoperable with 7-Zip / Info-ZIP; defaultAuto(Deflate) - Streaming native codecs: the Rust core was rewritten to a callback push-pull FFI (
gzp_codec_crun/drun) β bzip2/xz/zstd/lz4/brotli all transcode with zero temp files, removing the v1 "one-shot zstd API" and "temp-file full-segment transcoding" limitations - Parallel compress/extract: write-side staged parallel compression and read-side per-worker archive reopen with a lock-serialized event relay, controlled by
ArchiveWriteOptions.MaxDegreeOfParallelism/ExtractionOptions.MaxDegreeOfParallelism(default 1 = serial, behavior unchanged) - Async enumeration:
GeneralZipAsyncExtensions.EnumerateEntriesAsync(IAsyncEnumerable<IArchiveEntry>) andExtractEntryAsync - SM2 national-crypto envelope encryption: pure C# SM2 implementation (GB/T 32918.5 curve, ECIES C1-C3-C2), cross-validated against python gmssl in both directions with an interop anchor vector;
Sm2GmProvider(AlgorithmId"SM2-GM", extra field 0x4D54) generates a random per-entry data key sealed with the recipient's SM2 public key β a passwordless write path (IPasswordlessWriteProvider, private key delivered via the password pipeline); passArchiveWriteOptions.RecipientPublicKeyand encrypt - Pluggable KDF registry: new
IKdfProviderabstraction andArchiveWriteOptions.KdfAlgorithmIdswitch with built-in SM3-PBKDF2 (SpecId 1, default) and PBKDF2-SHA256 (SpecId 2); the SM4-GM container carries the SpecId in its extra field, keeping old archives readable - New formats: CPIO (newc/odc/binary read, newc write, fully managed), ISO9660 (read-only, +Joliet/Rock Ridge), CAB (read-only, NONE-stored folders; MSZIP/LZX explicitly unsupported), Brotli (read/write, native core)
- Split-volume ZIP:
ArchiveWriteOptions.VolumeSizesplits output into.001/.002/β¦volumes; opening.001auto-concatenates the remaining volumes - Unix attributes & symlinks: new
IUnixEntry(ZIP Unix host / ustar mode) and symlink writing (ZIPS_IFLNK/ TAR typeflag 2), withSymlinkPolicy(default Skip, security first) andPreserveUnixAttributesto keep mode bits on extraction - Command-line tool: new
GeneralZip.Cli(dotnet global tool, command namegz) βacompress /xextract /tintegrity test /llist /cconvert /rmremove entries /iinfo /detectformat detection /keygenSM2 keypair generation - Release matrix expansion: the native core build matrix grows from 5 RIDs to 8 (adds linux-arm64 / win-arm64 / win-x86)
- Robustness: new SharpFuzz fuzzing harness and
RobustnessTestsregression (random/truncated/bit-flipped inputs never crash the reader); interop fixtures generated by independent implementations (py7zr, pycdlib, python zipfile, GNU cpio newc) as read-side compatibility anchors - Fix:
NativeTempDecodeStreamno longer drains and disposes the caller's source stream in its constructor (fixesObjectDisposedExceptionon non-seekable TAR.BZ2 roundtrips); transcode callback exceptions are rethrown viaExceptionDispatchInfo, preserving the original stack - Fix: ZIP entry names/comments without the UTF-8 flag now decode as IBM437 per the APPNOTE convention β the previous implementation fell back to UTF-8, so legacy GBK/CP437 archive names decoded to U+FFFD garbage; implemented with a built-in 256-entry CP437 single-byte table, zero third-party dependencies, AOT compatible
- Docs: the component reference (zh/en) was updated in sync β format matrix, encryption guide, and feature list β and this release log page was added
π2026-11-02 β v0.0.1-beta (first public preview)β
- Single-package architecture:
GeneralZip.Nativemerged into theGeneralZippackage, bundling prebuilt Rust native cores for five platforms (win-x64 / linux-x64 / linux-musl-x64 / osx-x64 / osx-arm64) β loaded automatically on first use, graceful degradation when missing - Cross-format compression engine: unified API with magic-byte detection across ZIP, 7z, RAR, TAR, GZ, BZ2, XZ, Zstd, and LZ4; three encryption schemes (ZipCrypto / WinZip AES / SM4-GM), with SM3/SM4/TAR/CRC32 as pure C# implementations locked by GB/T standard vectors
- Engineering: CI + Release pipelines (RID build matrix, NuGet/snupkg publish smoke tests), all runtime messages translated to English, cross-platform deterministic fixture anchors, READMEs rewritten after mainstream OSS conventions, 73 tests (standard vectors + interop oracle + events + fixtures)