uloop-run-tests

uloop run-tests

Unity Test Runner を実行します。テストが失敗すると、エラーメッセージとスタックトレースを含む NUnit XML の結果が自動的に保存されます。失敗の詳細を診断するには、XmlPath の XML ファイルを読み取ってください。

uloop run-tests はテストを実行する前に、保留中のスクリプト変更を自動的にコンパイルします。--skip-compile は、コンパイルによってクリアされるアクティブなホットリロードパッチを検証する場合にのみ指定してください。それ以外の場合は、デフォルトのコンパイルでエラーを検出し、現在のスクリプトで実行してください。--skip-compile がスキップするのは CLI 側のコンパイルだけです。Unity は最後のコンパイル以降に保存されたスクリプトの編集内容を引き続きインポートし、実行によってアセンブリロックが解放されるとすぐに、そのインポートでドメインがリロードされ、アクティブなパッチが破棄されてリクエストが終了します。

テストの実行前に、uloop run-tests は --unsaved-changes（デフォルトは save）に従って、未保存の読み込み済み Scene と Prefab Stage の変更を処理します。save は先に変更を保存し、fail は未保存の変更が残っている場合に停止し、discard はディスク上の状態を再読み込みして、保存済みのファイルを対象にテストを実行します。名前のないシーンは破棄できず、エラーになります。選択したモードで処理を続行できない場合、Success: false を返し、TestCount を 0 のままにして、項目を Message に列挙し、Unity Test Runner を起動しません。

テスト実行が始まる前に、アクティブな一時停止ポイントは自動的にクリアされます（基となるコードパッチも削除されます）。クリアされた ID は、レスポンスの ClearedPausePointIds フィールドに報告されます。

テスト実行の終了時に、アクティブなホットリロード変更が破棄されることがあります。実行中にインポートされたスクリプトの編集内容は、テストランナーがアセンブリのリロードロックを解放したときにコンパイルされます。この遅延されたドメインリロードによって、テスト自体はパッチを適用した状態で実行されていても、パッチは消去されます。レスポンスの Warning フィールドにこの内容が報告されます。次の Play またはテスト実行の前に、'uloop hot-reload' を再適用するか、'uloop compile' で編集内容を反映してください。

NoTestsFound は、一致するテストが 0 件だったことを意味し、テストの失敗ではありません。asmdef に関するヒントは NoTestsFoundExplanation と Message を確認してください。フィルターなしの実行でテストが見つからず、プロジェクトに TestMode 用のテストアセンブリがない場合、ProposedTestAsmdef に、すぐに書き込める .asmdef が含まれます。Content を AssetPath に保存し、テストスクリプトをそのフォルダーに移動してから、コンパイルして再実行してください。

使用方法

uloop run-tests [options]

パラメーター

パラメーター	型	デフォルト	説明
--test-mode	文字列	EditMode	テストモード：EditMode、PlayMode
--filter-type	文字列	all	フィルタータイプ：all、exact、regex、assembly、class
--filter-value	文字列	-	フィルター値（テスト名、パターン、アセンブリ、またはクラス名）
--unsaved-changes	文字列	save	save は未保存の Scene／Prefab Stage の変更を書き込みます。fail は未保存の変更が残っている場合に停止します。discard はディスク上の状態を再読み込みします（Untitled シーンでは失敗します）
--skip-compile	フラグ	-	テスト実行前の CLI 側でのコンパイルをスキップします。アクティブなホットリロードパッチを検証する場合にのみ使用してください。Unity は、最後のコンパイル以降に保存されたスクリプトの編集を引き続きインポートします。
--timeout-seconds	整数	600	await をキャンセルするまでに RunFinished を待つ最大秒数（最大 1500）。長時間かかるスイートでは増やしてください。タイムアウト後も、停止処理が完了するまでは Test Runner が実行中の場合があります
--respect-enter-play-mode-settings	フラグ	-	PlayMode のみ：Domain Reload をオフに強制せず、プロジェクトの Enter Play Mode 設定を維持します。実行中に Domain Reload が発生しても、その後リロード後に結果を復元します。Play に入る際に Domain Reload が必要なライブラリを使用するプロジェクトで利用してください。

