Document the notarized desktop release and cask

This commit is contained in:
2026-10-30 22:30:41 +08:00
parent d5689ce70d
commit baff9449bd
2 changed files with 18 additions and 9 deletions
+11 -8
View File
@@ -189,14 +189,17 @@ what we take vs. skip). Never vendor it into the build.
- No third-party deps beyond `github.com/coder/websocket`,
`golang.org/x/crypto` (ACME), and `fyne.io/fyne/v2` (desktop UI). Keep it
that way unless a milestone calls for it.
- **CLI release**: `v0.1.0` (tag on `ebae420`) is published on Gitea with
darwin/linux arm64+amd64 tarballs and `checksums.txt`. The Homebrew formula
is `tzgyn-tunnel` in `TZGyn/homebrew-tap` (it installs the `tunnel` binary;
the name avoids the deprecated core `tunnel` formula). Rebuild with
`-X main.version=<version>`, attach all four assets, and update the four
URLs/SHAs in the formula on each release. `tunnel up` currently starts a
detached process, not a launchd agent (the official CLI's agent was stopped
when the live tunnel was switched to this client).
- **Releases**: `v0.2.0` (tag on `d5689ce`) is published on Gitea with
darwin/linux CLI tarballs and a **notarized** `Tunnel-0.2.0.zip`
(`spctl` = accepted / `Notarized Developer ID`). Homebrew: formula
`tzgyn-tunnel` (CLI, installs `tunnel`) and cask `tzgyn-tunnel-app` (desktop,
installs `Tunnel.app`), both in `TZGyn/homebrew-tap`. Rebuild the app with
`scripts/build-desktop-app.sh <version>` for a local ad-hoc build, or
`scripts/release-desktop-app.sh <version>` for the signed+notarized zip;
update both tap files' URLs/SHAs on each release. The app has
**Connect on launch** (`auto_connect`); add it to macOS Login Items to
reconnect at login. The CLI `tunnel up` remains a detached process; the
desktop app runs the service in-process.
- Milestones: M1 core data path (done); M2 real ACME DNS-01 + renewals (done);
M3 rate limits/admin/hardening (done); M4 Go client (done); M5 desktop app
(done). Remaining optional work: launchd/systemd agents for the Go client,
+7 -1
View File
@@ -107,7 +107,13 @@ On macOS, build and ad-hoc sign a launchable bundle:
```bash
./scripts/build-desktop-app.sh 0.2.0
ditto Tunnel.app "$HOME/Applications/Tunnel.app"
open "$HOME/Applications/Tunnel.app" --args --autostart
open "$HOME/Applications/Tunnel.app"
```
Or install the notarized release:
```bash
brew install --cask tzgyn-tunnel-app
```
It uses `~/.config/tunnel/config.json` like the CLI, shows tunnel status and