release_kit 0.1.31

Flutter release toolkit - automatic version bump + multi-platform packaging with a unified config.

Changelog

0.1.31

• Fix: --installer flag was documented and normalized but never parsed/forwarded by the CLI, so release-kit publish windows --installer silently skipped the Inno Setup build. The flag is now wired through both lib/src/cli.dart and release-kit.ps1.

0.1.30

• Feature: Windows --installer flag. Generates a proper .exe installer via Inno Setup (desktop shortcut, Start Menu group, uninstaller). Requires Inno Setup installed (iscc.exe in PATH or C:\Program Files (x86)\Inno Setup 6). Config keys: windows.installerPublisher, windows.installerPrivileges.

0.1.29

• Docs: added full macOS publishing workflow to GUIDE.md / GUIDE.zh.md (prerequisites, one-time setup, sandbox decision, step-by-step flow). README now links to the macOS guide and lists the new --no-codesign / --no-notarize / --notarize flags.

0.1.28

• Fix: macOS Developer ID re-signing now preserves entitlements (uses macos/Runner/Release.entitlements when present, otherwise extracts what flutter build embedded). Previously re-signing without --entitlements silently dropped app-sandbox/network.client/etc.
• Fix: macOS signing is now inside-out (nested frameworks/dylibs first, then the app bundle) instead of codesign --deep, which Apple recommends against.

0.1.27

• Feature: macOS publish now supports distribution outside the Mac App Store via Developer ID. publish_macos.sh signs the .app with a Developer ID Application identity + hardened runtime (codesign --options runtime), notarizes it (xcrun notarytool), staples the ticket, and packages a notarized drag-to-install .dmg plus an auto-update .zip. Notarization credentials come from env vars (APPLE_NOTARY_PROFILE, or APPLE_ID + APPLE_TEAM_ID + APPLE_APP_SPECIFIC_PASSWORD); the signing identity is read from macos.signIdentity or auto-detected from the keychain. New flags: --no-codesign, --no-notarize, --notarize.

0.1.26

• Fix: Windows publish could fail with Remove-Item ... CascadiaMonoPL.ttf ... access is denied when a previous publish's smoke test (or a manually launched copy) left the collected ZShell.exe running, holding the font file open. Before clearing the output dir, release-kit now stops any process still running from that dir (matched by executable path). The smoke test also kills the full process tree (taskkill /T /F) for reliability.

0.1.25

• Change: in Windows --clean-flutter, plugin DLLs moved into lib\ now keep a readable name by stripping the trailing _plugin suffix instead of truncating the tail (desktop_drop_plugin.dll → lib\desktop_drop.dll, window_manager_plugin.dll → lib\window_manager.dll). Truncation is still used only as a fallback when stripping doesn't fit the import-table reference or collides.
• Fix: --clean-flutter no longer renames package asset paths. The compiled app ships the original strings (packages/lucide_icons_flutter, AssetManifest.bin, FontManifest.json), so renaming them broke runtime asset/font loading (e.g. lucide icons not rendering). Package assets are now left at their original values; only safe text/licensing metadata (NOTICES, NOTICES.Z) is scrubbed. The text scrub also skips occurrences that are asset path segments.

0.1.24

• Fix: in Windows --clean-flutter, the AssetManifest.bin rebuild (introduced in 0.1.23) failed at runtime ("decode consumed 6119/0") because a nested function referenced the original $sb variable (renamed to $bytes) and used a local $rd/$rd.p instead of the script-scoped $script:rd. The StandardMessageCodec helpers are now defined at script scope (no nested function definitions) and use $script:rd/$script:wb consistently. This also removes the PowerShell-5.1 nested-function definitions that could corrupt subsequent cmdlet resolution in the same run.

0.1.23

• BREAKING CHANGE in --clean-flutter package-asset scrub: package directories/files now get readable names (flutter→bundle, dart→kit), e.g. packages\lucide_icons_flutter → packages\lucide_icons_bundle. AssetManifest.bin is fully re-encoded (Flutter StandardMessageCodec decoder/encoder with correct length prefixes) instead of the previous fragile equal-length byte patch, so paths stay valid even when the renamed word changes length. FontManifest.json and all other text metadata also use the readable bundle/kit tokens.

0.1.22

• Fix: the binary manifest patch in --clean-flutter now uses a same-length token for the dart brand (dart -> drrt, matching the text/rename scrub) so AssetManifest.bin references stay byte-consistent with the renamed on-disk package paths for any package (e.g. packages\net_flutter -> packages\net_fluttr, packages\my_dart_kit -> packages\my_drrt_kit). Also applies to the Dart/DART and all-caps FLUTTER case variants.

0.1.21

• Windows --clean-flutter now scrubs flutter/dart that leak into package asset paths under data\resources: folders/files whose names contain the brand words (e.g. packages\lucide_icons_flutter) are renamed with the same length-preserving transform (...fluttr, ...drrt), and the binary AssetManifest.bin is equal-length patched so the manifests (FontManifest.json, AssetManifest.bin) and the filesystem stay consistent. Runtime binaries and asset media are still untouched.

0.1.20

• Windows --clean-flutter now also scrubs flutter/dart branding from the licensing resources in data\resources that were previously missed: the extension-less NOTICES and the gzip-compressed NOTICES.Z (decompressed, scrubbed, recompressed in place). Runtime binaries (AOT kernel, icudtl.dat, asset media) are detected by the presence of NUL/control bytes and left untouched.

0.1.19

• Windows --clean-flutter now also:
  • reorganizes every *.dll into a lib\ subfolder, repointing all references (exe + plugin DLLs) to lib\xxx.dll via a length-aware, overflow-safe patch (names are shortened automatically so they always fit; the exe stays runnable)
  • scrubs flutter / dart branding from the text metadata under data\resources (equal-length neutral replacement; binary blobs like the AOT kernel are left untouched)

