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

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

ヒント

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

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

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

Important

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

.NET CLI

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

dotnet run を使用する

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

dotnet run --project Contoso.MyTests

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

dotnet exec を使用する

dotnet exec または dotnet コマンドは、既にビルドされているテスト プロジェクトを実行するために使われます。これは、アプリケーションを直接実行する代わりの方法です。 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 を使用する

Microsoft.Testing.Platform には、vstest.console.exe および dotnet test との互換性レイヤーが用意されており、新しい実行シナリオを有効にしながら、以前と同様にテストを実行できるようにします。

dotnet test Contoso.MyTests.dll

Visual Studio

Microsoft.Testing.Platform テストは Visual Studio で実行 (およびデバッグ) でき、テスト エクスプローラーと統合されています。また、スタートアップ プロジェクトとして直接実行することもできます。

Visual Studio でアプリを実行する

Microsoft.Testing.Platform テスト プロジェクトは実行可能ファイルとしてビルドされ、直接実行できます。 これにより、フィルターが指定されていない限り、指定された実行可能ファイルのすべてのテストが実行されます。

1. ソリューション エクスプローラーで実行するテスト プロジェクトに移動し、それを右クリックして [スタートアップ プロジェクトとして設定] を選びます。
2. [デバッグ]>[デバッグなしで開始] (または Ctrl+F5 キーを使用) を選択して、選択したテスト プロジェクトを実行します。

コンソール ウィンドウがポップアップ表示され、テスト実行の実行内容と概要が表示されます。

Visual Studio でアプリを直接デバッグする

Microsoft.Testing.Platform テスト プロジェクトは直接デバッグできます。 フィルターが指定されていない限り、指定された実行可能ファイルのすべてのテストをデバッグするには、次のようにします。

1. ソリューション エクスプローラーで実行するテスト プロジェクトに移動し、それを右クリックして [スタートアップ プロジェクトとして設定] を選びます。
2. デバッグするテストにブレークポイントを設定します。
3. [デバッグ]>[デバッグの開始] に移動して (または F5 キーを押して)、選んだテスト プロジェクトをデバッグします。

ブレークポイントのあるテストに達するまで、すべてのテストが実行されます。 テストをステップ実行してデバッグします。 デバッグが完了したら、アプリを停止しない限り、残りのすべてのテストの実行が再開されます。

テスト エクスプローラーの使用

テストを実行するには、テスト エクスプローラーに移動して、実行する 1 つまたは複数のテストを選びます。 右クリックして、[実行] を選びます。 テストをデバッグする場合と同様に、テスト エクスプローラーで 1 つまたは複数のテストを選び、右クリックして [デバッグ] を選びます。

注

プロジェクトをビルドせずにテストを自動更新することはできません。

Visual Studio Code

C# 拡張機能と C# Dev Kit を使用すると、Visual Studio コードでテストをデバッグまたは実行できるほか、Visual Studio Code のテスト エクスプローラーとの統合を追加できます。

Visual Studio Code でアプリを実行する

Microsoft.Testing.Platform テスト プロジェクトは実行可能ファイルとしてビルドされ、直接実行できます。 これにより、フィルターが指定されていない限り、指定された実行可能ファイルのすべてのテストが実行されます。

1. テストを実行するテスト ファイルに移動してください。
2. Ctrl+F5 キーを押して、選択したテスト プロジェクトを実行してください。 複数のプロジェクトがある場合は、実行するプロジェクトを選択するように求めるポップアップが表示されます。

コンソール ウィンドウがポップアップ表示され、テスト実行の実行内容と概要が表示されます。

Visual Studio Code でアプリを直接デバッグする

Microsoft.Testing.Platform テスト プロジェクトは実行可能ファイルとしてビルドされ、直接実行できます。 これにより、フィルターが指定されていない限り、指定された実行可能ファイルのすべてのテストが実行されます。

1. テストを実行するテスト ファイルに移動してください。
2. F5 キーを使用して、選択したテスト プロジェクトをデバッグしてください。 複数のプロジェクトがある場合は、実行するプロジェクトを選択するように求めるポップアップが表示されます。

ヒント

ソリューション エクスプローラーからの実行や、対応する起動構成の作成など、C# DevKit を使用して dotnet プロジェクトを実行する方法は他にもいくつかあります。 これらは、Visual Studio Code のドキュメントで指定されています。

プロジェクトが実行されると、出力タブが表示され、テストの実行の実行と概要が表示されます。

テスト エクスプローラーの使用

テストを実行するには、テスト エクスプローラーに移動して、実行する 1 つまたは複数のテストを選びます。 右クリックして、[実行] を選びます。 テストをデバッグする場合と同様に、テスト エクスプローラーで 1 つまたは複数のテストを選び、右クリックして [デバッグ] を選びます。

注

プロジェクトをビルドせずにテストを自動更新することはできません。

継続的インテグレーション (CI)

• CI で 1 つのテスト プロジェクトを実行するには、Azure DevOps で次のように、実行するテスト実行可能ファイルごとに 1 つのステップを追加します。

  - task: CmdLine@2
    displayName: "Run Contoso.MyTests"
    inputs:
      script: '.\Contoso.MyTests\bin\Debug\net10.0\Contoso.MyTests.exe'
  

• 一般的なローカル ワークフローと同様に、 dotnet test コマンドを手動で実行します。

  - task: CmdLine@2
    displayName: "Run tests"
    inputs:
      script: 'dotnet test' # add command-line options as needed
  

• DotNetCoreCLI Azure タスクのテスト コマンドで実行します。 これには、テスト ランナーとして Microsoft.Testing.Platform を指定するリポジトリ ルート内の global.json ファイルが必要です。

  {
      "test": {
          "runner": "Microsoft.Testing.Platform"
      }
  }
  

  - task: DotNetCoreCLI@2
    displayName: "Run tests"
    inputs:
      command: test
  

  注

  DotNetCoreCLIでの Microsoft.Testing.Platform のサポートは、タスクの 2.263.0 バージョンで追加されました。

こちらも参照ください

• Microsoft.Testing.Platform の概要
• Microsoft.Testing.Platform CLI オプション リファレンス
• を使用したテスト dotnet test