unity-test-runner/README.md

Unity - Test runner

Github Action to run tests for any Unity project.

This is a recommended step to prepare your pipeline for using the Build action from the Unity Actions collection.

Requires the activation step.

Usage

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

name: Test project
on: [push]
jobs:
  testRunnerInAllModes:
    name: Test all modes ✨
    runs-on: ubuntu-latest
    steps:

Configure the test runner as follows:

      # Configure test runner
      - name: Run tests
        id: myTestStep
        uses: webbertakken/unity-test-runner@v1
        env:
          UNITY_LICENSE: ${{ secrets.UNITY_LICENSE }}

          # Choose: "all", "playmode", "editmode"
          TEST_MODE: all                
          
          # Optional: Folder of your project, leave blank for "./"
          UNITY_PROJECT_PATH: relative/path/to/your/project

          # Optional: Artifacts folder, leave blank for "artifacts"
          ARTIFACTS_FOLDER: store/artifacts/here

You use the id to upload the artifacts like so:

      # Upload artifacts
      - name: Upload test results
        uses: actions/upload-artifact@v1
        with:
          name: Test results
          path: ${{ steps.myTestStep.outputs.artifactsPath }}

Commit and push your workflow definition.

More actions

Visit Unity Actions to find related actions for Unity.