urho3d/dockerized-arm

Urho3D的Docker化构建环境

本仓库的master分支包含构建基础镜像的信息，该基础镜像是所有平台特定子镜像的基础。基础镜像被视为抽象镜像，正常使用场景下不应直接在容器中运行。尽管如此，基础镜像设计为可运行的，以便镜像构建者在开发针对新平台的子镜像时进行测试。

本仓库包含多个分支，每个分支对应一个目标平台。有关详细信息，请参阅各分支的README.md文件：

• https://hub.docker.com/r/urho3d/dockerized-native/
• https://hub.docker.com/r/urho3d/dockerized-mingw/
• https://hub.docker.com/r/urho3d/dockerized-android/
• https://hub.docker.com/r/urho3d/dockerized-rpi/
• https://hub.docker.com/r/urho3d/dockerized-arm/
• https://hub.docker.com/r/urho3d/dockerized-web/

虽然这些Docker镜像的主要用途是构建Urho3D项目，但任何复用Urho3D构建系统的下游项目也可受益于该Docker化构建环境。因此，只需将README.md中所有对Urho3D项目的引用替换为您自己的项目即可。

构建

除非您希望将默认locale更改为非en_US.UTF-8，否则无需自行构建基础镜像。

示例：

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

运行

如前所述，这仅适用于Docker镜像构建者。可以运行基础镜像以获取bash shell，镜像构建者可在其中安装软件包并尝试Linux命令，然后将这些操作“提交”到新的Dockerfile中以构建子镜像。

注意，Urho3D Docker化构建环境的运行时实际上是Urho3D项目本身的构建时。因此，要运行基础镜像或其子镜像，至少需要传入Urho3D项目根目录的位置，并确保容器内的运行用户可以访问项目根目录中的文件。这通过将主机文件系统中的Urho3D项目根目录挂载到运行容器内的本地位置，然后设置PROJECT_DIR环境变量指向该本地位置，并设置HOST_UID和HOST_GID为宿主文件系统中Urho3D项目根目录所有者的用户ID和组ID来实现，例如：

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

照常输入exit退出shell。shell进程使用urho3d用户ID调用。该用户仅在容器内动态创建（使用指定的UID和GID），并能够使用sudo命令以root身份安装新软件包，无需密码。urho3d用户在挂载的（本地）Urho3D项目目录中创建的任何新文件（如构建产物），即使容器停止后，在宿主文件系统中仍对Urho3D项目根目录的所有者可见且可访问。

警告：在容器内挂载的Urho3D项目目录中删除的任何文件也将从宿主文件系统中永久删除！

在此挂载目录之外创建或删除的任何内容都只是容器内的临时内容，即一旦容器停止并移除，这些内容都将消失。要提交此类更改，必须如本章开头所述，在新的Dockerfile中相应地编写相关指令。

使用Urho3D项目中的便捷shell脚本运行

Urho3D项目中提供了一个便捷的shell脚本来运行Docker镜像。该脚本位于Urho3D项目根目录的script目录下，名为dockerized.sh。假设调用该shell脚本的用户也是Urho3D项目根目录的所有者，只需输入以下命令即可运行基础镜像：

bash
$ script/dockerized.sh base

有关更多详细信息，请参阅Urho3D项目在线文档https://urho3d.github.io/documentation/HEAD/_building.html#Dockerized_Build_Environment%E3%80%82