GameCI Unity Hub 镜像

镜像概述

unity-ci/hub 是一个Docker化的Unity Hub镜像，专为持续集成(CI)环境设计。它提供了在容器化环境中管理、安装和配置Unity编辑器及其相关模块的能力，简化了Unity项目在CI/CD流程中的环境准备工作。

核心功能与特性

• 容器化部署：采用Docker容器化包装，可无缝集成到各类CI/CD管道中
• 命令行管理：支持通过命令行接口(CLI)执行Unity Hub操作
• 版本控制：可指定安装特定版本的Unity编辑器
• 模块定制：支持选择性安装额外功能模块（如Android/iOS构建支持、WebGL等）

使用场景与适用范围

• 持续集成流程中自动配置Unity开发环境
• CI/CD管道中需要安装特定版本Unity编辑器及模块的场景
• 自动化构建、测试Unity项目前的环境准备
• 多版本Unity项目的并行构建环境隔离

使用方法与配置说明

基础运行方式

通过交互式shell运行镜像：

bash
docker run -it --rm unityci/hub bash

参数说明：

• -it：启用交互式终端
• --rm：容器退出后自动删除

命令行帮助

执行帮助命令查看可用选项：

bash
unity-hub help

⚠ 注意：当前help命令可能无法正常工作，但其他功能命令可正常使用。

安装Unity编辑器

1. 从Unity***下载存档获取目标版本的安装链接
   示例链接格式：unityhub://2020.1.4f1/fa717bb873ec，其中：

   • 2020.1.4f1 为Unity版本号
   • fa717bb873ec 为版本对应的changeset哈希值

2. 使用命令行安装指定版本及模块：

bash
# 安装指定版本Unity编辑器及Android构建支持模块
unity-hub install --version 2020.1.4f1 --changeset fa717bb873ec --module android

参数说明：

• --version：指定Unity编辑器版本号
• --changeset：指定版本对应的changeset哈希值
• --module：指定需要额外安装的模块（可重复指定多个模块）

许可证

本镜像遵循 MIT许可证