urho3d/dockerized-native

Urho3D原生Docker化构建环境

镜像概述

本镜像提供Urho3D项目的原生Docker化构建环境，支持GCC和Clang两种编译器工具链，以及64位（默认）和32位架构。不仅适用于Urho3D项目本身，也可用于复用Urho3D构建系统的下游项目，帮助开发人员避免本地环境配置的繁琐，实现一致的跨平台构建结果。

核心功能

• 支持GCC（默认）和Clang两种编译器切换
• 兼容64位与32位架构构建
• 通过环境变量灵活配置构建参数（如库类型、编译器选项）
• 自动执行cmake与make流程，简化构建步骤
• 挂载本地目录实现构建产物直接输出

使用场景

• 开发Urho3D项目时快速搭建一致的构建环境
• 下游项目复用Urho3D构建系统时简化环境配置
• 在不同编译器/架构下测试Urho3D项目的兼容性

配置说明

• 编译器选择：设置CC=clang和CXX=clang++切换至Clang（默认GCC）
• 架构切换：设置URHO3D_64BIT=0启用32位构建（默认64位）
• 库类型：设置URHO3D_LIB_TYPE=SHARED构建共享库（默认静态库）
• 项目路径：通过PROJECT_DIR指定容器内项目路径，需配合--mount挂载本地目录
• 权限设置：HOST_UID和HOST_GID确保构建产物权限与本地用户一致

Docker部署示例

1. 构建镜像（可选）

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

2. 运行容器（Clang 32位构建共享库示例）

bash
docker run -it --rm \
    --mount type=bind,source=/本地路径/urho3d,target=/容器内路径/urho3d \
    -e PROJECT_DIR=/容器内路径/urho3d \
    -e HOST_UID=1234 -e HOST_GID=1234 \
    -e CC=clang -e CXX=clang++ \
    -e URHO3D_64BIT=0 \
    -e URHO3D_LIB_TYPE=SHARED \
    urho3d/dockerized-native

3. 使用Urho3D项目便捷脚本

bash
CC=clang CXX=clang++ URHO3D_64BIT=0 URHO3D_LIB_TYPE=SHARED script/dockerized.sh native