【团结云开发】使用团结云自动构建Unity项目

使用团结云自动构建Unity项目

团结云开发

Unity中国推出的一种全新的协作平台，旨在为团队提供代码管理和自动化工作流的集成解决方案。

目标是提供一个全面的协作环境，让团队可以在一个统一的平台上完成从编码、构建、测试到部署和维护的整个软件开发生命周期。成为自动构建，测试和部署Unity项目的最方便，最高效的方案。

同时提高Unity正版license的价值，结合团结引擎提供项目管理、代码托管、云端构建等功能。

云开发App

使用Unity引擎开发的一款桌面应用程序，是使用团结云开发功能的载体。

技术优势

可自定义工作流
开启并行导入
内置Accelerator、Library Cache
集成分布式AB包构建

基本流程

更多教程请转至官方链接查看，此处仅记录如何使用云开发APP部署自动化构建项目。

自动化构建

题外话，由于Plastichub Beta在2024年12月31日后不再提供服务，当UnityHub更新后，我们可将项目迁移至团结云。

在这之前，请确保已将项目连接至团结云APP。相关步骤参考如下链接

• 从Git同步项目
• 从Plastichub迁移项目
• 连接本地项目

添加工作流

• 在根目录创建.workflows文件夹
  
• 创建构建所用的yaml文件

这里以构建安卓平台的为例，yaml模板文件如下（请按需修改）

name: Devops Build
# 更多有关构建工作流的信息，请参考 https://devops.u3dcloud.cn/help/docs/advanced/yaml
# 您也可以访问注释中的其它链接来了解更多关于 云构建 action 的使用方法

# 在提交至代码库时触发云构建任务
on: [push]

jobs:
  build:
    name: Build Android
    # 为了让工作流可以正常触发，需要指定正确的 runs-on 标签
    # https://devops.u3dcloud.cn/help/docs/advanced/yaml#%E8%A7%A6%E5%8F%91%E5%B7%A5%E4%BD%9C%E6%B5%81
    runs-on: windows-server-2022-unity-2021.3.41f1c1-8c-16g
    steps:
      # 从 Unity Devops Version Control 签出项目 https://devops.u3dcloud.cn/help/docs/advanced/action#actionscheckout-plasticscm
          # silent 是否进行无声签出，若设置为 false 的话则会在日志中显示签出进度
      - name: Check out project repository
        uses: actions/checkout-plasticscm@v1
        with:
          path: tjcloudbuild
          silent: 'false'

      # 检查签出内容
      - name: List repository content
        run: ls -l ./tjcloudbuild

      # 构建 https://devops.u3dcloud.cn/help/docs/advanced/action#actionstj-builder
      - name: Build project
        uses: actions/tj-builder@v3
        id: build-action
        with:
          targetPlatform: Android
          projectPath: ./tjcloudbuild

      # 检查构建结果是否成功生成
      - name: Check build result
        run: ls -l ${{ steps.build-action.outputs.buildsPath }}

      # 上传制品 https://devops.u3dcloud.cn/help/docs/advanced/action#actionstj-upload-artifact
      - name: Upload artifact
        uses: actions/tj-upload-artifact@v2
        with:
          name: Build-${{ steps.build-action.outputs.buildVersion }}
          path: ${{ steps.build-action.outputs.buildsPath }}

注意
这里 runs-on: windows-server-2022-unity-2021.3.41f1c1-8c-16g需要切换成对应的版本。

• 通过Unity Version Control提交文件

也可直接通过PlasticSCM客户端。在“待定更改”菜单栏中，选择新增的文件同步到云上的项目并签入修改。

触发打包构建

• 启动团结云开发APP
• 在项目管理-构建管理中查看配置的yaml文件
  
• 确认无误后，点击“开始构建”

注意

1. 在工作流页面，将会看到您在本地.workflows文件夹添加的yaml文件。 如果没有，请检查.workflows文件夹是否在项目文件根目录下、或者检查yaml文件的格式是否正确。
2. 若需要配置变量或Secrets，请点击“设置”选项卡。 建议配置好变量后再开始构建。
   如何配置Secrets请查看：
   https://docs.gitea.com/zh-cn/usage/usage/secrets
   如何配置变量请查看：https://docs.gitea.com/administration/environment-variables
3. 云上构建打包会消耗云上算力时长。

• 构建成功后，构建记录如下
  

下载构建制品

在构建成功的记录中， 点击“构建制品”，即可下载制品到本地。