AI_Assistant/pcbjam
Watch
1
0
Fork
You've already forked pcbjam
 0
Code Issues Pull requests Projects Releases 7 Packages Wiki Activity Actions

Improve build system with debug symbols, clean modes, and parallel jobs

Browse source 
- Add build.md documentation for the WASM build system
- Default to debug builds with -gsource-map for WASM debugging
- Add --release flag to disable debug symbols
- Add --clean flag for full rebuild (deps + wxWidgets + KiCad)
- Add -j N flag for parallel compilation (default: 1 for sequential)
- Update Docker memory limit to 32GB
- Propagate DEBUG_BUILD and JOBS to all dependency scripts

Build modes:
- ./docker/build.sh --clean -j8  (full rebuild, parallel)
- ./docker/build.sh              (rebuild KiCad only)
- ./docker/build.sh --no-clean   (incremental)

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
This commit is contained in:
Viktor Vaczi 2025-12-12 14:51:38 +01:00
commit af2adda002
16 changed files with 398 additions and 44 deletions
Download patch file Download diff file Expand all files Collapse all files

9
scripts/build-kicad-wasm.sh
View file

@ -9,7 +9,8 @@
# --with-occ Enable OpenCASCADE (3D/STEP support)
# --with-ngspice Enable ngspice (simulation)
# --with-pthread Enable pthreads (multi-threading)
# --debug Debug build with symbols
# --release Release build (optimized, no debug symbols)
# --debug Debug build with symbols (default)
# -j N Parallel jobs (default: nproc)
# --help Show this help
@ -66,6 +67,10 @@ while [[ $# -gt 0 ]]; do
DEBUG_BUILD=1
shift
;;
--release)
DEBUG_BUILD=0
shift
;;
-j)
PARALLEL_JOBS="$2"
shift 2
@ -83,7 +88,7 @@ done
# Set defaults if not set
CLEAN_BUILD=${CLEAN_BUILD:-0}
DEBUG_BUILD=${DEBUG_BUILD:-0}
DEBUG_BUILD=${DEBUG_BUILD:-1} # Debug mode by default (use --release for optimized builds)
PARALLEL_JOBS=${PARALLEL_JOBS:-$(get_nproc)}
# Export for sub-scripts

26
scripts/build-wxuniversal-wasm.sh
View file

@ -22,6 +22,9 @@ PROJECT_ROOT="$(dirname "$SCRIPT_DIR")"
BUILD_DIR="$PROJECT_ROOT/build-wasm/wxwidgets-universal"
WX_SOURCE="$PROJECT_ROOT/wxwidgets"
# Use JOBS from env.sh if set, otherwise default to 1 for sequential builds
JOBS="${JOBS:-1}"
echo "=== Building wxWidgets wxUniversal for WASM ==="
echo "Project root: $PROJECT_ROOT"
echo "Build dir: $BUILD_DIR"
@ -68,8 +71,20 @@ echo "=== Configuring ==="
# Z_HAVE_UNISTD_H ensures zlib includes <unistd.h> for read/write/lseek
# Include pcre2 headers from the build directory (generated during configure)
PCRE2_INCLUDE="$BUILD_DIR/3rdparty/pcre/src"
export CFLAGS="-DZ_HAVE_UNISTD_H=1"
export CXXFLAGS="-DZ_HAVE_UNISTD_H=1 -I$PCRE2_INCLUDE"
# Configure debug/release flags based on DEBUG_BUILD environment variable
if [ "${DEBUG_BUILD:-1}" = "1" ]; then
WX_DEBUG_FLAGS="-g -O0"
WX_CONFIGURE_DEBUG="--enable-debug"
echo "Building wxWidgets in DEBUG mode"
else
WX_DEBUG_FLAGS="-O2"
WX_CONFIGURE_DEBUG=""
echo "Building wxWidgets in RELEASE mode"
fi
export CFLAGS="-DZ_HAVE_UNISTD_H=1 ${WX_DEBUG_FLAGS}"
export CXXFLAGS="-DZ_HAVE_UNISTD_H=1 -I$PCRE2_INCLUDE ${WX_DEBUG_FLAGS}"
emconfigure "$WX_SOURCE/configure" \
--host=emscripten \
@ -82,7 +97,8 @@ emconfigure "$WX_SOURCE/configure" \
--without-libtiff \
--disable-xlocale \
--with-cxx=17 \
--enable-utf8
--enable-utf8 \
${WX_CONFIGURE_DEBUG}
# Build PCRE first to avoid race condition with parallel builds
# PCRE headers (pcre2.h) must be generated before regex.cpp compiles
@ -92,8 +108,8 @@ emmake make -C 3rdparty/pcre
# Build wxWidgets
echo ""
echo "=== Building wxWidgets ==="
emmake make -j$(nproc 2>/dev/null || sysctl -n hw.ncpu)
echo "=== Building wxWidgets (using ${JOBS} parallel jobs) ==="
emmake make -j${JOBS}
# Create library symlinks (remove -emscripten suffix for CMake compatibility)
echo ""

