R2 Debian package and desktop integration #61

Closed
opened 2026-11-09 05:29:44 +00:00 by claude · 1 comment
Owner

Depends on: R1

Build a .deb with dpkg-deb, with a desktop entry, icons and a game launcher. Also make the tar.gz launchable from its own folder. Don't install it on this host; validate it in a clean Debian 13 container.

Acceptance

  • In a container: the package installs, the binary launches headless, and it uninstalls cleanly.
  • desktop-file-validate or an equivalent check passes.
**Depends on:** R1 Build a `.deb` with `dpkg-deb`, with a desktop entry, icons and a game launcher. Also make the tar.gz launchable from its own folder. Don't install it on this host; validate it in a clean Debian 13 container. **Acceptance** - In a container: the package installs, the binary launches headless, and it uninstalls cleanly. - `desktop-file-validate` or an equivalent check passes.
claude added this to the v1.0 Release milestone 2026-11-09 05:29:44 +00:00
claude added the type/featurepriority/high labels 2026-11-09 05:29:44 +00:00
claude added this to the Tidewall v1.0 project 2026-11-09 15:00:09 +00:00
eric closed this issue 2026-11-14 08:12:53 +00:00
Author
Owner

Done in f3161bf.

.deb (make deb): build/dist/tidewall_0.9.0-1_amd64.deb, 21 MB.

  • /usr/games/tidewall and tidewall-server, with the game in /usr/lib/tidewall.
  • A desktop entry, hicolor icons from 16 to 512 px plus scalable, and man pages.
  • A DEP-5 copyright file and Godot's licence with its bundled notices.
  • No maintainer scripts (dpkg triggers refresh the caches). Depends: libc6 (>= 2.28), taken from the binary's GLIBC versions; the graphics and audio libraries are Recommends.

Checked in a clean Debian 13 container (make deb-check, never installed on the host):

  • Installs with apt and no recommends.
  • desktop-file-validate passes.
  • Icons, man pages and licences are present, and tidewall is on a user's PATH.
  • tidewall-server runs a 900-tick, 24-bot match as a user with 0 errors.
  • tidewall --headless -- --offline --autoplay plays 2,035 frames with no errors or leaks.
  • The purge leaves nothing behind.
  • Lintian's remaining findings are all from the official Godot template: embedded-library (freetype, libjpeg, jsoncpp) and hardening-no-pie. The one other finding, initial-upload-closes-no-bugs, only matters for the Debian archive. All are accepted, because the binary must stay the SHA-verified template.

Tarball from its own folder:

  • A tidewall launcher that works from any directory and through a symlink.
  • install-desktop-entry.sh to add or --remove a per-user menu entry.
  • tidewall.png and ENGINE-LICENSES.txt. The R1 package was missing the latter, which Godot's MIT licence requires.
  • make dist-check runs the launcher through a symlink from /, and installs, validates and removes the menu entry.

Icon: a hand-written SVG in palette colours (a tide wall with a pennant against a curling sea), rendered with make app-icon and set as the window icon. test_app_icon guards it.

Fixed along the way: headless, the ambience loops were sometimes reported as "resources still in use at exit". Without real audio output, the sound directors now play nothing.

Tests: make check (648), make dist-check and make deb-check pass. A real desktop menu and a real GPU launch were not tested; those belong to R6.

— tidewall-build

Done in f3161bf. **.deb** (`make deb`): `build/dist/tidewall_0.9.0-1_amd64.deb`, 21 MB. - `/usr/games/tidewall` and `tidewall-server`, with the game in `/usr/lib/tidewall`. - A desktop entry, hicolor icons from 16 to 512 px plus scalable, and man pages. - A DEP-5 copyright file and Godot's licence with its bundled notices. - No maintainer scripts (dpkg triggers refresh the caches). `Depends: libc6 (>= 2.28)`, taken from the binary's GLIBC versions; the graphics and audio libraries are Recommends. **Checked in a clean Debian 13 container** (`make deb-check`, never installed on the host): - Installs with apt and no recommends. - `desktop-file-validate` passes. - Icons, man pages and licences are present, and `tidewall` is on a user's PATH. - `tidewall-server` runs a 900-tick, 24-bot match as a user with 0 errors. - `tidewall --headless -- --offline --autoplay` plays 2,035 frames with no errors or leaks. - The purge leaves nothing behind. - Lintian's remaining findings are all from the official Godot template: `embedded-library` (freetype, libjpeg, jsoncpp) and `hardening-no-pie`. The one other finding, `initial-upload-closes-no-bugs`, only matters for the Debian archive. All are accepted, because the binary must stay the SHA-verified template. **Tarball from its own folder:** - A `tidewall` launcher that works from any directory and through a symlink. - `install-desktop-entry.sh` to add or `--remove` a per-user menu entry. - `tidewall.png` and `ENGINE-LICENSES.txt`. The R1 package was missing the latter, which Godot's MIT licence requires. - `make dist-check` runs the launcher through a symlink from `/`, and installs, validates and removes the menu entry. **Icon:** a hand-written SVG in palette colours (a tide wall with a pennant against a curling sea), rendered with `make app-icon` and set as the window icon. `test_app_icon` guards it. **Fixed along the way:** headless, the ambience loops were sometimes reported as "resources still in use at exit". Without real audio output, the sound directors now play nothing. **Tests:** `make check` (648), `make dist-check` and `make deb-check` pass. A real desktop menu and a real GPU launch were not tested; those belong to R6. — tidewall-build
Sign in to join this conversation.
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: claude/tidewall#61