Josh Knapp
946ea03956
The macOS Gitea runner lacks Node.js, causing actions/checkout@v4 (a JS action) to fail with "Cannot find: node in PATH". Fixed by installing Node.js via Homebrew before checkout and replacing all JS-based actions (setup-node, rust-toolchain, rust-cache) with shell equivalents. Also adds macOS section to BUILDING.md covering Xcode CLI tools, universal binary targets, and Gatekeeper bypass instructions. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
177 lines
3.7 KiB
Markdown
177 lines
3.7 KiB
Markdown
# Building Triple-C
|
|
|
|
Triple-C is a Tauri v2 desktop application with a React/TypeScript frontend and a Rust backend. This guide covers building the app from source on Linux, macOS, and Windows.
|
|
|
|
## Prerequisites (All Platforms)
|
|
|
|
- **Node.js 22** LTS — https://nodejs.org/
|
|
- **Rust** (stable) — https://rustup.rs/
|
|
- **Git**
|
|
|
|
## Linux
|
|
|
|
### 1. Install system dependencies
|
|
|
|
Ubuntu / Debian:
|
|
|
|
```bash
|
|
sudo apt-get update
|
|
sudo apt-get install -y \
|
|
libgtk-3-dev \
|
|
libwebkit2gtk-4.1-dev \
|
|
libayatana-appindicator3-dev \
|
|
librsvg2-dev \
|
|
libsoup-3.0-dev \
|
|
patchelf \
|
|
libssl-dev \
|
|
pkg-config \
|
|
build-essential
|
|
```
|
|
|
|
Fedora:
|
|
|
|
```bash
|
|
sudo dnf install -y \
|
|
gtk3-devel \
|
|
webkit2gtk4.1-devel \
|
|
libayatana-appindicator-gtk3-devel \
|
|
librsvg2-devel \
|
|
libsoup3-devel \
|
|
patchelf \
|
|
openssl-devel \
|
|
pkg-config \
|
|
gcc
|
|
```
|
|
|
|
Arch:
|
|
|
|
```bash
|
|
sudo pacman -S --needed \
|
|
gtk3 \
|
|
webkit2gtk-4.1 \
|
|
libayatana-appindicator \
|
|
librsvg \
|
|
libsoup3 \
|
|
patchelf \
|
|
openssl \
|
|
pkg-config \
|
|
base-devel
|
|
```
|
|
|
|
### 2. Install frontend dependencies
|
|
|
|
```bash
|
|
cd app
|
|
npm ci
|
|
```
|
|
|
|
### 3. Build
|
|
|
|
```bash
|
|
npx tauri build
|
|
```
|
|
|
|
Build artifacts are located in `app/src-tauri/target/release/bundle/`:
|
|
|
|
| Format | Path |
|
|
|------------|-------------------------------|
|
|
| AppImage | `appimage/*.AppImage` |
|
|
| Debian pkg | `deb/*.deb` |
|
|
| RPM pkg | `rpm/*.rpm` |
|
|
|
|
## macOS
|
|
|
|
### 1. Install prerequisites
|
|
|
|
- **Xcode Command Line Tools** — required for the C/C++ toolchain and system headers:
|
|
|
|
```bash
|
|
xcode-select --install
|
|
```
|
|
|
|
No additional system libraries are needed — macOS includes WebKit natively.
|
|
|
|
### 2. Install Rust targets (universal binary)
|
|
|
|
To build a universal binary that runs on both Apple Silicon and Intel Macs:
|
|
|
|
```bash
|
|
rustup target add aarch64-apple-darwin x86_64-apple-darwin
|
|
```
|
|
|
|
### 3. Install frontend dependencies
|
|
|
|
```bash
|
|
cd app
|
|
npm ci
|
|
```
|
|
|
|
### 4. Build
|
|
|
|
For a universal binary (recommended for distribution):
|
|
|
|
```bash
|
|
npx tauri build --target universal-apple-darwin
|
|
```
|
|
|
|
For the current architecture only (faster, for local development):
|
|
|
|
```bash
|
|
npx tauri build
|
|
```
|
|
|
|
Build artifacts are located in `app/src-tauri/target/universal-apple-darwin/release/bundle/` (or `target/release/bundle/` for single-arch builds):
|
|
|
|
| Format | Path |
|
|
|--------|------|
|
|
| DMG | `dmg/*.dmg` |
|
|
| macOS App | `macos/*.app` |
|
|
| macOS App (compressed) | `macos/*.app.tar.gz` |
|
|
|
|
> **Note:** The app is not signed or notarized. On first launch, macOS Gatekeeper may block it. Right-click the app and select "Open" to bypass, or remove the quarantine attribute: `xattr -cr /Applications/Triple-C.app`
|
|
|
|
## Windows
|
|
|
|
### 1. Install prerequisites
|
|
|
|
- **Visual Studio Build Tools** or **Visual Studio** with the "Desktop development with C++" workload — https://visualstudio.microsoft.com/visual-cpp-build-tools/
|
|
- **WebView2** — pre-installed on Windows 10 (1803+) and Windows 11. If missing, download the Evergreen Bootstrapper from https://developer.microsoft.com/en-us/microsoft-edge/webview2/
|
|
|
|
### 2. Install frontend dependencies
|
|
|
|
```powershell
|
|
cd app
|
|
npm ci
|
|
```
|
|
|
|
### 3. Build
|
|
|
|
```powershell
|
|
npx tauri build
|
|
```
|
|
|
|
Build artifacts are located in `app\src-tauri\target\release\bundle\`:
|
|
|
|
| Format | Path |
|
|
|--------|-------------------|
|
|
| MSI | `msi\*.msi` |
|
|
| NSIS | `nsis\*.exe` |
|
|
|
|
## Development Mode
|
|
|
|
To run the app in development mode with hot-reload:
|
|
|
|
```bash
|
|
cd app
|
|
npm ci # if not already done
|
|
npx tauri dev
|
|
```
|
|
|
|
## Container Image
|
|
|
|
The sandbox container image (used at runtime by the app) is built automatically by CI when files under `container/` change. To build it locally:
|
|
|
|
```bash
|
|
docker build -t triple-c-sandbox ./container
|
|
```
|