GitHub Action to download and install Unity. Based on Unity Hub.

Works on Ubuntu, macOS and Windows. More details

Unity version to install. For example, 2019.4.9f1. Project version will be used if not provided.

Unity version changeset. For example, 50fe8a171dd9. Automatically parsed from Unity site if not provided.

List of Unity modules (e.g. build support) to install. For example, [ios, android, webgl].

Available modules:

Documentation: documentation
Standard Assets: standardassets
Example Project: example
Android Build Support: android
iOS Build Support: ios
tvOS Build Support: appletv
Linux Build Support: linux-mono
SamsungTV Build Support: samsung
Tizen Build Support: tizen
WebGL Build Support: webgl
Windows Build Support: windows
Facebook Gameroom Build Support: facebook-games
MonoDevelop / Unity Debugger: monodevelop
Vuforia Augmented Reality Support: vuforia-ar
Language packs: language-ja, language-ko, language-zh-cn, language-zh-hant, language-zh-hans
Mac Build Support (IL2CPP): mac-il2cpp
Windows Build Support (Mono): windows-mono
Android SDK & NDK Tools: android-sdk-ndk-tools
OpenJDK: android-open-jdk
Lumin OS (Magic Leap) Build Support: lumin

Also list of available modules can be checked by execute: <path-to-unity-hub> -- --headless help.

Automatically installs all child modules of selected modules. For example, android-open-jdk and android-sdk-ndk-tools for android. Default true.

Path to Unity project. Used to find Unity version. Default ${{ github.workspace }}.

Path where the Unity editor will be installed.

Unity version.

Unity executable path. Also setted env UNITY_PATH.

• Installing android module with childs modules may freeze on macOS. Recommended to use with timeout-minutes.
• Workflow may fail with System.IO.IOException: No space left on device on GitHub-hosted Ubuntu. Setting install-path: /mnt can fix the problem.

- name: Checkout project
  uses: actions/checkout@v2

- name: Setup Unity
  uses: kuler90/setup-unity@v1
  with:
    unity-modules: android

- name: Activate Unity
  uses: kuler90/activate-unity@v1
  with:
    unity-username: ${{ secrets.UNITY_USERNAME }}
    unity-password: ${{ secrets.UNITY_PASSWORD }}
    unity-serial: ${{ secrets.UNITY_SERIAL }}

- name: Build Unity
  uses: kuler90/build-unity@v1
  with:
    build-target: Android
    build-path: ./build.apk