初めてのUnity Test Framework ― 基礎から動かし方まで完全ガイド
Unity Test Framework と Test Runner
Unity Test Framework は、NUnit を土台にした Unity のテスト機能です。Unity 6.6 では Editor と一緒に配布されるコアパッケージで、パッケージのバージョンは Editor に対応します。Test Runner は、テストを選んで実行し、結果を表示する Editor ウィンドウです。Window > General > Test Runner から開きます。
| 実行モード | 実行環境 | 例 |
|---|---|---|
| Edit Mode | Editor の編集モード | 計算、データ変換、Editor 拡張 |
| Play Mode | Editor の再生モード、または対応する Player | MonoBehaviour の更新、物理、ゲーム中の動作 |
その場で完了する検証は [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 やフィルタを見直す |
次に読む記事
- 最初のテストを書く。 Edit Mode の Calculator
- テストから本体コードを参照する。 アセンブリ定義の設定
- フレームをまたぐ動きを確かめる。 Play Mode のコイン回収 · カウントダウンタイマー
- 期待値を表現する。 Assert サンプル集
- 変更のたびに自動実行する。 GitHub Actions でのテストとビルド










ディスカッション
コメント一覧
まだ、コメントがありません