Skip to content

Say why bundles are still unlocked, which is not the reason written down - #116

Merged
parawanderer merged 1 commit into
mainfrom
docs/locked-zip-is-a-release-gap
Aug 19, 2026
Merged

Say why bundles are still unlocked, which is not the reason written down#116
parawanderer merged 1 commit into
mainfrom
docs/locked-zip-is-a-release-gap

Conversation

@parawanderer

Copy link
Copy Markdown
Owner

Two comments claimed nothing can open a locked bundle. That is no longer true, and the way it is false matters — because the obvious next step from the old wording is to switch locking on, which would break things for users.

What is actually true

The app on main reads locked bundles — zip4j is in app/build.gradle.kts and AppleZipImporterUtil uses it
Newest Android release 1.0.5, from 2026-08-09, before that work
versionName on main still 1.0.5 — the import support is unreleased and has no version number

So the constraint is release ordering, not a missing feature. Locking bundles now would produce files that no installed app can open, and it lands hardest on recipients — who did not choose the exporter's version and cannot fix it from their side.

What changed

Only comments and one --help string. No behaviour.

Both now name the condition that unblocks this — an Android release containing zip4j — rather than describing a capability that already exists. Once one ships, this becomes a decision about how long to support the versions before it, which is a real decision rather than a TODO.

Checked and left alone

  • The CLI guide's --no-password row already says "Required for any released version of the app", which is exactly right.
  • docs/android-import-handover.md §3 is already marked done and documents the zip4j work.

PR description summarised by Claude Code.

Both places claimed nothing can open a locked bundle. The app on main can - zip4j is in
app/build.gradle.kts and AppleZipImporterUtil uses it - so the comment reads as a stale note
about a missing feature, and the obvious next step is to turn locking on.

That would be wrong, and the real constraint is release ordering. The newest Android release is
1.0.5, from before that work, and versionName has not moved past it: no *installed* app can open
a locked bundle. Locking now produces files nobody can import, and it lands hardest on
recipients, who did not choose the exporter's version and cannot fix it from their side.

So the comment now names the condition that unblocks it - an Android release containing zip4j -
rather than a capability that already exists. docs/android-import-handover.md §3 is already
marked done and needs nothing.
@parawanderer
parawanderer merged commit da789e4 into main Aug 19, 2026
5 checks passed
@parawanderer
parawanderer deleted the docs/locked-zip-is-a-release-gap branch August 19, 2026 19:08
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant