axelvbg/unity3d

unity3d:2020.1.12f1 Docker镜像文档

镜像概述

该Docker镜像基于Unity3D 2020.1.12f1版本构建，集成了iOS和Android平台的开发工具链，专为CircleCI持续集成环境优化。旨在为Unity项目提供标准化、可复现的构建环境，简化跨平台应用的自动化构建流程。

核心功能与特性

• 版本锁定：预安装Unity3D 2020.1.12f1版本，确保构建环境版本一致性
• 跨平台支持：内置iOS和Android构建所需的完整工具链（包括SDK、NDK等）
• CI优化：针对CircleCI环境进行配置优化，支持无缝集成到CI/CD流程
• 依赖预配置：包含Unity项目构建常用依赖库，减少环境配置时间

使用场景与适用范围

• CircleCI环境中Unity项目的自动化构建流程
• iOS和Android平台Unity应用的持续集成与持续部署（CI/CD）
• 需要标准化构建环境的团队协作开发
• Unity项目的多平台构建测试与版本发布

使用方法与配置说明

基本使用（Docker Run）

bash
docker run -v /path/to/unity/project:/project \
           -e UNITY_LICENSE_FILE=/project/Unity_lic.ulf \
           unity3d:2020.1.12f1 \
           /bin/bash -c "cd /project && unity-editor -batchmode -quit -projectPath . -buildiOS -customBuildPath ./build/ios"

CircleCI配置示例

在项目根目录创建.circleci/config.yml文件：

yaml
version: 2.1
jobs:
  build_ios:
    docker:
      - image: unity3d:2020.1.12f1
    steps:
      - checkout
      - run:
          name: 激活Unity许可证
          command: unity-editor -batchmode -quit -serial ${UNITY_SERIAL} -username ${UNITY_USERNAME} -password ${UNITY_PASSWORD}
      - run:
          name: 构建iOS项目
          command: unity-editor -batchmode -quit -projectPath . -buildiOS -customBuildPath ./build/ios
      - persist_to_workspace:
          root: ./build
          paths: ios

  build_android:
    docker:
      - image: unity3d:2020.1.12f1
    steps:
      - checkout
      - run:
          name: 激活Unity许可证
          command: unity-editor -batchmode -quit -serial ${UNITY_SERIAL} -username ${UNITY_USERNAME} -password ${UNITY_PASSWORD}
      - run:
          name: 构建Android APK
          command: unity-editor -batchmode -quit -projectPath . -buildAndroid -customBuildPath ./build/android -customBuildName app-release.apk
      - persist_to_workspace:
          root: ./build
          paths: android

workflows:
  build_all_platforms:
    jobs:
      - build_ios
      - build_android

环境变量配置

构建命令参数

常用Unity命令行构建参数：

• -batchmode: 批处理模式运行（无界面）
• -quit: 构建完成后退出
• -projectPath: 指定Unity项目路径
• -buildiOS: 构建iOS平台项目
• -buildAndroid: 构建Android平台项目
• -customBuildPath: 指定构建输出路径
• -customBuildName: 指定输出文件名

注意事项

1. 使用前需确保拥有有效的Unity许可证（个人版或专业版）
2. 首次运行需进行许可证激活，建议在CI配置中通过环境变量传入许可证信息
3. 大型项目可能需要调整Docker资源限制（如内存、CPU）以确保构建稳定性
4. iOS构建需要macOS环境支持，CircleCI需使用macOS执行器时才能正常构建iOS项目