26
scripts/common/env.sh
View file

@ -34,6 +34,32 @@ export EMSDK_QUIET=1
export EMCC_CFLAGS="-fPIC -DEMSCRIPTEN"
export EMCC_CXXFLAGS="-fPIC -DEMSCRIPTEN -std=c++17"
# Debug mode (default: ON, use --release to disable)
# This can be overridden by setting DEBUG_BUILD=0 before sourcing this file
DEBUG_BUILD="${DEBUG_BUILD:-1}"
if [ "$DEBUG_BUILD" = "1" ]; then
export BUILD_TYPE="Debug"
export DEBUG_CFLAGS="-g -O0"
export DEBUG_LDFLAGS="-g -gsource-map"
else
export BUILD_TYPE="Release"
export DEBUG_CFLAGS="-O2"
export DEBUG_LDFLAGS=""
fi
export DEBUG_BUILD BUILD_TYPE DEBUG_CFLAGS DEBUG_LDFLAGS
# Parallel jobs (default to 1 for memory-constrained environments like Docker)
# Can be overridden with -j N flag or by setting JOBS/PARALLEL_JOBS env vars
if [ -n "$PARALLEL_JOBS" ]; then
export JOBS="$PARALLEL_JOBS"
elif [ -z "$JOBS" ]; then
# Default to 1 for sequential builds (safer for memory)
# Use -j N to override for faster builds on machines with more RAM
export JOBS=1
fi
# Common linker flags for WASM
export WASM_LDFLAGS="\
-sALLOW_MEMORY_GROWTH=1 \

6
scripts/common/functions.sh
View file

