urho3d/dockerized-rpi

Urho3D的Raspberry Pi容器化构建环境

镜像概述和主要用途

本镜像为Urho3D项目提供Raspberry Pi（RPI）平台的容器化构建环境，是Urho3D Docker化构建环境体系中的基础镜像。该基础镜像是抽象的，通常不直接用于常规构建，而是作为各平台（包括RPI）特定镜像的构建基础。尽管主要面向Urho3D项目，但其构建系统也适用于复用Urho3D构建体系的下游项目。

核心功能和特性

• 平台基础镜像：作为RPI等平台特定构建镜像的基础，支持多平台扩展
• 可运行设计：允许镜像开发者在开发新平台镜像时运行容器进行测试
• locale自定义：支持通过构建参数修改默认语言环境（默认en_US.UTF-8）
• 权限同步：运行时动态创建与主机匹配的用户ID/组ID，确保文件访问权限一致
• 开发便利：容器内临时用户可无密码使用sudo安装软件包
• 数据持久化：挂载的项目目录中生成的构建产物在主机系统中保持可访问性

使用场景和适用范围

• Urho3D项目在Raspberry Pi平台的构建需求
• 复用Urho3D构建系统的下游项目的RPI平台构建
• 开发者创建新Urho3D平台特定镜像时的测试与验证环境

详细使用方法和配置说明

构建镜像

通常无需自行构建基础镜像，除非需要修改默认语言locale设置。

构建参数说明

构建示例

bash
$ docker build --build-arg lang=en_SG.UTF-8 --tag=urho3d/dockerized .

运行容器

仅建议镜像开发者运行基础镜像，用于测试新平台镜像的构建环境。需挂载项目目录并配置权限参数。

基本运行命令

bash
$ docker run -it --rm \
    --mount type=bind,source=/host-path/to/urho3D,target=/local-path/to/urho3d \
    -e PROJECT_DIR=/local-path/to/urho3d \
    -e HOST_UID=1234 -e HOST_GID=1234 \
    urho3d/dockerized

参数说明

• --mount: 将主机Urho3D项目目录挂载到容器内指定路径
• -e PROJECT_DIR: 容器内Urho3D项目根目录路径
• -e HOST_UID/-e HOST_GID: 主机项目目录所有者的用户ID和组ID，用于权限同步

运行注意事项

• 容器内以urho3d用户身份运行bash shell，该用户根据指定的UID/GID动态创建
• 可使用sudo命令安装软件包，无需密码
• 警告：容器内挂载目录中删除的文件会从主机系统永久删除，请谨慎操作
• 容器内非挂载目录的文件变更为临时状态，容器停止后自动清除，需通过Dockerfile固化变更

使用Urho3D项目便捷脚本

Urho3D项目提供script/dockerized.sh脚本简化容器运行流程。假设当前用户为项目目录所有者，运行基础镜像命令：

bash
$ script/dockerized.sh base

更多详细说明参见Urho3D官方文档：https://urho3d.github.io/documentation/HEAD/_building.html#Dockerized_Build_Environment