テストとデバッグ (4.7)
テストの実行: python scripts/test_run.py [--gd|--cs] [-a res://test/x] [--filter expr] は {gd: {total, failed, failures: [{test, file, line, msg}]}, cs: {...}} を返します。最初にインポートし、ヘッドレスで実行し、JUnit/コンソールの結果を解析します。
テストの前にコンパイル: ../godot-gdscript/scripts/gd_check.py と ../godot-csharp/scripts/cs_build.py。../godot-core/scripts/run_godot.py smoke でゲームをスモーク実行します。
GDScript: GdUnit4 (4.7.2 上で 6.2.2 を確認済み)
- インストール: GitHub リリース (github.com/godot-gdunit-labs/gdUnit4、タグ v6.2.x) から
addons/gdUnit4をコピーし、プラグインを有効にします。テストはres://test/に配置し、名前は_test.gdで終わるようにします。 - スイートは
extends GdUnitTestSuiteです。テストはfunc test_*()です。フック:before()、after()(スイートごと)、before_test()、after_test()。 - アサーション:
assert_int/float/str/bool/vector/array/dict/object(x).is_equal(...)、assert_that(x)、assert_signal(obj).is_emitted("died")(monitor_signals(obj)の後)、assert_error(func() -> void: ...)、およびawait assert_func(obj, "is_ready").is_true()。 - メモリ: 作成したオブジェクトを
auto_free(...)でラップします。レポートは孤立ノードをフラグするので、それらをバグとして扱います。 - ダブル:
mock(Class)+do_return(v).on(m).method()、spy(instance)、verify(m, times).method(args)、any_int()など。 - 統合:
var runner := scene_runner("res://player.tscn")、次にrunner.simulate_action_pressed("jump")、await runner.simulate_frames(30)、runner.simulate_key_pressed(KEY_SPACE)、await runner.await_signal("landed")、runner.invoke("method")とrunner.scene()。 - CLI (
test_run.pyが呼び出すもの):godot --headless --path . -s -d res://addons/gdUnit4/bin/GdUnitCmdTool.gd --ignoreHeadlessMode -c -a res://test。終了コード 0 は成功、100 は失敗を意味します。レポートは-rdディレクトリの下の JUnit XML です。
C#: gdUnit4Net (Godot.NET.Sdk 4.7.2、.NET 10 SDK で確認済み)
- ゲームの csproj に追加:
Microsoft.NET.Test.Sdk18.x、gdUnit4.api5.1.0-rc5 (アダプター 3.1.1 には ≥5.1.0-rc5 が必要; 5.0.0 は NU1605 で復元に失敗)、gdUnit4.test.adapter3.1.1、gdUnit4.analyzers1.0.0、および<CopyLocalLockFileAssemblies>true</CopyLocalLockFileAssemblies>。 <GdUnit4><Parameters>--headless</Parameters><GodotConnectTimeout>60000</GodotConnectTimeout></GdUnit4>を含む.runsettingsを追加します。これがないと、Godot ランタイムテストの接続がタイムアウトします。GODOT_BIN=<godot exe> dotnet test --settings .runsettingsで実行します。[TestSuite]クラス、[TestCase]メソッド、[Before]/[After]/[BeforeTest]/[AfterTest]、パラメータ化テスト用の[DataPoint(nameof(Cases))]。using static GdUnit4.Assertions;→AssertThat(x).IsEqual(y)、AutoFree(node)を使用します。[RequireGodotRuntime]は、Mathf、ノード、リソースを含む Godot 型に触れるすべてのテストで必要です。そうしないと、アナライザーはGdUnit0501を報告します。純粋な C# テストはエンジンなしで実行され、はるかに高速です。- シーン:
ISceneRunner.Load("res://x.tscn")→SimulateFrames、SimulateActionPressed、AwaitSignal、Invoke。
何をテストするか
純粋なロジック(ダメージ、インベントリ、セーブマイグレーション)は高速な単体テストとして。シーンはシーンランナーを通じて、コントローラーのフィーリング、UI フロー、シグナル配線をテストします。すべてのバグ修正には回帰テストを追加します。スイートは高速に保ちます。低速なスイートは実行されなくなります。
デバッグ
- エディタから実行 (F5) してフルデバッガーを使用: スタックトレース付きエラー、ブレークポイント(または
breakpointステートメント)、ステップイン/アウト(Step Out は 4.6 で追加)、Remote シーンツリー(再生中のライブノードとプロパティの検査)、プロファイラー、モニター、ObjectDB スナップショット (4.6)。 - ロギング:
print、print_rich("[color=yellow]...")、print_debug(ファイルと行を追加)、push_warning/push_error(スタックと共にデバッガーに表示され、致命的ではない)、printerr。assert(cond, "msg")はデバッグビルドでのみ実行されるため、その中に副作用を決して入れないでください。 - ファイルログ:
debug/file_logging/enable_file_logging(デスクトップではデフォルトでオン、user://logs/godot.log)。user://はOS.get_user_data_dir()で見つけます。 - カスタム
Logger(4.5+): サブクラス化し、_log_error/_log_messageをオーバーライドし、OS.add_logger()で登録します。script_backtracesを使用してゲーム内バグレポートに使用します。リリースビルドのバックトレースのためにdebug/settings/gdscript/always_track_call_stacksをオンにします。Engine.capture_script_backtraces()はオンデマンドで 1 つをキャプチャします。 - CLI:
-d(標準出力デバッガー)、--verbose、--debug-collisions/--debug-navigation、そして--remote-debug tcp://host:6007(実行中のビルドをエディタにアタッチするため)。 - C#: IDE デバッガーをゲームプロセスにアタッチします(Rider と VS Code C# Dev Kit は
--pathで Godot を起動できます)。例外はログに記録されますが、致命的ではないため、出力パネルを確認します。
エラーの高速な読み方
res://file.gd:LINE は行を指します。「null instance」は、不正なノードパス、または _ready の前に使用された何かを意味します。「previously freed」は、await またはコールバックがノードよりも長生きしたことを意味します。「Parse Error」または「Compile Error」はスクリプトのロードを停止させるため、それを使用するすべてが失敗し、最初のエラーを最初に修正します。「Condition "!is_inside_tree()" is true」は、まだツリーにないノードに対してツリー API が呼び出されたことを意味します。エンジンの C++ ファイル参照 (scene/main/node.cpp:123) は、それでも あなたの 呼び出しが間違っていたことを意味するため、スタックを読みます。
GdUnit スイート(ユニット、モック、シグナル、シーンランナー)、C# テスト、ゲーム内 Logger(テストによってコンパイル済み): references/patterns.md