urho3d/dockerized-android

Urho3D的Android容器化构建环境

镜像概述和主要用途

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

核心功能和特性

• 集成Android SDK命令行工具和指定版本的构建工具
• 包含NDK的Clang编译器工具链，支持4种ABI：x86、x86_64、armeabi-v7a、arm64-v8a
• 默认不支持GCC编译器工具链
• 可通过构建参数自定义保留的Android API级别，以控制镜像大小
• 支持拆分ABI构建，降低内存占用
• 允许传递Urho3D CMake构建脚本支持的构建选项

构建镜像

除非需要修改默认构建参数，否则无需自行构建此镜像。

构建参数说明

构建命令示例

bash
$ docker build --build-arg platforms=21,28 --tag=urho3d/dockerized-android .

运行容器

容器入口点默认执行./gradlew build，会一次性构建所有ABI，但内存消耗较大（>8GB）。建议通过显式命令执行拆分ABI构建。

基本运行命令（拆分ABI构建）

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-android ./gradlew -P ANDROID_ABI=armeabi-v7a build

传递构建选项

可通过Gradle参数传递Urho3D CMake构建脚本支持的选项，例如构建共享库：

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-android ./gradlew -P URHO3D_LIB_TYPE=SHARED build

使用Urho3D项目中的便捷Shell脚本

使用默认命令构建：

bash
script/dockerized.sh android

构建完成后，所有构建产物可在构建目录中找到。