テスト レポート

これらの機能では、各セクションで説明されているように、追加の NuGet パッケージをインストールする必要があります。

ヒント

Microsoft.Testing.Platform.MSBuild (MSTest、NUnit、xUnit ランナーによって推移的に含まれる) を使用する場合、これらの拡張機能は NuGet パッケージをインストールするときに自動的に登録されます。コードの変更は必要ありません。 この記事で指定されている手動登録は、 <GenerateTestingPlatformEntryPoint>false</GenerateTestingPlatformEntryPoint>設定して自動生成されたエントリ ポイントを無効にした場合にのみ必要です。

Visual Studio テスト レポート (TRX)

Visual Studioテスト結果ファイル (または TRX) は、テスト結果を発行するための既定の形式です。 この拡張機能には、 Microsoft.Testing.Extensions.TrxReport NuGet パッケージが必要です。

手動登録

var builder = await TestApplication.CreateBuilderAsync(args);
builder.AddTrxReportProvider();

注

手動登録を使用する場合は、TRX レポート プロバイダーを最後に登録します。 現在の実装は登録順序に依存するため、他のすべての拡張機能の後に登録すると、すべてのテスト データが確実にキャプチャされます。

オプション

Option	[説明]
--report-trx	TRX レポートを生成します。
--report-trx-filename	生成された TRX レポートの名前。 既定の名前は、次の形式の <UserName>_<MachineName>_<yyyy-MM-dd_HH_mm_ss.fffffff>.trxと一致します。

レポートは、コマンド ライン引数を使用して指定できる既定の --results-directory フォルダー内に保存されます。

Azure DevOps レポート

Azure DevOps レポート プラグインは、GitHubでコードをホストし、Azure DevOpsのビルド エージェントでビルドを行う開発者のために、テストの実行を強化します。 エラーに追加情報が追加され、GitHub PR でエラーが直接表示されます。

この拡張機能には、 Microsoft.Testing.Extensions.AzureDevOpsReport NuGet パッケージが必要です。

手動登録

var builder = await TestApplication.CreateBuilderAsync(args);
builder.TestHost.AddAzureDevOpsProvider();

オプション

Option	[説明]
--report-azdo	Azure DevOps レポート ジェネレーターを有効にします。 エラーと警告は、Azure DevOps理解できる形式で出力に書き込まれます。
--report-azdo-severity	報告されたイベントに適用する重大度。 有効な値は error (既定値) と warningです。
--report-azdo-flaky-history	クエリAzure DevOps過去 N 日間のテスト結果履歴 (1 ~ 90) で、報告されたエラーにフラキネス コンテキストで注釈を付けます。 --report-azdo が必要です。
--report-azdo-demote-known-flaky	Azure DevOps履歴ウィンドウで十分に不安定なエラー (既定のしきい値は 25%) をエラーから警告に降格します。 --report-azdoと--report-azdo-flaky-historyが必要です。
--report-azdo-quarantine-file	隔離されたテストの完全修飾名またはグロブ パターンを列挙したテキスト ファイルへのパス。 一致するエラーは警告として報告されます。 --report-azdo が必要です。
--report-azdo-upload-artifacts	テスト結果ファイルをアップロードしたり、ビルド タグをAzure DevOpsに追加したりします。 有効な値は、 off (既定値)、 tags-only、 files、および allです。
--report-azdo-upload-artifact-include	テスト結果ディレクトリに対する glob パターンを使用して、Azure DevOps成果物のアップロードにファイルを含めます。 既定値は **/* です。 --report-azdo-upload-artifactsがoff以外の値である必要があります。
--report-azdo-upload-artifact-exclude	テスト結果ディレクトリに対する glob パターンを使用して、Azure DevOps成果物のアップロードからファイルを除外します。 --report-azdo-upload-artifactsがoff以外の値である必要があります。
--report-azdo-upload-artifact-name	Azure DevOps成果物コンテナー名をオーバーライドします。 既定値は TestResults_{assemblyName}_{tfm} です。 --report-azdo-upload-artifactsがoff以外の値である必要があります。
--publish-azdo-test-results	テスト結果を Azure DevOps Tests タブに公開します。
--publish-azdo-run-name	ライブ テスト結果の発行用のカスタム Azure DevOpsテスト実行名を設定します。 --publish-azdo-test-results が必要です。

注

MTP 1.9.0 (--report-azdo および --report-azdo-severity) でAzure DevOps拡張機能が安定しました。 この表の他のすべてのオプション ( --report-azdo-flaky-history、 --report-azdo-demote-known-flaky、 --report-azdo-quarantine-file、 --report-azdo-upload-artifacts、 --report-azdo-upload-artifact-include、 --report-azdo-upload-artifact-exclude、 --report-azdo-upload-artifact-name、 --publish-azdo-test-results、 --publish-azdo-run-name ) は、バージョン 2.3.0 以降の MTP で使用できます。

拡張機能は、 TF_BUILD 環境変数を確認することで、継続的インテグレーション (CI) 環境で実行されていることを自動的に検出します。