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

GitHub Action

Unity - Activate

v1.2

Unity - Activate

box

Unity - Activate

Activate Unity using credentials or a license file. Both personal and professional licenses are supported

Installation

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

              

- name: Unity - Activate

uses: game-ci/unity-activate@v1.2

Learn more about this action in game-ci/unity-activate

Choose a version

Unity - Activate

Actions status


GitHub Action to activate Unity.

Part of the Unity Actions collection.


Use this action to activate Unity using credentials or a license file. Both personal and professional licenses are supported.

Note that the latest versions of Test and Build contain standalone activation and no longer require this action.

Documentation

See the Unity Actions collection repository for workflow documentation and reference implementation.

Usage

Create or edit the file called .github/workflows/main.yml and add a job to it.

name: Activate Unity
on: [push]
jobs:
  requestActivation:
    name: Request activation ✔
    runs-on: ubuntu-latest
    steps:

Continue to either the personal license or professional license section below.

Personal license

  1. Follow the activation section from request action to set UNITY_LICENSE variable.
  2. Use the action as follows:
- name: Activate Unity
  uses: webbertakken/unity-activate@v1.2
  env:
    UNITY_LICENSE: ${{ secrets.UNITY_LICENSE }}

Professional license

  1. Goto Repository > Settings > Secrets
  2. Set the following secrets:
    • UNITY_EMAIL: <your_unity_login_email_address>
    • UNITY_PASSWORD: <your_unity_login_password>
    • UNITY_SERIAL: <your_unity_serial>
  3. Use the action as follows:
- name: Activate Unity
  uses: webbertakken/unity-activate@v1.2
  env:
    UNITY_EMAIL: ${{ secrets.UNITY_EMAIL }}
    UNITY_PASSWORD: ${{ secrets.UNITY_PASSWORD }}
    UNITY_SERIAL: ${{ secrets.UNITY_SERIAL }}

Specifying version

Major version differences may require different activation files.

To activate this job's environment for a specific version of unity

- name: Activate Unity
  uses: webbertakken/unity-activate@v1.2
  env:
    UNITY_LICENSE: ${{ secrets.UNITY_LICENSE }}
  with:
    unityVersion: 2019.2.11f1

Returning licenses

When using Pro licenses, free spots are being used up by activating licenses.

In order to keep continuity you need to return the license at the end of your workflow.

Example:

- name: Return license
  uses: webbertakken/unity-return-license@v1
  if: always()

For specific information about returning the license, visit the return license docs.

Save your workflow

Commit and push your workflow definition.

More actions

Visit Unity Actions to find related actions for Unity.

Feel free to contribute.

Licence

MIT