這些擴充功能會在測試時擷取證據,讓你事後能診斷故障。 每個擴充套件都需要額外的 NuGet 套件,如各節所述。
提示
使用 Microsoft.Testing.Platform.MSBuild (由 MSTest、NUnit 和 xUnit 測試框架間接包含)時,這些擴充套件會在安裝 NuGet 套件時自動註冊,不需要改動程式碼。 本文所規定的手動註冊僅在你透過設定 <GenerateTestingPlatformEntryPoint>false</GenerateTestingPlatformEntryPoint>關閉自動產生的入口點時才需要。
如需處理程序層級的診斷,請參閱相關的 當機與停止回應傾印 擴充功能;當測試主機當機或停止回應時,這些擴充功能會收集處理程序傾印檔案。
錄影機
影片錄製器會在測試執行期間錄製螢幕,並將擷取的影片作為成品附加到測試工作階段。 錄製功能需在每次執行時明確啟用,並由外部 ffmpeg 程序驅動;該程序必須可在 PATH 上使用,或透過明確路徑指定。 此擴充功能需要 Microsoft。Testing.Extensions.VideoRecorder NuGet 套件。
Note
從 2.3.0 版本起,已支援 MTP。 此擴充仍屬實驗性質,未來版本可能會改變選項與輸出格式。
手動註冊
var builder = await TestApplication.CreateBuilderAsync(args);
builder.AddVideoRecorderProvider();
選項
| 選項 | MTP 版本 | Description |
|---|---|---|
--capture-video |
2.3.0 | 啟用螢幕錄影。 選用值會控制保留方式:on-failure(預設)只會保留失敗測試的錄影,而 always 會保留每項測試的錄影。 |
--capture-video-source |
2.3.0 | 設定擷取來源。 有效的值為 screen (預設值)和 window。 需要 --capture-video。 |
--capture-video-granularity |
2.3.0 | 設定錄影機是每次測試產生一段影片,還是整個測試只產生一段分章影片。 有效的值為 test (預設值)和 session。 需要 --capture-video。 |
--capture-video-max-duration |
2.3.0 | 透過保留大約最後 N 秒的影像,限制長距離播放的磁碟使用量。 該值為正整數秒。 需要 --capture-video。 |
--capture-video-chapters |
2.3.0 | 設定是否會在每次課程的影片中加入章節書籤。 有效的值為 on (預設值)和 off。 需要 --capture-video。 |
--capture-video-args |
2.3.0 | 將額外的參數傳遞給底層記錄器(ffmpeg)。 需要 --capture-video。 |