Skip to content

packaging(flatpak): CI build/validate check + Flathub auto-update prep#372

Closed
adibhanna wants to merge 3 commits into
mainfrom
packaging/flatpak-flathub-prep
Closed

packaging(flatpak): CI build/validate check + Flathub auto-update prep#372
adibhanna wants to merge 3 commits into
mainfrom
packaging/flatpak-flathub-prep

Conversation

@adibhanna

Copy link
Copy Markdown
Contributor

What

Prep so ZenNotes can be published to Flathub and verified without a Linux machine.

  • New .github/workflows/flatpak-check.yml — mirrors aur-check.yml. Validates AppStream metainfo (appstreamcli validate) and the desktop entry on every change, and runs a full flatpak-builder against the freedesktop 25.08 runtime once the release AppImage is published (skips the build, like the AUR check, when the asset isn't up yet).
  • x-checker-data on the manifest — Flathub's flatpak-external-data-checker will auto-open url/sha256 bump PRs on each GitHub release.
  • README — real org.zennotes.ZenNotes Flathub submission steps; dropped the stale com.adibhanna app-id note (the id maps to zennotes.org, which we own).

Verified locally

  • AppImage sha256 in the manifest matches the published v2.13.1 x86_64 asset.
  • metainfo XML well-formed; manifest + workflow YAML parse.

Full Linux flatpak-builder runs in the new CI job on this PR.

Add .github/workflows/flatpak-check.yml, mirroring aur-check.yml: it runs
appstreamcli + desktop-file-validate on every change and a full
flatpak-builder against the freedesktop 25.08 runtime once the release
AppImage is published, so the package is verified without a Linux box.

Add x-checker-data (GitHub releases JSON query) to the manifest so
Flathub's flatpak-external-data-checker auto-opens url/sha256 bump PRs
on each release. Rewrite the README's publishing section with the real
org.zennotes.ZenNotes submission steps and drop the stale com.adibhanna
app-id note (the id maps to zennotes.org, which we own).
Flathub's flatpak-builder-lint rejects broad --filesystem=home
(finish-args-home-filesystem-access), which failed the submission's
manifest validation. Grant xdg-documents/xdg-download/xdg-desktop
instead; vaults kept elsewhere can be re-granted via Flatseal.
Flathub builds x86_64 AND aarch64; the manifest hardcoded the x64
AppImage, so the arm build failed with 'Exec format error'. Split into
only-arches x86_64/aarch64 sources pointing at the x64 and arm64
AppImages (both already shipped in each release), each with its own
x-checker-data.
@adibhanna

Copy link
Copy Markdown
Contributor Author

Closing — we've decided not to ship on Flathub, and Flatpak packaging has been removed entirely (see main). Linux stays covered by the GitHub installers, AUR, Nix, and Docker.

@adibhanna adibhanna closed this Jul 11, 2026
@adibhanna
adibhanna deleted the packaging/flatpak-flathub-prep branch July 11, 2026 01:57
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