Skip to content

app-builder 1.6.0

Choose a tag to compare

@heetbeet heetbeet released this 07 Aug 10:25
c7dfafb

app-builder 1.6.0

app-builder 1.6.0 is a backward-compatible feature release focused on smoother Windows distribution and more predictable repeated builds.

What is new

Shortcut icons travel with the application

Start Menu shortcuts can inherit installer.icon without repeating the path in every shortcut. app-builder now includes that icon automatically in the payload, follows file remaps correctly, and leaves Windows to choose its normal fallback when no icon is configured.

Reusable, configurable caches

Python.org runtimes and ExeWrap downloads now use a concurrency-safe, user-level cache with digest validation and atomic promotion. Managed version checkouts share the same cache contract, while pip and Poetry retain their native defaults unless you configure them.

Use the new diagnostics to see the effective paths:

app-builder cache path
app-builder cache info

Set APP_BUILDER_CACHE_ROOT to relocate app-builder-owned caches. Existing explicit pip and Poetry cache environment variables remain authoritative.

Clear end-user installation guidance

The shipped help now describes the supported Windows installer flow, PATH behavior, upgrades, verification, Windows Installed Apps registration, and removal. Editable pip installation remains documented as a development workflow rather than the normal way to install app-builder.

Install or upgrade

Download and run app-builder-1.6.0-installer.exe. It installs per-user without requiring a separate Python installation and upgrades an existing app-builder installation in place.

For unattended installation:

.\app-builder-1.6.0-installer.exe --yes --no-wait

Verify afterward with:

app-builder --version
app-builder --help

Compatibility

This release retains the explicit app-builder 0.x compatibility bridge and the 0.x runner-forwarding support introduced in 1.5.0. Existing 1.x configurations remain valid.

Validation

  • 215 local tests
  • Black and MyPy clean
  • GitHub Actions on Python 3.11, 3.12, and 3.13
  • Windows CI builds, installs, exercises, and uninstalls a real installer
  • Local upgrade from installed 1.4.0 to 1.6.0
  • Same-version reinstall
  • Exact published installer digest installed successfully
  • Installed CLI, HTML help, cache commands, PATH entry, and Windows Installed Apps registration verified

Built from commit c7dfafbfa79529605bc942dd9bb7dcaf17a81945.

Assets

  • app-builder-1.6.0-installer.exe: standard Windows installer
  • app-builder-1.6.0.7z: payload archive
  • app-builder-1.6.0-manifest.json: complete installed-file manifest
  • app-builder-1.6.0-SHA256SUMS.txt: checksums for the published artifacts

Full changes: 1.5.0...1.6.0