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
/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
Blocking a user prevents them from interacting with repositories, such as opening or commenting on pull requests or issues. Learn more about blocking a user.
Depends on: R1
Build a
.debwithdpkg-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
desktop-file-validateor an equivalent check passes.Done in
f3161bf..deb (
make deb):build/dist/tidewall_0.9.0-1_amd64.deb, 21 MB./usr/games/tidewallandtidewall-server, with the game in/usr/lib/tidewall.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):desktop-file-validatepasses.tidewallis on a user's PATH.tidewall-serverruns a 900-tick, 24-bot match as a user with 0 errors.tidewall --headless -- --offline --autoplayplays 2,035 frames with no errors or leaks.embedded-library(freetype, libjpeg, jsoncpp) andhardening-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:
tidewalllauncher that works from any directory and through a symlink.install-desktop-entry.shto add or--removea per-user menu entry.tidewall.pngandENGINE-LICENSES.txt. The R1 package was missing the latter, which Godot's MIT licence requires.make dist-checkruns 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-iconand set as the window icon.test_app_iconguards 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-checkandmake deb-checkpass. A real desktop menu and a real GPU launch were not tested; those belong to R6.— tidewall-build