flutpak 0.2.0

CLI tool that generates Flatpak manifests and offline source bundles for Flutter applications. One command prepares everything needed for a Flathub-compatible offline build: generated-sources.json, ma [...]

Changelog

All notable changes to this project will be documented in this file.

The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.

Unreleased

0.2.0 - 2026-05-19

Added

• lint command — flatpak-builder-lint wrapper (requires org.flatpak.Builder)
• export command — collects manifest, generated-sources.json, metainfo, and patches into a ready-to-submit directory
• validate command — appstream-util validate wrapper for AppStream metainfo
• Metainfo XML generation from manifest.metainfo: config (name, summary, description, categories, keywords, URLs, screenshots, OARS content rating)
• .desktop file generation from manifest.desktop: config
• prepare --dry-run / -n — prints what would be written without touching any files
• pin-manifest composite action: flutter_version / flutter_version_file inputs (one required), config, validate, flutpak_binary
• test-action.yml — CI workflow that builds the binary from source and smoke-tests the action

Changed

• output: config field is now a directory (default: flatpak); generated-sources.json is always written as <output>/generated-sources.json
• --output CLI flag is now a directory in all sub-commands (sources, pub, flutter, manifest)
• All commands resolve paths relative to the config file directory, not CWD
• pin-manifest action: replaced flatpak_dir input with config + flutter_version/flutter_version_file

Fixed

• Screenshot URL pinning uses git tag date for deterministic release dates
• ScreenshotConfig.fromYaml handles non-Map input safely

0.1.1 - 2026-05-19

Fixed

• Fix/re pin manifest placeholders

0.1.0 - 2026-05-19

Added

• prepare command — one-shot: generates sources, resolves patches, creates/updates manifest, pins metainfo screenshot URLs to tag/commit
• Config in pubspec.yaml (flutpak: section) or standalone flutpak.yaml (error if both exist)
• Manifest generation with __FLATPAK_TAG__ / __FLATPAK_COMMIT__ placeholders that CI replaces on each release
• extra_modules — include verbatim YAML module files into the manifest
• extra_sources — arch-specific verbatim flatpak sources (e.g. prebuilt C libraries)
• env at manifest level merged with build_options.env
• flutter_version_file — writes the Flutter SDK version string to a file for CI
• .desktop file generation from desktop: config (name, categories)
• sdk-extensions auto-wires LLVM bin/lib paths into append-path / prepend-ld-library-path
• Flutter SDK bin/ always appended to append-path automatically
• Patches registry — objectbox_flutter_libs and sqflite_common_ffi resolved automatically when found in pubspec.lock
• Project-level patches: config with version auto-resolved from lock file
• Patch paths made relative to the manifest directory for correct flatpak-builder resolution
• Retry with exponential back-off (2 s → 4 s → 8 s) on HTTP 429 / 5xx for pub.dev API and Flutter SDK artifact downloads
• Warning when --commit is not available and __FLATPAK_COMMIT__ would remain in the manifest
• Warning when extra_modules file is not found
• Validation of required manifest.app_id and manifest.command fields with clear error messages
• SHA-256 download cache at ~/.cache/flutpak/ to avoid redundant Flutter artifact downloads across runs
• # Generated by flutpak header in manifest, .desktop, and flutter.version output files
• MIT License