GGua REFERENCE日本語GitHub ↗
DOCS / CI

GitHub Actions

link1345/gua-tester is the public GitHub Action for running Gua UI tests from a Godot GDScript project on a Windows runner.

What the root action does

  1. Prepare .NET and Godot

    Downloads the selected Windows Godot build and exports GODOT_EXECUTABLE.

  2. Link the Gua add-on

    Downloads the latest matching or explicitly tagged godot-plugin-* release and copies it to <project-path>/addons/gua.

  3. Run the .NET tests

    Restores the test project and invokes dotnet test with the selected configuration and logger.

Inputs

test-project (required)

Path to the test .csproj that references Gua.Testing.Godot.

project-path

Path to the Godot project. The default is game.

godot-version / godot-status

Defaults to 4.7 and stable. RC and dev suffixes are supported.

dotnet-version

SDK for the external test runner. The default is 10.0.x.

gua-plugin-tag

Pins a specific godot-plugin-* tag. Empty selects the latest matching release.

configuration / test-logger

Defaults to Release and trx;LogFileName=godot-gdscript.trx.

Advanced overrides include godot-executable-suffix (default win64.exe), gua-repository (default link1345/gua), and gua-plugin-asset-pattern (default gua-godot-plugin-*.zip).

Outputs

godot-executable

Absolute path to the downloaded Godot executable.

addon-path

The linked add-on path: <project-path>/addons/gua.

Use the component actions separately

Prepare Godot onlyyaml
- uses: link1345/gua-tester/setup-godot@v1.2
  with:
    godot-version: "4.7"
    godot-status: stable
Link only the Gua add-onyaml
- uses: link1345/gua-tester/link-gua-gdscript-addon@v1.2
  with:
    project-path: game