ドキュメント

サポート

単体テスト

Enable and configure unit tests in Unity Build Automation to catch issues early and ensure code quality.
読み終わるまでの所要時間 1 分最終更新 1ヶ月前

ビルドターゲット 設定の単体テストを有効にして、問題を早期に検出し、コード品質を確保し、デプロイ前のリグレッションを防止できます。Unity Build Automation (UBA) では、ビルドプロセスの一環として単体テストを実行するための統合サポートを提供します。UBA は 編集モード再生モード の両方のテストをサポートし、テスト実行を制御し、失敗をハンドルするオプションがあります。 Unity エディターマニュアルの 編集モードと再生モードでのテスト を参照してください。

単体テストの有効化

Unity Dashboard で単体テストを有効化し、構成します。
  1. Build Automation > Configurations (設定) を選択します。
  2. 編集 (鉛筆) アイコンを選択して、ビルドターゲット設定を開きます。
  3. Advanced Settings (詳細設定) を選択します。
  4. Tests (テスト) セクションで、有効にする テストオプション を選択します。
  5. Save changes (変更を保存) を選択します。
テストを有効にすると問題が発生する場合は、プロジェクトのテストアセンブリを正しく設定し、スクリプトを、例えば
Assets/Tests
などの適切なディレクトリに配置します。UBA でビルドを実行する前に、Unity エディターの Test Runner を使用してテストが検出されることを確認します。

テストの設定オプション

以下のテストオプションが利用可能です。

テストの設定オプション

説明

ビルド時にプロジェクトの単体テストを実行単体テストはビルドの実行時に実行されます。
EditMode テストを実行編集モードのテストは、ビルドの実行時に実行されます。
PlayMode テストを実行再生モードテストは、ビルドの実行時に実行されます。
テストが失敗した場合はビルドを失敗とマークUBA は、単体テストスイートに失敗したビルドを、ビルドが成功したとしても、失敗としてマークします。

テスト結果へのアクセスとレビュー

UBA は、ビルドログとアーティファクトにテスト結果を提供します。ビルドの完了後:
  1. Unity Dashboard の Build History (ビルド履歴) セクションに移動します。
  2. 完成したビルドを選択して詳細を表示します。
  3. テストサマリーをレビューして、テストの成功数、失敗数、スキップ数を確認します。
  4. 徹底分析の詳細なテストレポートをダウンロードします。
UBA 単体テストビュー

UBA 単体テストビュー

結果が見つからないか不完全な場合は、以下の解決策を確認してください。
  • ビルドログ で、テスト実行に関連する警告やエラーを確認します。
  • テストに適切なタグを付け、認識されたテストフォルダーに配置したことを確認します。