https://github.com/buildalon/unity-action

A Github Action to execute Unity Editor command line arguments
https://github.com/buildalon/unity-action

action buildalon cd ci game-ci github-action unity unity-action unity-build unity-ci-cd unity-cli unity3d untiy-actions

Last synced: 3 months ago
JSON representation

A Github Action to execute Unity Editor command line arguments

• Host: GitHub
• URL: https://github.com/buildalon/unity-action
• Owner: buildalon
• License: mit
• Created: 2024-08-08T19:03:03.000Z (6 months ago)
• Default Branch: main
• Last Pushed: 2024-09-26T23:37:17.000Z (4 months ago)
• Last Synced: 2024-09-27T23:01:11.363Z (4 months ago)
• Topics: action, buildalon, cd, ci, game-ci, github-action, unity, unity-action, unity-build, unity-ci-cd, unity-cli, unity3d, untiy-actions
• Language: TypeScript
• Homepage: https://buildalon.com
• Size: 36.1 KB
• Stars: 6
• Watchers: 1
• Forks: 1
• Open Issues: 1
• Metadata Files:
  • Readme: README.md
  • License: LICENSE
  • Codeowners: .github/CODEOWNERS

Awesome Lists containing this project

README

        
# Buildalon Unity Action

[![Discord](https://img.shields.io/discord/939721153688264824.svg?label=&logo=discord&logoColor=ffffff&color=7389D8&labelColor=6A7EC2)](https://discord.gg/VM9cWJ9rjH) [![marketplace](https://img.shields.io/static/v1?label=&labelColor=505050&message=Buildalon%20Actions&color=FF1E6F&logo=github-actions&logoColor=0076D6)](https://github.com/marketplace?query=buildalon) [![validate](https://github.com/buildalon/unity-action/actions/workflows/validate.yml/badge.svg?branch=main&event=push)](https://github.com/buildalon/unity-action/actions/workflows/validate.yml)

A Github Action to execute [Unity Editor command line arguments](https://docs.unity3d.com/Manual/EditorCommandLineArguments.html).

## How to use

### Workflow

```yaml

jobs:

  build:

    env:

    runs-on: ${{ matrix.os }}

    strategy:

      matrix:

        include:

          - os: ubuntu-latest

            build-target: StandaloneLinux64

          - os: windows-latest

            build-target: StandaloneWindows64

          - os: macos-13

            build-target: StandaloneOSX

    steps:

      - uses: buildalon/unity-action@v1

        name: '${{ matrix.build-target }}-Build'

        with:

          editor-path: 'path/to/your/unity/editor/installation'

          project-path: 'path/to/your/unity/project'

          log-name: '${{ matrix.build-target }}-Build'

          build-target: '${{ matrix.build-target }}'

          args: '-quit -nographics -batchmode'

```

### Inputs

| Input | Description | Required | Default |

|-------|-------------|----------|---------|

| `editor-path` | The path to the unity editor installation you want to use to execute the arguments with. | If `UNITY_EDITOR_PATH` environment variable is not set. | `env.UNITY_EDITOR_PATH` |

| `project-path` | The path to the unity project you want to use when executing arguments. | If `UNITY_PROJECT_PATH` environment variable is not set, or if it isn't required for the command. | `env.UNITY_PROJECT_PATH` |

| `build-target` | The build target to use when executing arguments. | false | |

| `args` | The [arguments](https://docs.unity3d.com/Manual/EditorCommandLineArguments.html) to use when executing commands to the editor. | true | `-quit -batchmode -nographics` |

| `log-name` | The name of the log file to create when running the commands. | false | `Unity-yyyyMMddTHHmmss` |