Skip to content

packaging.md

Latest commit

 

History

History
97 lines (71 loc) · 2.74 KB

packaging.md

File metadata and controls

97 lines (71 loc) · 2.74 KB
Raw

Packaging

LazyDesktop produces several distribution artifacts. This page documents each one and how it is built.

Artifact overview

Artifact Platform Builder
.AppImage Linux linuxdeploy + appimagetool
.deb Debian / Ubuntu debian/ + dpkg-deb
.pkg.tar.zst Arch Linux PKGBUILD + makepkg
.msi Windows WiX Toolset
Docker image Any Dockerfile + docker-compose.yml

From the justfile

just build-release            # compile a release binary first
just release-linux-appimage   # .AppImage
just release-linux-deb        # .deb
just release-linux-arch       # .pkg.tar.zst
just release-windows-msi      # .msi
just release                  # all of the above

Linux .AppImage

just release-linux-appimage

This strips the release binary, packages it with linuxdeploy into an AppDir, then produces lazydesktop-x86_64.AppImage with appimagetool.

Debian / Ubuntu .deb

./scripts/build-deb.sh
# or: just release-linux-deb

The script runs dpkg-buildpackage -us -uc -b using the debian/ directory. debian/rules builds with cargo build --release --workspace and installs the target/release/lazydesktop binary plus desktop file and icon. Install with sudo dpkg -i lazydesktop_*.deb.

Arch Linux .pkg.tar.zst

./scripts/build-arch.sh
# or: just release-linux-arch

Runs makepkg -s --cleanbuild using the PKGBUILD, producing lazydesktop-<version>-1-x86_64.pkg.tar.zst. The PKGBUILD builds with cargo build --release --workspace.

Windows .msi

just release-windows-msi

Uses the WiX Toolset with install/windows/lazydesktop.wxs, install/windows/deploy-msi.ps1 (harvests the release directory into a WiX fragment) and install/windows/build-msi.bat.

Docker

docker compose build

See the Docker guide for running instructions.

CI / release automation

Tagging the repository with v* triggers .github/workflows/release.yml, which builds the release binary with Cargo and packages:

  • Linux: .deb + .AppImage (ubuntu-24.04)
  • Arch: .pkg.tar.zst (archlinux container)
  • Windows: .msi (windows-2022, WiX)
  • A checksums.txt of all artifacts

It then creates a GitHub Release with generated notes. Releases are marked as prereleases when the tag contains a pre-release segment (for example v0.2.0-beta.1); stable tags (e.g. v0.2.0) are published as full releases. See release process.

Requirements for local release builds

  • linuxdeploy + appimagetool (or mise install)
  • debhelper, cargo, rustc for the .deb
  • base-devel + rust (makepkg) for Arch
  • WiX Toolset (.NET tool) for the MSI