urho3d/dockerized-web

Urho3D Web容器化构建环境

镜像概述和主要用途

本Docker镜像提供了Urho3D的Web容器化构建环境（DBE），主要用于构建Urho3D项目。同时，任何复用Urho3D构建系统的下游项目也可受益于此环境，只需将文档中对Urho3D项目的引用替换为您自己的项目即可。

核心功能和特性

• 包含EMCC编译器工具链，基于Emscripten项目的Incoming分支构建
• 默认目标为WASM（WebAssembly），支持切换为asm.js
• 集成Urho3D构建系统，支持通过环境变量配置构建参数
• 容器化设计确保构建环境一致性，避免依赖冲突

使用场景和适用范围

适用于需要构建Urho3D项目或其下游项目Web版本的开发者，尤其适合：

• 需要跨平台一致构建环境的团队
• 希望快速部署WebAssembly或asm.js版本的Urho3D应用
• 避免在本地环境配置复杂Emscripten工具链的场景

使用方法和配置说明

构建镜像（可选）

通常无需自行构建镜像，除非需要通过自定义基础镜像修改默认locale：

bash
docker build --tag=urho3d/dockerized-web .

直接运行容器

容器入口点默认执行rake cmake && rake make（相当于script/cmake_generic.sh build/web && cd build/web && make），构建产物将保存在项目的构建目录中。

基本运行命令：

bash
docker run -it --rm \
    --mount type=bind,source=/宿主路径/to/urho3d,target=/容器内路径/to/urho3d \
    -e PROJECT_DIR=/容器内路径/to/urho3d \
    -e HOST_UID=1234 -e HOST_GID=1234 \
    urho3d/dockerized-web

环境变量说明

自定义构建示例

构建MODULE类型库并使用asm.js：

bash
docker run -it --rm \
    --mount type=bind,source=/宿主路径/to/urho3d,target=/容器内路径/to/urho3d \
    -e PROJECT_DIR=/容器内路径/to/urho3d \
    -e HOST_UID=1234 -e HOST_GID=1234 \
    -e URHO3D_LIB_TYPE=MODULE \
    -e EMSCRIPTEN_WASM=0 \
    urho3d/dockerized-web

使用Urho3D项目中的便捷脚本

Urho3D项目内置便捷脚本，可简化构建流程：

bash
script/dockerized.sh web

该命令将使用默认配置运行容器，自动处理路径映射和权限设置。