Files
breeze/docs/fdroid.md
T
waozi 017d3565d3 Build on Ziran 0.5.0 and Kryon's namespaced widgets, with the Tao picture page
Pin only pushed commits, with no local overrides: Ziran v0.5.0
(f9f92b46), Kryon b45cc524 (one lock entry, ref master, shared with the
Css and Plot master edges), Apps 352901e, Entity b30dd4a and practices
893e5b6f, whose sharpened banners and regenerated Lumi guide clips the
narration check now matches.

The Library opens each Tao Te Ching chapter on its own picture page: the
chapter art and its title, centered together; the text pages follow.
The reader keeps the picture page across reflow, and a chapter start or
a Contents pick opens it. The 81 approved chapter pictures are included.

Breeze now uses Kryon's namespaced widgets (Text.Draw/Text.Props,
Button, Image, Modal.ActionModal, Layout, TabBar, LoadingScreen,
LoadingIndicator, Shape.Circle) instead of the removed Kryon/Widgets
facades. Hosted apps import std/text explicitly, since a short "text"
import now names Kryon's widget. AGENTS.md and the Text/Button API checks
describe the namespaced forms; two unused test doubles are removed.

Build fixes for the new toolchain: the bundle runtime carries Ziran's
instruction engine (no BOOTSTRAP=1) and takes the pinned host zi2c for
cross builds; the Apps controller's lock context has the manifest's
module roots; the app codec generator lists Kryon's raw modules only;
the package scripts read ZX revision 28 bundle assets. The Apps
controller digest matches the Apps 352901e build.

Also included: the stopped lanes' work in this tree (Radio download,
Photos install, Lists, Lumi, Habits shop rewards, astral exercise
selection, appearance and download recovery) and the raylib-free desktop
lane's host modules (app_trace, host_input, host_window, host_clock),
inactive unless DESKTOP_HOST is defined.

Not included: the crash-recovery lane's picture-window and storage
crash-safety changes, which that lane commits itself.

Local tests: zi-check (510 modules), native and Android source checks,
hosted app checks, build-laws, clean-text-api-check, button-api-check,
library-reader-test, library-ui-test, storage-crash-zi-test and
native-image-decode-test pass. The bundled Arcade is still ZX revision 26
and waits for an Arcade build on these pins.
2026-11-16 14:20:12 -03:00

67 lines
3.6 KiB
Markdown

# F-Droid builds
`F-Droid security and clean build` uses the official F-Droid buildserver
container, the recipe in `packaging/fdroid-build.json`, and the real
`fdroid build --scan-binary` command. It runs on pull requests, master pushes
and a daily schedule. It starts with an empty Ziran source cache, so an
unpublished or unreachable dependency pin fails even if other builders have
an older cached copy.
The generated metadata takes the full source commit, version and Android
versionCode from the current candidate. F-Droid performs its normal source
cleaning, signing-configuration removal, source scan, unsigned universal
release build, APK metadata validation and binary scan. No scanner error is
ignored. The job retains its APK, metadata and logs as `fdroid-unsigned`.
Before the release workflow can publish, `Verify F-Droid reproducibility`
checks the signed F-Droid APK against the allowed signing certificate, then
uses `apksigcopier compare --unsigned` to verify that its signature also
validates the independently rebuilt APK. A mismatch blocks publication.
These checks run without signing credentials. The ordinary Android release
job alone receives the signing key.
## The 2.1.34 failure
[fdroiddata!53430](https://gitlab.com/fdroid/fdroiddata/-/merge_requests/53430)
failed in [the dependency preparation step](https://gitlab.com/fdroid/checkupdates-bot-fdroiddata/-/jobs/17306590795).
Its OQS pin, `5cc7677b290f0448462410f7c7e85f518664b943`, was no longer
reachable from the repository's advertised history after a history rewrite.
A fresh clone failed with `fatal: unable to read tree`, before Gradle ran.
The current lock pins the replacement history. Never rewrite public package
history after an application has released a lock referring to it.
The clean scan also caught Tai Chi's animation data named `course.bin` as a
generic binary. Its `TCH2` data format now uses `course.tch`, including the
exporter, package and reader. No executable scanner rule or path is ignored.
A clean Gradle build also needs the shared Apps controller before native
compilation. Android's CMake tasks now depend on package preparation, so the
F-Droid build cannot accidentally rely on a bundle left by a desktop build.
The reviewed Apps controller now lives once in APK assets, beside the main
app package, rather than being embedded in every CPU library. The Android
asset reader retains each package independently across Activity replacement.
Archive checks require both shared packages.
The former 5.50 MB per-native-library budget was an Inbe regression guard,
not a F-Droid or Android requirement. It has been removed at the owner's
request. Overall artifact and DEX file-size ceilings have also been removed.
Shared-package structure, native libraries and R8 optimization remain checked.
Android release builds size-optimize static dependencies, discard unused
runtime sections, optimize across app modules, and safely merge identical code
and strings. All four architectures, artwork and scanner checks remain in place.
The upstream F-Droid entry must use the full commit of a successfully
published release and its corresponding `inbe-VERSION-fdroid.apk` binary.
A passing GitHub check does not mean F-Droid has merged or distributed that
release; verify its own pipeline and publication separately.
## Local verification
F-Droid resets and cleans the source checkout. Never run it against the
owner's real checkout. `scripts/check-fdroid.py` only accepts a disposable
Actions checkout or a private Podman overlay mounted at
`WORKSPACE/build/xyz.waozi.inbe`. It refuses an ordinary checkout before
running Git or modifying any files.