Skip to content
box

GitHub Action

Unity Build Pipeline Utility

v8.0.1 Latest version

Unity Build Pipeline Utility

box

Unity Build Pipeline Utility

Runs a Unity build action using the specified arguments

Installation

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

              

- name: Unity Build Pipeline Utility

uses: RageAgainstThePixel/unity-build@v8.0.1

Learn more about this action in RageAgainstThePixel/unity-build

Choose a version

Unity Build Pipeline

A GitHub Action that builds Unity based projects.

Warning

This action requires that your Unity project be setup and using the com.utilities.buildpipeine package from OpenUPM

openupm

How to use

name: Unity Build

on:
  push:
    branches:
      - 'main'
  pull_request:
    branches:
      - '*'

  # Allows you to run this workflow manually from the Actions tab
  workflow_dispatch:

concurrency:
  group: ${{ github.ref }}
  cancel-in-progress: true

jobs:
  build:
    runs-on: ${{ matrix.os }}
    strategy:
      matrix:
        include:
          - os: windows-latest
            build-target: StandaloneWindows64
          - os: macos-latest
            build-target: StandaloneOSX
          - os: ubuntu-latest
            build-target: StandaloneLinux64

    steps:
      - uses: actions/checkout@v4

        # Installs the Unity Editor based on your project version text file
        # sets -> env.UNITY_EDITOR_PATH
        # sets -> env.UNITY_PROJECT_PATH
        # https://github.com/XRTK/unity-setup
      - uses: RageAgainstThePixel/unity-setup@v1
        with:
          build-targets: ${{ matrix.build-target }}

      - name: Unity Build (${{ matrix.build-target }})
        uses: RageAgainstThePixel/unity-build@v8
        with:
          build-target: ${{ matrix.build-target }}

Inputs

This action has the following input parameters:

  • build-target: Required. The build target to build for. Unity -buildTarget command line args Unity CommandLineArguments. StandaloneWindows64, WSAPlayer, StandaloneOSX, iOS, StandaloneLinux64, Android, Lumin, WebGL. Default is ''.
  • additional-build-args: Optional. Additional command line arguments to pass to build command. Default is ''.
  • output-directory: Optional. The directory to output the build to. Default is ''.
  • publish-artifacts: Optional. Should the workflow publish artifacts? Default is true.
  • test: Optional. Run editor tests. Default is true.
  • additional-test-args: Optional Additional command line arguments to pass to test command. Default is ''.
  • additional-validation-args: Optional Additional command line arguments to pass during project validation phase.
  • artifact-name: Optional A name for this steps artifact.