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

テストを実行する別の方法として、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

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

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 つまたは複数のテストを選び、右クリックして [デバッグ] を選びます。

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 キーを使用して、選択したテスト プロジェクトをデバッグしてください。 複数のプロジェクトがある場合は、実行するプロジェクトを選択するように求めるポップアップが表示されます。

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

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

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

• 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 バージョンで追加されました。