デフォルトでは、PlayMode は引き続き Domain Reload をオフに強制します。--respect-enter-play-mode-settings を指定すると、Domain Reload が実行される場合があり、コマンドの実行時間が長くなります。リロード後に復元された結果では、一時停止ポイントとホットリロードに関する注記は省略されます。この経路では、CLI をキャンセル（Ctrl-C）しても Unity 側の実行は停止しません。

exact はテスト名全体（Namespace.Class.Method）と完全一致します。class は、単独名または名前空間修飾名で指定したクラスのすべてのテストを実行します。例：--filter-type class --filter-value PlayerTests。名前は文字列全体で照合されるため、PlayerTests を指定しても EnemyPlayerTests は実行されません。regex は、テスト名全体に対して .NET 正規表現で照合します。例：--filter-type regex --filter-value '^MyGame.Tests.'

出力

以下を含む JSON を返します。

• Success（boolean）：すべてのテストに合格したかどうか
• Status（string）：Passed、Failed、NoTestsFound、ExecutionFailed などの機械可読な実行ステータス
• HasFailures（boolean）：検出されたテストに失敗があったかどうか
• Message（string）：概要メッセージ
• NoTestsFound（boolean）：Unity Test Runner が一致するテストを 1 件も検出しなかったかどうか
• NoTestsFoundExplanation（string）：NoTestsFound が true の場合にエージェント向けの説明を返します。それ以外の場合は空です
• CompletedAt（string）：実行完了時の ISO タイムスタンプ
• TestCount（number）：実行したテストの合計数
• PassedCount（number）：合格したテスト数
• FailedCount（number）：失敗したテスト数
• SkippedCount（number）：スキップされたテスト数
• XmlPath（string）：NUnit XML 結果ファイルのパス。XML が保存されていない場合（通常は Success: true の場合）は空文字列です。テストが失敗し、XML ファイルがディスク上に存在する場合にのみ値が設定されます
• ClearedPausePointIds（string[]、任意）：テスト実行前に解除された一時停止ポイントの ID。一時停止ポイントが有効になっていなかった場合、JSON には含まれません
• FailedTests（array、任意）：失敗したリーフテストのうち最大 10 件。各テストには FullName、Message、およびスタックトレースにパスと行番号が含まれる場合は File と Line が含まれます。テストが失敗していない場合は含まれません。FailedCount が 10 を超える場合、Message は first 10 of N failures listed; see XmlPath for full results. で終わります
• SkippedTests（string[]、任意）：スキップされたリーフテストの完全名を最大 10 件返します。テストがスキップされていない場合は含まれません。SkippedCount が 10 を超える場合、最初の 10 件の名前のみが列挙されます
• ProposedTestAsmdef（object、任意）：書き込み可能な状態のテスト用 .asmdef の AssetPath と Content（テストアセンブリの構成、およびテスト対象プロジェクトのアセンブリへの参照）。フィルターなしの実行でテストが見つからず、TestMode 用のテストアセンブリも存在しない場合にのみ含まれます
• CompileNote（string、任意）：テスト実行前に自動コンパイルが行われ、成功したことを示し、オプトアウト用の --skip-compile を記載します。コンパイル応答に Warning が含まれていた場合（たとえば、ドメインリロードによってアクティブなホットリロードの変更が破棄された場合）、この注記にも同じ内容が記載されます。--skip-compile が指定された場合は含まれません。コンパイルに失敗した場合は、代わりにコンパイルエラー応答が返されます

XML 結果ファイル

テストが失敗すると、NUnit XML の結果が {project_root}/.uloop/outputs/TestResults/<timestamp>.xml に自動保存されます。XML には、テストケースごとに次の結果が含まれます。

• テスト名と完全名
• 合格／失敗／スキップのステータスと実行時間
• 失敗したテストの場合：<message>（アサーションエラー）と <stack-trace>