@ -226,7 +226,7 @@ get_nproc() {
# Parse common command line arguments
parse_common_args() {
CLEAN_BUILD=0
DEBUG_BUILD=0
DEBUG_BUILD="${DEBUG_BUILD:-1}" # Default ON (use --release to disable)
PARALLEL_JOBS=$(get_nproc)
while [[ $# -gt 0 ]]; do
@ -239,6 +239,10 @@ parse_common_args() {
DEBUG_BUILD=1
shift
;;
--release)
DEBUG_BUILD=0
shift
;;
-j)
PARALLEL_JOBS="$2"
shift 2

21
scripts/deps/build-boost.sh
View file

@ -63,29 +63,38 @@ if [ ! -f "b2" ]; then
./bootstrap.sh --with-toolset=gcc
fi
# Determine boost variant based on DEBUG_BUILD
if [ "${DEBUG_BUILD:-1}" = "1" ]; then
BOOST_VARIANT="debug"
BOOST_DEBUG_FLAGS="-g -O0"
else
BOOST_VARIANT="release"
BOOST_DEBUG_FLAGS="-O2"
fi
# Create user-config.jam for Emscripten
cat > user-config.jam << 'EOF'
cat > user-config.jam << EOF
using clang : emscripten
: em++
: <cxxflags>"-pthread"
: <cxxflags>"${BOOST_DEBUG_FLAGS} -pthread"
<linkflags>"-pthread"
;
EOF
# Build only the locale library (and its dependencies)
# Most of Boost is header-only, we just need locale built
log_info "Building Boost.Locale..."
JOBS=${JOBS:-$(sysctl -n hw.ncpu 2>/dev/null || nproc 2>/dev/null || echo 4)}
log_info "Building Boost.Locale (${BOOST_VARIANT})..."
# JOBS is set in env.sh (default: 1 for sequential builds, use -j N to override)
./b2 -j${JOBS} \
--user-config=user-config.jam \
--prefix="${SYSROOT}" \
--with-locale \
toolset=clang-emscripten \
variant=release \
variant=${BOOST_VARIANT} \
link=static \
threading=multi \
runtime-link=static \
cxxflags="-pthread" \
cxxflags="${BOOST_DEBUG_FLAGS} -pthread" \
install
create_stamp "${BOOST_STAMP}"

14
scripts/deps/build-cairo.sh
View file

@ -56,6 +56,15 @@ log_info "Building Cairo ${CAIRO_VERSION} for WASM..."
mkdir -p "${CAIRO_BUILD}"
cd "${CAIRO_BUILD}"
# Determine meson build type based on DEBUG_BUILD
if [ "${DEBUG_BUILD:-1}" = "1" ]; then
MESON_BUILD_TYPE="debug"
MESON_DEBUG_FLAGS="'-g', '-O0'"
else
MESON_BUILD_TYPE="release"
MESON_DEBUG_FLAGS="'-O2'"
fi
# Cairo uses meson
cat > cross-file.txt << EOF
[binaries]
@ -81,7 +90,7 @@ pkg_config_libdir = '${SYSROOT}/lib/pkgconfig'
default_library = 'static'
b_staticpic = false
b_pie = false
c_args = ['-pthread', '-I${SYSROOT}/include', '-I${SYSROOT}/include/freetype2', '-I${SYSROOT}/include/pixman-1']
c_args = [${MESON_DEBUG_FLAGS}, '-pthread', '-I${SYSROOT}/include', '-I${SYSROOT}/include/freetype2', '-I${SYSROOT}/include/pixman-1']
c_link_args = ['-pthread', '-L${SYSROOT}/lib']
pkg_config_path = '${SYSROOT}/lib/pkgconfig'
EOF
@ -95,6 +104,7 @@ meson setup "${CAIRO_DIR}" \
--cross-file cross-file.txt \
--prefix="${SYSROOT}" \
--default-library=static \
--buildtype=${MESON_BUILD_TYPE} \
-Dfontconfig=disabled \
-Dfreetype=enabled \
-Dglib=disabled \
@ -108,7 +118,7 @@ meson setup "${CAIRO_DIR}" \
-Dfreetype2:default_library=static \
-Dlibpng:default_library=static
JOBS=${JOBS:-$(sysctl -n hw.ncpu 2>/dev/null || nproc 2>/dev/null || echo 4)}
# JOBS is set in env.sh (default: 1 for sequential builds, use -j N to override)
ninja -j${JOBS}
ninja install

4
scripts/deps/build-freetype.sh
View file

@ -53,9 +53,11 @@ mkdir -p "${FREETYPE_BUILD}"
cd "${FREETYPE_BUILD}"
emcmake cmake "${FREETYPE_DIR}" \
-DCMAKE_BUILD_TYPE=Release \
-DCMAKE_BUILD_TYPE=${BUILD_TYPE:-Debug} \
-DCMAKE_INSTALL_PREFIX="${SYSROOT}" \
-DCMAKE_POLICY_VERSION_MINIMUM=3.5 \
-DCMAKE_C_FLAGS="${DEBUG_CFLAGS:--g -O0}" \
-DCMAKE_CXX_FLAGS="${DEBUG_CFLAGS:--g -O0}" \
-DFT_DISABLE_BZIP2=ON \
-DFT_DISABLE_BROTLI=ON \
-DFT_DISABLE_HARFBUZZ=ON \

4
scripts/deps/build-harfbuzz.sh
View file

@ -57,9 +57,11 @@ cd "${HARFBUZZ_BUILD}"
# HarfBuzz uses meson, but also has CMake support
emcmake cmake "${HARFBUZZ_DIR}" \
-DCMAKE_BUILD_TYPE=Release \
-DCMAKE_BUILD_TYPE=${BUILD_TYPE:-Debug} \
-DCMAKE_INSTALL_PREFIX="${SYSROOT}" \
-DCMAKE_POLICY_VERSION_MINIMUM=3.5 \
-DCMAKE_C_FLAGS="${DEBUG_CFLAGS:--g -O0}" \
-DCMAKE_CXX_FLAGS="${DEBUG_CFLAGS:--g -O0}" \
-DHB_HAVE_FREETYPE=ON \
-DHB_HAVE_GLIB=OFF \
-DHB_HAVE_ICU=OFF \

15
scripts/deps/build-ngspice.sh
View file

@ -53,9 +53,16 @@ mkdir -p "${NGSPICE_BUILD}"
cd "${NGSPICE_BUILD}"
# ngspice uses autoconf
# First we need to configure for shared library mode (libngspice)
export CFLAGS="-pthread"
export CXXFLAGS="-pthread"
# Set compiler flags based on debug mode
if [ "${DEBUG_BUILD:-1}" = "1" ]; then
export CFLAGS="-g -O0 -pthread"
export CXXFLAGS="-g -O0 -pthread"
NGSPICE_DEBUG_FLAG="--enable-debug"
else
export CFLAGS="-O2 -pthread"
export CXXFLAGS="-O2 -pthread"
NGSPICE_DEBUG_FLAG="--disable-debug"
fi
export LDFLAGS="-pthread"
# Configure ngspice as a static library for WASM
@ -67,7 +74,7 @@ emconfigure "${NGSPICE_DIR}/configure" \
--build=$(uname -m)-linux-gnu \
--disable-shared \
--enable-static \
--disable-debug \
${NGSPICE_DEBUG_FLAG} \
--disable-dependency-tracking \
--disable-openmp \
--enable-cider \

6
scripts/deps/build-opencascade.sh
View file

@ -61,10 +61,10 @@ cd "${OCC_BUILD}"
# Enable core geometry and data exchange modules only
emcmake cmake "${OCC_DIR}" \
-DCMAKE_POLICY_VERSION_MINIMUM=3.5 \
-DCMAKE_BUILD_TYPE=Release \
-DCMAKE_BUILD_TYPE=${BUILD_TYPE:-Debug} \
-DCMAKE_INSTALL_PREFIX="${SYSROOT}" \
-DCMAKE_CXX_FLAGS="-pthread -O2" \
-DCMAKE_C_FLAGS="-pthread -O2" \
-DCMAKE_CXX_FLAGS="${DEBUG_CFLAGS:--g -O0} -pthread" \
-DCMAKE_C_FLAGS="${DEBUG_CFLAGS:--g -O0} -pthread" \
-DBUILD_LIBRARY_TYPE=Static \
-DBUILD_MODULE_ApplicationFramework=OFF \
-DBUILD_MODULE_Draw=OFF \

14
scripts/deps/build-pixman.sh
View file

@ -52,6 +52,15 @@ log_info "Building Pixman ${PIXMAN_VERSION} for WASM..."
mkdir -p "${PIXMAN_BUILD}"
cd "${PIXMAN_BUILD}"
# Determine meson build type based on DEBUG_BUILD
if [ "${DEBUG_BUILD:-1}" = "1" ]; then
MESON_BUILD_TYPE="debug"
MESON_DEBUG_FLAGS="'-g', '-O0'"
else
MESON_BUILD_TYPE="release"
MESON_DEBUG_FLAGS="'-O2'"
fi
# Pixman uses meson
cat > cross-file.txt << EOF
[binaries]
@ -68,7 +77,7 @@ cpu = 'wasm32'
endian = 'little'
[built-in options]
c_args = ['-pthread']
c_args = [${MESON_DEBUG_FLAGS}, '-pthread']
c_link_args = ['-pthread']
EOF
@ -76,11 +85,12 @@ meson setup "${PIXMAN_DIR}" \
--cross-file cross-file.txt \
--prefix="${SYSROOT}" \
--default-library=static \
--buildtype=${MESON_BUILD_TYPE} \
-Dgtk=disabled \
-Dlibpng=disabled \
-Dtests=disabled
JOBS=${JOBS:-$(sysctl -n hw.ncpu 2>/dev/null || nproc 2>/dev/null || echo 4)}
# JOBS is set in env.sh (default: 1 for sequential builds, use -j N to override)
ninja -j${JOBS}
ninja install

5
scripts/deps/build-protobuf.sh
View file

@ -55,9 +55,10 @@ mkdir -p "${PROTOBUF_BUILD}"
cd "${PROTOBUF_BUILD}"
emcmake cmake "${PROTOBUF_DIR}" \
-DCMAKE_BUILD_TYPE=Release \
-DCMAKE_BUILD_TYPE=${BUILD_TYPE:-Debug} \
-DCMAKE_INSTALL_PREFIX="${SYSROOT}" \
-DCMAKE_CXX_FLAGS="-pthread" \
-DCMAKE_C_FLAGS="${DEBUG_CFLAGS:--g -O0} -pthread" \
-DCMAKE_CXX_FLAGS="${DEBUG_CFLAGS:--g -O0} -pthread" \
-Dprotobuf_BUILD_TESTS=OFF \
-Dprotobuf_BUILD_EXAMPLES=OFF \
-Dprotobuf_BUILD_PROTOC_BINARIES=OFF \

6
scripts/deps/build-zstd.sh
View file

@ -54,7 +54,7 @@ cd "${ZSTD_BUILD}"
# Zstd uses CMake in build/cmake directory
emcmake cmake "${ZSTD_DIR}/build/cmake" \
-DCMAKE_BUILD_TYPE=Release \
-DCMAKE_BUILD_TYPE=${BUILD_TYPE:-Debug} \
-DCMAKE_INSTALL_PREFIX="${SYSROOT}" \
-DCMAKE_POLICY_VERSION_MINIMUM=3.5 \
-DZSTD_BUILD_PROGRAMS=OFF \
@ -62,8 +62,8 @@ emcmake cmake "${ZSTD_DIR}/build/cmake" \
-DZSTD_BUILD_SHARED=OFF \
-DZSTD_BUILD_STATIC=ON \
-DZSTD_MULTITHREAD_SUPPORT=ON \
-DCMAKE_C_FLAGS="-pthread" \
-DCMAKE_CXX_FLAGS="-pthread"
-DCMAKE_C_FLAGS="${DEBUG_CFLAGS:--g -O0} -pthread" \
-DCMAKE_CXX_FLAGS="${DEBUG_CFLAGS:--g -O0} -pthread"
emmake make -j${JOBS}
emmake make install

62
scripts/kicad/build-pcbnew.sh
View file

@ -6,9 +6,12 @@
# ./scripts/kicad/build-pcbnew.sh [options]
#
# Options:
# --no-clean Skip cleaning the build directory (default: clean before build)
# --clean Full clean rebuild (dependencies + KiCad)
# --no-clean Skip cleaning the build directory (default: clean KiCad only)
# --skip-deps Skip building dependencies
# --debug Build with debug symbols
# --debug Build with debug symbols (default)
# --release Build optimized without debug symbols
# -j N Parallel compilation jobs (default: 1)
set -e
@ -23,26 +26,60 @@ KICAD_STAMP="${BUILD_ROOT}/stamps/kicad-pcbnew.stamp"
WASM_LAYER="${PROJECT_ROOT}/wasm"
WX_BUILD="${BUILD_ROOT}/wxwidgets-universal"
# Parse arguments - clean by default
# Parse arguments - clean KiCad by default
NO_CLEAN=0
FULL_CLEAN=0
SKIP_DEPS=0
DEBUG=0
for arg in "$@"; do
case $arg in
while [[ $# -gt 0 ]]; do
case $1 in
--clean)
FULL_CLEAN=1
shift
;;
--no-clean)
NO_CLEAN=1
shift
;;
--skip-deps)
SKIP_DEPS=1
shift
;;
--debug)
DEBUG=1
shift
;;
--release)
DEBUG_BUILD=0
export DEBUG_BUILD
shift
;;
-j)
export JOBS="$2"
shift 2
;;
-j*)
export JOBS="${1#-j}"
shift
;;
*)
shift
;;
esac
done
# Step 1: Clean build directory (default behavior)
if [ $NO_CLEAN -eq 0 ]; then
log_info "Using ${JOBS} parallel jobs"
# Step 1: Clean build directories
if [ $FULL_CLEAN -eq 1 ]; then
log_info "Full clean: removing all stamps and build directories..."
rm -rf "${STAMPS_DIR}"/*
rm -rf "${BUILD_ROOT}/deps"/*
rm -rf "${BUILD_ROOT}/wxwidgets-universal"
rm -rf "${BUILD_ROOT}/stubs"
rm -rf "${KICAD_BUILD}"
rm -rf "${SYSROOT}"/*
elif [ $NO_CLEAN -eq 0 ]; then
log_info "Cleaning KiCad PCBnew build directory..."
rm -rf "${KICAD_BUILD}" "${KICAD_STAMP}"
else
@ -73,12 +110,17 @@ fi
log_info "Building KiCad PCBnew ${KICAD_VERSION} for WASM..."
# Step 5: Set build type
if [ $DEBUG -eq 1 ]; then
# Use environment DEBUG_BUILD if set, otherwise check local --debug flag
if [ "${DEBUG_BUILD:-0}" = "1" ] || [ $DEBUG -eq 1 ]; then
BUILD_TYPE="Debug"
EXTRA_FLAGS="-g -O0"
LINKER_DEBUG_FLAGS="-g -gsource-map"
log_info "Building KiCad in DEBUG mode (with source maps)"
else
BUILD_TYPE="Release"
EXTRA_FLAGS="-O2"
LINKER_DEBUG_FLAGS=""
log_info "Building KiCad in RELEASE mode"
fi
# Step 6: Create build directory
@ -128,7 +170,7 @@ emcmake cmake "${KICAD_DIR}" \
-DCMAKE_POLICY_VERSION_MINIMUM=3.5 \
-DCMAKE_CXX_FLAGS="${EXTRA_FLAGS} -pthread -sUSE_ZLIB=1 -DKICAD_USE_PLATFORM_WASM=1 -I${SYSROOT}/include" \
-DCMAKE_C_FLAGS="${EXTRA_FLAGS} -pthread -sUSE_ZLIB=1 -I${SYSROOT}/include" \
-DCMAKE_EXE_LINKER_FLAGS="-pthread -sUSE_ZLIB=1 -sASYNCIFY=1 -sASYNCIFY_STACK_SIZE=65536 -sUSE_PTHREADS=1 -sPTHREAD_POOL_SIZE=4 -sALLOW_MEMORY_GROWTH=1 -sINITIAL_MEMORY=256MB -sMAXIMUM_MEMORY=4GB -L${SYSROOT}/lib ${STUBS_BUILD}/libgit2_stub.a ${STUBS_BUILD}/libcurl_stub.a" \
-DCMAKE_EXE_LINKER_FLAGS="${LINKER_DEBUG_FLAGS} -pthread -sUSE_ZLIB=1 -sASYNCIFY=1 -sASYNCIFY_STACK_SIZE=65536 -sUSE_PTHREADS=1 -sPTHREAD_POOL_SIZE=4 -sALLOW_MEMORY_GROWTH=1 -sINITIAL_MEMORY=256MB -sMAXIMUM_MEMORY=4GB -L${SYSROOT}/lib ${STUBS_BUILD}/libgit2_stub.a ${STUBS_BUILD}/libcurl_stub.a" \
-DCMAKE_PREFIX_PATH="${SYSROOT};${WX_BUILD}" \
-DwxWidgets_CONFIG_EXECUTABLE="${WX_BUILD}/wx-config" \
\
@ -167,7 +209,7 @@ emcmake cmake "${KICAD_DIR}" \
# Step 8: Build pcbnew target
log_info "Building pcbnew..."
JOBS=${JOBS:-$(sysctl -n hw.ncpu 2>/dev/null || nproc 2>/dev/null || echo 4)}
# JOBS is set in env.sh (default: 1 for sequential builds, use -j N to override)
emmake make -j${JOBS} pcbnew
# Step 9: Create stamp file