Watch

History

Repository files (latest commit first)
Filename	Latest commit message	Latest commit date
Viktor Vaczi d8d934ffca Enable exceptions and pthreads atomics for KiCad WASM build Build fixes: - Enable C++ exceptions in wxWidgets (--enable-exceptions, -fexceptions) Required for KiCad's OnExceptionInMainLoop override in debug builds - Add -matomics -mbulk-memory to all dependency builds for shared memory Required for pthreads support with Emscripten - Fix docker/build.sh output copy path (pcbnew/ not bin/) - Make workspace mount read-only in docker-compose.yml Updated dependency scripts: - build-freetype.sh, build-harfbuzz.sh, build-protobuf.sh - build-zstd.sh, build-opencascade.sh, build-boost.sh - build-pixman.sh, build-cairo.sh (meson cross-file) - build-wxuniversal-wasm.sh, build-pcbnew.sh 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>		2025-12-13 11:29:45 +01:00
..
build.sh	Enable exceptions and pthreads atomics for KiCad WASM build	2025-12-13 11:29:45 +01:00
docker-compose.yml	Enable exceptions and pthreads atomics for KiCad WASM build	2025-12-13 11:29:45 +01:00
Dockerfile	Add KiCad PCBnew WASM build support and documentation	2025-12-08 18:26:57 +01:00
entrypoint.sh	Add Docker build environment for KiCad WASM	2025-12-08 12:07:01 +01:00
README.md	Add Docker build environment for KiCad WASM	2025-12-08 12:07:01 +01:00
shell.sh	Add Docker build environment for KiCad WASM	2025-12-08 12:07:01 +01:00

README.md

Docker Build Environment for KiCad WASM

This directory contains Docker configuration for building KiCad for WebAssembly in a reproducible, isolated environment.

Prerequisites

Docker Desktop (with Docker Compose v2)
Git submodules initialized: git submodule update --init --recursive

Quick Start

# Build KiCad WASM (full build)
./docker/build.sh

# Build with options
./docker/build.sh --no-clean    # Skip cleaning build directory
./docker/build.sh --debug       # Build with debug symbols

# Interactive shell for debugging
./docker/shell.sh

What Gets Built

The build process includes:

Dependencies (cached in Docker volume):
- GLM (header-only)
- Zstd, Protobuf
- FreeType, HarfBuzz
- Pixman, Cairo
- Boost (Locale)
- OpenCASCADE (optional, for 3D/STEP)
- CURL headers, libgit2 headers (stubs)
wxWidgets (built from submodule)
KiCad PCBnew (main application)

Container Resources

Configured for M4 Max (adjust in docker-compose.yml):

CPUs: 10 cores
Memory: 16GB

Volume Strategy

Path	Type	Purpose
`/workspace`	Bind mount	Source code
`/workspace/build-wasm`	Named volume	Build cache (deps, sysroot)
`/workspace/output`	Bind mount	Final WASM output

Common Commands

# Start container
docker compose -f docker/docker-compose.yml up -d

# Run a command inside
docker compose -f docker/docker-compose.yml exec kicad-wasm-builder <command>

# View logs
docker compose -f docker/docker-compose.yml logs -f

# Stop container
docker compose -f docker/docker-compose.yml down

# Clear build cache (full rebuild)
docker volume rm docker_kicad-build-cache

Troubleshooting

Build freezes

The OpenCASCADE build is very resource-intensive. If it freezes:

Reduce parallel jobs: Edit script to use -j4 instead of -j$(nproc)
Monitor with docker stats
Consider building OpenCASCADE separately with ./scripts/deps/build-opencascade.sh

Permission issues

Files created in container are owned by root. To fix:

sudo chown -R $(whoami) output/

Cache issues

# Clear all cached builds
docker volume rm docker_kicad-build-cache

# Or clear specific stamps inside container
./docker/shell.sh
rm /workspace/build-wasm/stamps/*.stamp