初めてのUnity Test Framework ― 基礎から動かし方まで完全ガイド

2026年11月9日

広告

Unity Test Framework と Test Runner

Unity Test Framework は、NUnit を土台にした Unity のテスト機能です。Unity 6.6 では Editor と一緒に配布されるコアパッケージで、パッケージのバージョンは Editor に対応します。Test Runner は、テストを選んで実行し、結果を表示する Editor ウィンドウです。Window > General > Test Runner から開きます。

実行モード実行環境例
Edit ModeEditor の編集モード計算、データ変換、Editor 拡張
Play ModeEditor の再生モード、または対応する PlayerMonoBehaviour の更新、物理、ゲーム中の動作

その場で完了する検証は [Test] を使います。処理を待ってから確かめたいときは [UnityTest] と IEnumerator を使えます。Edit Mode の [UnityTest] は Editor の更新ループで進み、たとえば yield return null で次の更新を待てます。物理ステップやゲーム内時間を使う待機は Play Mode に置きます。

2. なぜテストが必要か?

  • 品質保証:コード変更による不具合を即座に検出し、手動テストやユーザー報告に頼る必要を減らします。
  • 効率化:大規模化したプロジェクトでは、どこで壊れたかを自動テストで特定でき、開発速度を維持できます (ユニットテスト – Unity マニュアル).

テストを作って実行する

Test Runner の対象タブでテストアセンブリ用フォルダーを作り、そのフォルダーにテストスクリプトを別途作成します。Calculator を試す場合は、Calculator.cs を CalculatorAsm に所属させ、テスト用 .asmdef の参照一覧に CalculatorAsm を追加します。Test Runner で Run All または Run Selected を押し、ケース別に結果を確認します。 Calculator の手順とコード

コマンドラインからは、プロジェクトを閉じてから次のように実行できます。<Unity実行ファイル> と <プロジェクトの絶対パス> を環境に合わせて置き換えます。

"<Unity実行ファイル>" -batchmode -runTests \
  -projectPath "<プロジェクトの絶対パス>" \
  -testPlatform EditMode -testResults "$PWD/editmode-results.xml" \
  -logFile "$PWD/editmode-editor.log"

Editor 内の Play Mode テストでは -testPlatform PlayMode を指定し、出力ファイル名も変更します。この例ではテスト完了前の終了を避けるため -quit を併用しません。自動化では終了ステータス、結果 XML の生成と実行件数、Editor ログを確認します。Editor ツールから起動する場合は TestRunnerApi に実行モードを含むフィルターを渡し、コールバックを登録して完了時に結果を受け取ります。

Unity 6.6 Edit Mode と Play Mode · Unity 6.6 テストの実行 · Unity 6.6 コマンドライン引数

9. よくあるトラブルシューティング

問題原因例対処方法
テストが一覧に表示されないテストスクリプトが .asmdef 配下にないAssets/Tests フォルダにスクリプトと .asmdef を配置
[UnityTest] テストが実行されない[Test] 属性を使っている[UnityTest] 属性に変更し IEnumerator を返す
CLI 実行でテストが走らない引数の -projectPath や -testPlatform ミスコマンド引数を正しく指定
API 実行で例外が発生ExecutionSettings の設定不備assemblyNames やフィルタを見直す

次に読む記事

訪問数 1,062 回, 今日の訪問数 1回

広告

C#,Test,Unity

Posted by hidepon