Build Helper

Assists with building, compiling, and packaging the Jettison WASM OSD plugin.

Key Concepts

Build Architecture

• 4 WASM variants: live_day, live_thermal, recording_day, recording_thermal
• 2 build modes: production (~640KB) and dev (~2.9MB with debug symbols)
• Docker-first: All builds run inside dev container
• Unified interface: make commands work from both host and container

Build Commands

Use make from anywhere (host or container):

# Build all 4 production WASM
make all

# Build all 4 dev WASM (debug symbols)
make all-dev

# Build + sign packages
make package-all      # production
make package-all-dev  # dev

# Full CI pipeline
make ci

On the host, these automatically delegate to ./tools/devcontainer-build.sh.

Additional Host Commands

The wrapper script provides some extra commands:

./tools/devcontainer-build.sh shell    # Interactive container shell
./tools/devcontainer-build.sh exec "cmd"  # Run arbitrary command

IDE Support (CLion)

Inside the container, additional targets are available:

make                     # Build recording_day only
make recording_day       # Build single variant
make index               # Regenerate compile_commands.json

Build Modes

Mode	Size	Features
production	~640KB WASM, ~900KB package	-Oz -flto -DNDEBUG, no LOG_DEBUG/INFO
dev	~2.9MB WASM, ~3MB package	-O1 -g, debug symbols, all logging

Variants

Variant	Resolution	Mode	Stream
live_day	1920x1080	Live	Day
live_thermal	900x720	Live	Thermal
recording_day	1920x1080	Recording	Day
recording_thermal	900x720	Recording	Thermal

Quality Gates

Runs automatically before builds:

• clang-format - GNU Coding Standard
• clang-tidy - Warnings as errors

Output Locations

• build/*.wasm - Compiled WASM binaries
• dist/*.tar - Signed packages
• dist/*.png - PNG snapshots
• logs/ - Build logs