0.1.18

• Fix .deb/.rpm packages shipping only the launcher binary (missing lib/ + data/, so the installed app could not run). They now bundle the full release bundle under /usr/lib/<id>/ and expose the binary via a /usr/bin symlink.

0.1.17

• Fix --appimage: linuxdeploy requires a .desktop file and an AppRun inside the AppDir, but the raw Flutter bundle has neither, so AppImage packaging failed with Desktop file not found. The AppImage path now stages the bundle, injects the desktop entry + AppRun (the binary stays at the AppDir root so it can still locate lib//data/), bundles the icon, and copies the resulting .AppImage to dist/.

0.1.16

• Linux publish now always emits a portable .zip (dist/<app>-<version>+<build>-linux.zip, single top-level <app>/ dir) as the default artifact — the same shape the Windows/macOS packs and in-app auto-update use. The previous .tar.gz default is removed; --deb / --rpm / --appimage still produce the distro install packages on top of the zip.

0.1.15

• Fix garbled non-ASCII text in the generated dist/CHANGELOG-<version>+<build>.md on Windows: read the project CHANGELOG.md as UTF-8, decode git log output as UTF-8, and write the result as UTF-8 without BOM.

0.1.14

• Every publish now emits a standard, versioned changelog alongside the artifacts: dist/CHANGELOG-<version>+<build>.md. The content is extracted from the project's CHANGELOG.md (the Keep-a-Changelog section matching the current version); when there is no CHANGELOG.md (or no section for the version), it falls back to grouping the git log since the last tag by conventional-commit type (feat: → Added, fix: → Fixed, everything else → Changed).

0.1.13

• macOS and Linux package filenames now include the build number, matching the Windows convention: dist/<app>-<version>+<build>-macos.dmg / .zip, dist/<app>-<version>+<build>-linux-x64.tar.gz / .deb / .rpm (e.g. ZShell-1.41.2+79-macos.zip). read_version now also exports VERSION_FULL (x.y.z+build).

0.1.12

• Windows installer zip now includes the build number: dist/<app>-<version>+<build>-win64.zip (e.g. ZShell-1.41.2+79-win64.zip).

0.1.11

• macOS publish now also emits an auto-update .zip next to the .dmg, built from the very same signed .app (ditto -c -k --sequesterRsrc --keepParent keeps <AppName>.app as the sole top-level entry so in-app updaters that strip one directory can replace the running app's Contents). Output: dist/<app>-<version>-macos.dmg + dist/<app>-<version>-macos.zip.

0.1.10

• Every publish build now auto-injects --dart-define=APP_VERSION=<x.y.z> and --dart-define=APP_BUILD=<build> from pubspec.yaml (all platforms: Windows, Android, macOS, Linux, iOS). Apps can show their real version at runtime via String.fromEnvironment('APP_VERSION') / ('APP_BUILD'); an explicit build.dartDefine.APP_VERSION/APP_BUILD overrides the auto value.

0.1.9

• publish <platform> flag matching is now case/hyphen tolerant: --CleanFlutter, --SKIP_BUILD etc. are accepted and mapped to their canonical form (--clean-flutter, --skip-build) on every entry point (Dart CLI, release-kit.ps1, publish_windows.ps1).

0.1.8

• Fix release_kit publish windows: the Dart CLI invoked publish_windows.ps1 with -Obfuscate:true style switches, which PowerShell -File cannot bind (error: Cannot process argument transformation on parameter 'Obfuscate'). It now passes bare double-dash flags (--obfuscate, --clean-flutter, ...), which bind correctly.

0.1.7

• All publish <platform> flags now use the same double-dash long-flag spelling on every platform (--obfuscate, --skip-build, --no-rename, --harden, --clean-flutter, --skip-verify, --output-dir). The old Windows single-dash spellings (-Obfuscate etc.) are no longer accepted.

0.1.6

• Docs: detailed per-flag reference for every platform in GUIDE (common flags -p/--no-icons + windows/android/ios/macos/linux tables).

0.1.5

• Docs: add pub.dev badge/link to README; document release-kit bump and Windows -NoRename in README/GUIDE.

0.1.4

• Linux publish implemented end-to-end: --obfuscate, --deb (dpkg-deb), --rpm (rpmbuild), --appimage; desktop entry + hi-color icon from linux/runner/my_icon.png; linux.desktopCategories config key.
• Linux window icon generation: resize app.logo → linux/runner/my_icon.png (ImageMagick when available).
• Smoke test for the Linux path: test/publish_linux_test.sh.

0.1.3

• Fix iOS/macOS flag parsing infinite loop (missing shift).
• iOS --no-codesign: collect the .xcarchive (Flutter skips .ipa generation when unsigned).
• macOS: drop the unsupported --no-codesign flag.
• Verified iOS and macOS publishing on a real macOS host.

0.1.2

• iOS publish: add --obfuscate, --export-method, --no-codesign; robust .ipa discovery.
• macOS publish: add --obfuscate, --no-codesign; robust .app discovery.
• Docs: document iOS/macOS flags in README and GUIDE.

0.1.1

• Docs: restructure README and add an English usage guide (docs/GUIDE.md); make pub.dev install the primary quick start, with git-clone as an alternative.

0.1.0

• Initial release as a Dart CLI package.
• release-kit init — copy the config template + install the pre-commit hook.
• release-kit publish <platform> — build & package (windows / android / macos / linux / ios).
• release-kit bump — auto-increment the version in pubspec.yaml from staged changes.