GitHub Actions | Gua Reference

Godot 4.7

The Godot composite action downloads the selected Windows Godot build, links the released Gua addon, exports GODOT_EXECUTABLE, prepares project imports, and runs the external Gua.Testing.Godot test project.

.github/workflows/godot.ymlyaml

jobs:
  godot:
    runs-on: windows-latest
    steps:
      - uses: actions/checkout@v4
      - uses: link1345/gua-tester/godot@v2.2
        with:
          project-path: game
          test-project: tests/GuaTester.Tests.csproj
          godot-version: "4.7"
          godot-status: stable
          gua-plugin-tag: gua-v1.18.0

test-project (required)

The .csproj that references Gua.Testing.Godot.

project-path

Godot project path; default game.

godot-version / godot-status

Default 4.7 and stable.

test-logger

Default trx;LogFileName=godot.trx.

The outputs are godot-executable and addon-path. Component actions remain available as link1345/gua-tester/setup-godot@v2.2 and link1345/gua-tester/link-gua-gdscript-addon@v2.2.

Unity 6 Windows x64

The Unity reusable workflow installs a released Gua UPM package, builds a rendered Windows x64 Mono Player with GameCI on Linux, transfers the Player to a Windows runner, fixes its display at 1920x1080, and runs external NUnit tests with GUA_UNITY_PLAYER.

.github/workflows/unity.ymlyaml

jobs:
  unity:
    if: github.event_name != 'pull_request' || github.event.pull_request.head.repo.full_name == github.repository
    uses: link1345/gua-tester/.github/workflows/unity.yml@v2.2
    with:
      project-path: game
      scene-path: Assets/Scenes/Title.unity
      test-project: tests/GuaTester.Unity.Tests.csproj
      artifact-key: game
      unity-version: auto
      gua-tag: gua-v1.18.0
    secrets:
      UNITY_EMAIL: ${{ secrets.UNITY_EMAIL }}
      UNITY_PASSWORD: ${{ secrets.UNITY_PASSWORD }}
      UNITY_LICENSE: ${{ secrets.UNITY_LICENSE }}
      UNITY_SERIAL: ${{ secrets.UNITY_SERIAL }}

Required inputs are project-path, scene-path, test-project, and a caller-unique artifact-key. Optional inputs include unity-version, gua-repository, gua-tag, dotnet-version, configuration, test-logger, and artifact-path. checkout-repository and checkout-ref support fixtures in another repository. Use a matrix value for artifact-key when invoking the workflow more than once in a run.

Personal license

Pass UNITY_EMAIL, UNITY_PASSWORD, and UNITY_LICENSE.

Professional license

Pass UNITY_EMAIL, UNITY_PASSWORD, and UNITY_SERIAL.

Supported target

Unity 6000.5+, Windows x64, Mono, rendered Player.

Artifacts

Unity logs, Player files, TRX, diagnostics, and visual results.

Visual difference reports

link1345/gua-tester/visual-report@v2.2 converts Gua.Testing.Visual manifests and PNGs into a static report for a workflow artifact or GitHub Pages. It is engine-neutral.

Upload a failed visual reportyaml

- name: Upload visual report
  if: failure()
  uses: link1345/gua-tester/visual-report@v2.2
  with:
    artifact-path: artifacts/gua
    test-outcome: failure
    upload-target: workflow

Set upload-target to pages only in a trusted main or manually dispatched run, then deploy the generated Pages artifact from a separate job with pages: write and id-token: write.

Move from v1 to v2

Replace link1345/gua-tester@v1 with link1345/gua-tester/godot@v2.2. There is no v2 root compatibility action. The Godot TRX default changes from godot-gdscript.trx to godot.trx.