Skip to content
You're viewing an older version of this GitHub Action. Do you want to see the latest version instead?
download

GitHub Action

Buildalon Unity Setup

v1.0.4

Buildalon Unity Setup

download

Buildalon Unity Setup

A GitHub action for setting up the Unity Game Engine for CI/CD workflows

Installation

Copy and paste the following snippet into your .yml file.

 
              
- name: Buildalon Unity Setup

              
  uses: buildalon/unity-setup@v1.0.4
Learn more about this action in buildalon/unity-setup

Choose a version

Buildalon Unity Setup

Discord actions

A GitHub Action for setting up the Unity Game Engine on GitHub Action Runners.

How to use

workflow

strategy:
  matrix:
    os: [ubuntu-latest, windows-latest, macos-13, macos-latest]
    unity-versions:
      - 'in version file'
      - 2019.4.40f1 (ffc62b691db5)
      - 2020.3.48f1 (b805b124c6b7)
      - 2021.3.41f1 (6c5a9e20c022)
      - 2022.3.40f1 (cbdda657d2f0)
      - 6000.0.13f1 (53a692e3fca9)
    include:
      - os: ubuntu-latest
        build-targets: StandaloneLinux64, Android, iOS
        modules: linux-server
      - os: windows-latest
        build-targets: StandaloneWindows64, Android, WSAPlayer
        modules: windows-server
      - os: macos-13
        build-targets: StandaloneOSX, Android, iOS
        modules: mac-server
      - os: macos-latest
        build-targets: StandaloneOSX, Android, iOS, VisionOS
        modules: mac-server
steps:
  - uses: buildalon/unity-setup@v1
    with:
      version-file: 'path/to/your/ProjectSettings.ProjectVersion.txt'
      unity-version: ${{ matrix.unity-versions }} # overrides version in version-file
      build-targets: ${{ matrix.build-targets }}
      modules: ${{ matrix.modules }}

  - run: |
      echo "UNITY_HUB_PATH: '${{ env.UNITY_HUB_PATH }}'"
      echo "UNITY_EDITORS: '${{ env.UNITY_EDITORS }}'"
      echo "UNITY_EDITOR_PATH: '${{ env.UNITY_EDITOR_PATH }}'"
      echo "UNITY_PROJECT_PATH: '${{ env.UNITY_PROJECT_PATH }}'"

inputs

name description required
version-file Specify a path to search for the unity project version text file. Useful if there are multiple projects in a single repo. false
unity-version Specify the Unity version(s) to install. You must include the changeset! i.e 2019.4.13f1 (518737b1de84). This will override any version specified in the version-file! false
build-targets Specify the build targets to install for. Remaps to corresponding module. One or more of StandaloneWindows64 WSAPlayer StandaloneOSX iOS StandaloneLinux64 Android Lumin WebGL VisionOS. false
modules Modules to install with the editor. This list can be different per editor version. false
architecture Specify the architecture to install. Either x86_64 or arm64. false

outputs

  • UNITY_HUB_PATH: The path to the installed unity hub.
  • UNITY_PROJECT_PATH: The path to the Unity project.
  • UNITY_EDITOR_PATH: The path to the last installed version of Unity.
  • UNITY_EDITORS: A json object of each editor installation {"version":"path"}.