ObliviOS Developer portal Project site

Home / Decisions / ADR-219

Do not ship the upstream GrapheneOS boot animation zip.

Proposed, recorded 5 November 2026.

Decision
ADR-219
Date
2026-11-05
Status
ProposedProposed (owner, 2026-11-05 chat: the boot screen of lynx 2026110501 is the GrapheneOS one and must be fixed). Accepted when a lynx image with the patch has no /product/media/bootanimation.zip and passes BOOT-009.
Mentions
ADR-152, ADR-156
Mentioned by
ADR-227, ADR-249

1Decision

Do not ship the upstream GrapheneOS boot animation zip. Patch build-make/0001 of the package branding/boot removes bootanimation_zip from PRODUCT_PACKAGES (build/make target/product/base_product.mk) and from the generic filesystem module list (target/product/generic/Android.bp), so the animation service falls back to the textures of framework-res.apk and the boot picture of ADR-152 shows again. The patch layer gains one project, build/make, 19 in all. ADR-152 and ADR-156 stay as decided; this restores their effect on tag 2026110200.

2Why and evidence

Tag 2026110200 adds the upstream project branding and installs its bootanimation_zip into every product (build/make 90e8e1d7f2, 2026-10-09). BootAnimation.cpp plays /product/media/bootanimation.zip before the textures, so the two PNGs of ADR-152 were in the image and never drawn [measured: replay on the flashed image, window pixels black; with the directory hidden the track and segment of ADR-156 show, see BOOT-009].

Rejected: replacing the zip with a FreeholdOS zip (a second picture to author, test and keep in step with the renderer one, against the approved design); a filter-out in the vendor product file (inherited package lists are not reliably reduced from a child file [assumption]).

3Consequences

Patch build-make/0001 landed on build/make branch freeholdos-2026110200 (b965238b6d), package check OK, not built. The lists of rebase-branches.sh, switch-branches.sh and package-check-all.sh name build/make. The emulator products lose the upstream animation as well.

4Review when

Upstream changes the lookup order or draws its logo from the textures; a later tag changes base_product.mk so the patch no longer applies; a stock animation is wanted again on a device.

Read from docs/governance/decision-log.md, entry ADR-219.