[Feature]: Desktop app: release packaging (tarball, AppImage)

Ouverte
#96 0 commentaires 0 réactions 0 personnes assignées Voir sur GitHub

Personne n'a encore pris cette issue.

Évaluation

Difficulté
5/5
Temps estimé
Plus d'une semaine
Accessibilité débutants
24/100
Type d'issue
Fonctionnalité
Clarté
Clairement spécifiée
Activité
Active
Stack technique
github-actions, linux, rust
Domaine
desktop, release

Piste de recherche

Read the epic #80 first, then the dependencies #81 and #85 and the existing release workflow in release.yml. Check licenses/collect.sh and the desktop workspace packaging inputs described here. Done means a test tag publishes both Linux artifacts, the AppImage runs on the listed distributions, URL handling works, and a branch build is available to the NVIDIA tester.

Rédigé par le modèle d'indexation à partir du texte de l'issue.

Description

enhancement

[!NOTE]
This issue was written by Claude (Claude Opus 5.5) from a planning session with @PhrolovaMoe. Part of #80, builds on #81 and #85. Read the epic first.

Area

Desktop app

Problem

People need to install the app, and NVIDIA testers need binaries well before the first release, because David's machine is AMD.

Proposed solution
Release artifacts

A desktop job in release.yml (x86_64-unknown-linux-gnu, ubuntu-24.04, GitHub-hosted, glibc), built from the same tag as the server, with --locked:

  • Tarball tinystream-desktop-<version>-x86_64-linux.tar.gz:
    • tinystream-desktop (the binary);
    • dev.tinystream.app.desktop (with MimeType=x-scheme-handler/tinystream;);
    • hicolor icons from assets/logos, at the usual sizes plus scalable;
    • an AppStream dev.tinystream.app.metainfo.xml;
    • LICENSE, README.md, THIRD_PARTY_LICENSES;
    • an install.sh that copies all of that into ~/.local (or a prefix) and runs update-desktop-database.
  • AppImage tinystream-desktop-<version>-x86_64.AppImage, from the same files. The packaging tool (appimagetool or similar) is downloaded at a pinned version and checked against a pinned SHA-256 in the workflow. No unpinned downloads.
  • THIRD_PARTY_LICENSES comes from licenses/collect.sh, extended to take the desktop workspace: its crates (cargo-about over desktop/Cargo.lock), the native stack including mpv/libplacebo/nv-codec-headers (#85), Geist and Lucide.
  • The publish job attaches both to the release, next to the server archives and the APK.
  • aarch64 Linux is left out until there's hardware to test it on.
Dynamic dependencies

Check the final binary with ldd/readelf -d in CI, against an allowlist of libraries every desktop Linux has (glibc, libm, libstdc++, libEGL/libGL, libvulkan, wayland-client/egl/cursor, libxkbcommon, libX11 family, libasound, D-Bus if not pure Rust). Things loaded at runtime (libcuda, libva drivers, PipeWire/Pulse where mpv loads them) aren't in the list. Fail the job on anything else.

Test builds

A workflow_dispatch (and push to feat/desktop) build that uploads the tarball and AppImage as workflow artifacts, so testers can try a branch without a release. It needs no secrets.

Done when

A release from a test tag has both artifacts. The AppImage runs on a clean Ubuntu 24.04, Fedora and Arch (and David's Void). install.sh registers the URL scheme, so xdg-open tinystream://… opens the app. The NVIDIA tester runs a branch build.

Langage dominant
TypeScript
Étoiles
4
Forks
1
Merge moyen
4 h 49 min
PR mergées (30 j)
5

Préparer son environnement

  • Fournit un Dockerfile ou un fichier Docker Compose
  • Aucun modèle de pull request
  • Aucun guide de contribution

Par où commencer

  1. Lisez l'issue en entier, puis le guide de contribution du projet.
  2. Signalez en commentaire que vous la prenez — cela évite que deux personnes fassent le même travail.
  3. Forkez le dépôt et travaillez sur une branche.
  4. Ouvrez une pull request qui référence le numéro de l'issue.

Autres issues de tinystream-dev/tinystream

Toutes les issues de tinystream-dev/tinystream

Issues similaires

Plus d'issues TypeScript

Recevez les nouvelles issues par e-mail

Un résumé court des issues GitHub adaptées aux débutants.