mirror of
https://github.com/PR0M3TH3AN/SeedPass.git
synced 2025-09-07 14:58:56 +00:00
39 lines
1.5 KiB
Markdown
39 lines
1.5 KiB
Markdown
# Packaging SeedPass
|
|
|
|
This guide describes how to build platform-native packages for SeedPass using [BeeWare Briefcase](https://briefcase.readthedocs.io/).
|
|
|
|
## Prerequisites
|
|
|
|
* Python 3.12 with development headers (`python3-dev` on Debian/Ubuntu).
|
|
* Briefcase installed in your virtual environment:
|
|
|
|
```bash
|
|
pip install briefcase
|
|
```
|
|
|
|
## Linux
|
|
|
|
The helper script in `packaging/build-linux.sh` performs `briefcase create`, `build`, and `package` for the current project.
|
|
|
|
```bash
|
|
./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.
|