テストを実行およびデバッグする

MTP テスト プロジェクトは、直接実行 (またはデバッグ) できる実行可能ファイルとしてビルドされます。 コンソールやコマンドを実行する追加のテストはありません。 エラーが発生した場合、アプリは 0 以外の終了コードで終了します。これは、ほとんどの実行可能ファイルに一般的です。 既知の終了コードの詳細については、 MTP 出口コードを参照してください。

ヒント

コマンド ライン オプションを使用して、特定の --ignore-exit-code を無視できます。

TestingPlatformCommandLineArguments MSBuild プロパティを使用して、project ファイル内の特定のテスト projectに適用されるコマンド ライン オプションを設定することもできます。 一般的なユース ケースの 1 つは、すべてのテストが無視されたテスト プロジェクトの場合です。通常、終了コード 8 で終了します (テスト セッションではゼロ テストが実行されました)。 このシナリオでは、project ファイルの PropertyGroup の下に次を追加できます。

<TestingPlatformCommandLineArguments>$(TestingPlatformCommandLineArguments) --ignore-exit-code 8</TestingPlatformCommandLineArguments>

Important

既定では、MTP はテレメトリを収集します。 オプトアウトの詳細とオプションについては、 MTP テレメトリを参照してください。

注

バージョン 2.3.0 以降の MTP で使用できます。

グレースフル ストップの場合は、Ctrl+キーを 1 回押してキャンセルを要求します。 テストを実行すると、ティアダウンを完了できます。 すぐに終了するには、 Ctrl+C キーをもう一度押します。

dotnet publish を使用してテスト projectを発行し、アプリを直接実行することは、テストを実行するもう 1 つの方法です。 たとえば、./Contoso.MyTests.exe を実行します。 一部のシナリオでは、dotnet build を使って実行可能ファイルを生成することもできますが、ネイティブ AOT などのエッジ ケースを考慮する必要がある場合があります。

dotnet run を使用する

dotnet run コマンドを使用して、テスト projectをビルドして実行できます。 これはテストを実行する最も簡単な方法ですが、最も時間がかかることがあります。 dotnet run の使用は、テストをローカルで編集して実行する場合に実用的です。これは、必要に応じてテスト projectが再構築されるようにするためです。 dotnet run では、現在のフォルダー内のプロジェクトも自動的に検索されます。

dotnet run --project Contoso.MyTests

dotnet run の詳細については、「dotnet run」を参照してください。

dotnet exec を使用する

dotnet exec または dotnet コマンドは、既にビルドされているテスト projectを実行 (または実行) するために使用されます。これは、アプリケーションを直接実行する代わりに使用します。 dotnet exec には、ビルドされたテスト プロジェクト dll へのパスが必要です。

dotnet exec Contoso.MyTests.dll

または

dotnet Contoso.MyTests.dll

注

テストプロジェクトの実行可能ファイル (*.exe) へのパスを指定すると、エラーが発生します。

Error:
  An assembly specified in the application dependencies manifest
  (Contoso.MyTests.deps.json) has already been found but with a different
  file extension:
    package: 'Contoso.MyTests', version: '1.0.0'
    path: 'Contoso.MyTests.dll'
    previously found assembly: 'S:\t\Contoso.MyTests\bin\Debug\net10.0\Contoso.MyTests.exe'

dotnet exec の詳細については、dotnet exec に関するページを参照してください。

dotnet test を使用する

.NET 10 SDK 以降、dotnet testには専用の MTP モードがあります。 global.jsonで MTP を選択するか、.NET 11 以降のDOTNET_TEST_RUNNER環境変数を使用します。 専用モードでは、新しい SDK バージョンのプロジェクト、ソリューション、ビルドされたテスト モジュール、追加の入力の種類がサポートされます。

dotnet test --test-modules Contoso.MyTests.dll

VSTest 互換モードからのランナーの選択と移行については、「dotnet testを使用したテスト」を参照してください。

こちらも参照ください

  • 最終更新: