Skip to content

BUILD.md

Latest commit

 

History

History
136 lines (88 loc) · 1.8 KB

BUILD.md

File metadata and controls

136 lines (88 loc) · 1.8 KB
Raw

Build Instructions

Prerequisites

  • Go 1.21+
  • Node.js 18+
  • Wails CLI v2: go install github.com/wailsapp/wails/v2/cmd/wails@latest

Platform-specific requirements:

Windows:

  • Visual Studio Build Tools or MinGW-w64

macOS:

  • Xcode Command Line Tools

Linux:

  • gcc, pkg-config, gtk3, webkit2gtk

Quick Build

Windows

.\build-windows.ps1

Linux/macOS

./build-linux.sh    # Linux
./build-macos.sh    # macOS

Cross-Platform Build

Build for all platforms:

PowerShell (Windows/Linux/macOS):

.\build-all.ps1

Bash (Linux/macOS):

./build-all.sh

Options

Skip specific platforms:

.\build-all.ps1 -SkipWindows
.\build-all.ps1 -SkipMacOS
.\build-all.ps1 -SkipLinux
./build-all.sh --skip-windows
./build-all.sh --skip-macos
./build-all.sh --skip-linux

Clean build:

.\build-all.ps1 -Clean
./build-all.sh --clean

Development Build

For development with hot reload:

.\dev.ps1

Or manually:

cd backend
wails dev

Output

Build artifacts are placed in build/bin/:

  • Windows: Syntaxia.exe
  • macOS: Syntaxia.app
  • Linux: Syntaxia

Troubleshooting

Windows: Missing compiler

Install Visual Studio Build Tools or MinGW-w64

Linux: Missing dependencies

sudo apt install gcc pkg-config libgtk-3-dev libwebkit2gtk-4.0-dev

macOS: Code signing issues

For development builds, you can skip signing:

wails build -skipbindings -nosyncgomod

Release Build

For production releases with optimizations:

cd backend
wails build -clean -upx -webview2 embed

Options:

  • -clean: Clean build cache
  • -upx: Compress with UPX
  • -webview2 embed: Embed WebView2 runtime (Windows)