thePR0M3TH3AN/seedPass
1
0
Fork 0
mirror of https://github.com/PR0M3TH3AN/SeedPass.git synced 2025-09-10 00:09:04 +00:00
Code Issues Packages Projects Releases Wiki Activity
Files
f2648a8c1db1c5c56e9b6212322b493f39f7ccec
seedPass/docs/packaging.md
thePR0M3TH3AN 593b173e95 Add Briefcase packaging docs and scripts
2025-08-08 09:24:25 -04:00

1.5 KiB
Raw Blame History

Packaging SeedPass

This guide describes how to build platform-native packages for SeedPass using BeeWare Briefcase.

Prerequisites

  • Python 3.12 with development headers (python3-dev on Debian/Ubuntu).
  • Briefcase installed in your virtual environment:
pip install briefcase

Linux

The helper script in packaging/build-linux.sh performs briefcase create, build, and package for the current project.

./packaging/build-linux.sh

Briefcase outputs its build artifacts in build/seedpass-gui/ubuntu/noble/. These files can be bundled in container formats such as Flatpak or Snap. Example manifests are included:

  • packaging/flatpak/seedpass.yml targets the org.gnome.Platform runtime and copies the Briefcase build into the Flatpak bundle.
  • packaging/snapcraft.yaml stages the Briefcase build and lists GTK libraries in stage-packages so the Snap includes its GUI dependencies.

macOS and Windows

Scripts are provided to document the commands expected on each platform. They must be run on their respective operating systems:

  • packaging/build-macos.sh
  • packaging/build-windows.ps1

Each script runs Briefcase's create, build, and package steps with --no-input.

Reproducible Releases

The packaging/ directory contains the scripts and manifests needed to regenerate desktop packages. Invoke the appropriate script on the target OS, then use the supplied Flatpak or Snap manifest to bundle additional dependencies for Linux.