Skip to content

Release distribution checklist: Arch, Fedora COPR, Debian, Nix #7

Description

@inayayousfi

Tracking issue for everything that still needs to happen to actually distribute Axidev OSK through native package channels, now that the in-tree packaging scaffolding has landed (v0.13.1, 267c317).

Out of scope for this checklist: Flatpak (#5) and Windows installer (#1) remain tracked separately.

Fedora (COPR)

  • create a axide-dev/axidev-osk Fedora COPR project under the organization
  • wire the COPR build to consume the release source archive (axidev-osk-v<version>-source.zip) or a git checkout at the release tag
  • confirm the spec at `packaging/rpm/axidev-osk.spec` builds cleanly in COPR for current Fedora targets (at least the latest stable Fedora)
  • document `dnf copr enable axide-dev/axidev-osk && sudo dnf install axidev-osk` in the README install section
  • decide on automatic vs manual COPR rebuild on each release tag and document the chosen flow
  • add a release-time check or note so new versions actually get pushed to COPR

Arch (AUR)

  • create/confirm the AUR maintainer account used to publish for the project
  • decide final package name (`axidev-osk` source build vs `axidev-osk-bin` consuming the Linux release tarball, or both)
  • finalize `packaging/arch/PKGBUILD` accordingly (sources, checksums strategy, dependency list)
  • submit the package to AUR
  • document install instructions for Arch users in the README
  • define how new releases get pushed to AUR (manual bump vs automated) and document it

Debian / Ubuntu

  • decide on distribution channel: hosted APT repo, GitHub-released `.deb`, or both
  • verify `packaging/deb/debian/` builds a working `.deb` against current Debian stable and current Ubuntu LTS
  • if hosting an APT repo: pick hosting (e.g. GitHub Pages + `reprepro`/`aptly`), set up a signing key, document key trust steps
  • document install instructions for Debian/Ubuntu users in the README
  • decide how new releases produce a new `.deb` (CI job vs manual) and document it

Nix

  • verify `flake.nix` evaluates and builds on current `nixos-unstable`
  • verify the NixOS module in `packaging/nix/module.nix` enables the app correctly (udev rule, `input` group, launcher)
  • document `nix run github:axide-dev/axidev-osk` and module usage in the README
  • decide whether to push the package to nixpkgs eventually, or keep it flake-only for now

Per-distro install testing

For each release, install the relevant native artifact end-to-end on a clean environment and confirm the app launches and types into a focused window:

  • Fedora (latest stable) via COPR
  • Arch via AUR
  • Debian stable via `.deb` / APT repo
  • Ubuntu LTS via `.deb` / APT repo
  • NixOS via flake / module
  • generic Linux via `/opt/axidev-osk` installer (`packaging/linux/install.sh`)

Each test should also confirm:

  • `/dev/uinput` permissions work without manual chmod after install
  • uninstall path leaves the system clean (no dangling launcher, udev rule, or files under `/opt/axidev-osk`)
  • upgrade from the previous release does not break a running setup

Documentation

  • update README install section once each channel is actually live (not before)
  • keep `packaging/README.md` in sync with the chosen channels

Activity

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    enhancementNew feature or request

    Type

    No type

    Projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions