krkr2-build

name	krkr2-build
description	使用 CMake 和 Emscripten 编译构建 KrKr2 WebAssembly 项目。当用户需要编译、构建或重新构建项目、配置构建预设或排查构建错误时使用。

KrKr2 编译构建

前置条件

确保以下环境变量已设置：

export VCPKG_ROOT=/path/to/vcpkg
source /path/to/emsdk/emsdk_env.sh

依赖工具：Emscripten SDK、vcpkg、ninja、cmake 3.31.1+、bison 3.8.2+、python3。

首次构建前：预编译 Emscripten 端口

Emscripten 的端口库（SDL2、SDL2_ttf 等）在首次使用时按需编译并缓存。Ninja 并行构建时多个 em++ 进程同时触发端口编译会导致缓存锁冲突（EM_CACHE_IS_LOCKED 断言失败）。

首次构建前（或清空 emsdk 缓存后），必须先单线程预编译端口：

embuilder build sdl2 sdl2_ttf sdl2-mt sdl2_ttf-mt

此命令会自动编译 freetype、harfbuzz 等依赖。-mt 后缀为 pthreads 变体。缓存建立后后续构建无需重复执行。

构建命令

产物文件：index.html、index.js、index.wasm、index.data、index.worker.js。

Debug 构建（默认，无 Asan）

cmake --preset "Web Debug Config"
cmake --build out/web/debug

产物在 out/web/debug/ 下。

Debug Asan 构建

启用 AddressSanitizer，用于内存问题排查：

cmake --preset "Web Debug Asan Config"
cmake --build out/web/debug-asan

产物在 out/web/debug-asan/ 下。

Release 构建

cmake --preset "Web Release Config"
cmake --build out/web/release

产物在 out/web/release/ 下。