Unity Actions GitHub 工作流指南

宁彦腾

于 2024-08-10 08:20:50 发布

阅读量375

点赞数 3

本文链接：https://blog.csdn.net/gitblog_00199/article/details/141082840

版权

Unity Actions GitHub 工作流指南

unity-actionsGithub actions for testing and building Unity projects项目地址:https://gitcode.com/gh_mirrors/un/unity-actions

1. 项目介绍

Unity Actions 是一个 GitHub Action，用于自动化 Unity 游戏引擎的工作流程。它允许开发者在GitHub上构建、测试和发布Unity项目，直接集成到持续集成（CI）和持续部署（CD）流程中。通过这个工具，你可以轻松地配置和执行常见的Unity命令，如编译、运行测试或打包游戏。

2. 项目快速启动

要开始使用 Unity Actions，你需要在你的GitHub仓库中创建一个新的.github/workflows目录，并在其中添加一个YAML文件，例如build.yml。以下是一个简单的示例配置：

name: Unity Build and Test

on:
  push:
    branches: [ main ]

jobs:
  build:

    runs-on: ubuntu-latest

    steps:
    - uses: actions/checkout@v2
    - name: Setup Unity Hub
      uses: game-ci/unity-hub-action@v1
      with:
        unityVersion: '2020.3.25f1' # 替换为你所需的Unity版本号
    - name: Setup Unity Project
      uses: game-ci/unity-action@v1
      with:
        workingDirectory: './MyUnityProject' # 指向你的Unity项目根目录
        unityVersion: ${{ steps.setup-unity-hub.outputs.unityVersion }}
        args: '-batchmode -nographics -logFile -executeMethod BuildScript.BuildPlayer'

这段代码会在每次向main分支推送时触发一个名为build的作业，该作业将检查代码、设置Unity Hub并运行Unity项目中的指定方法（这里是BuildScript.BuildPlayer），用于构建游戏。

3. 应用案例和最佳实践

3.1 自动化测试

在工作流中加入测试步骤以确保每次更新代码后都能通过所有测试：

- name: Run Unit Tests
  env:
    CI: true
  run: |
    cd MyUnityProject
    ./Editor/Tests/RunTests.sh

3.2 部署到多个平台

你可以配置不同的工作流步骤来构建不同平台的游戏，比如iOS、Android或WebGL：

- name: Build for iOS
  if: runner.os == 'macOS'
  run: |
    cd MyUnityProject
    unity-editor -batchmode -nographics -executeMethod BuildScript.BuildIos

3.3 版本控制

使用环境变量跟踪和更新构建版本：

env:
  BUILD_NUMBER: ${{ github.run_number }}

- name: Update Version
  run: |
    sed -i '' -e "s/<version>.*<\/version>/<version>${BUILD_NUMBER}<\/version>/" Assets/manifest.json