Test raporları

Bu özellikler, her bölümde açıklandığı gibi ek NuGet paketlerinin yüklenmesini gerektirir.

İpucu

Microsoft.Testing.Platform.MSBuild (MSTest, NUnit ve xUnit çalıştırıcıları tarafından geçişli olarak dahil) kullanılırken, NuGet paketlerini yüklediğinizde bu uzantılar otomatik olarak kaydedilir; kod değişikliği gerekmez. Bu makalede belirtilen el ile kayıt yalnızca ayarıyla <GenerateTestingPlatformEntryPoint>false</GenerateTestingPlatformEntryPoint>otomatik oluşturulan giriş noktasını devre dışı bırakmış olmanız durumunda gereklidir.

Visual Studio test raporları (TRX)

Visual Studio test sonucu dosyası (veya TRX), test sonuçlarını yayımlamak için varsayılan biçimdir. Bu uzantı , Microsoft.Testing.Extensions.TrxReport NuGet paketini gerektirir.

El ile kayıt

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

Uyarı

El ile kayıt kullanırken TRX rapor sağlayıcısını en son kaydedin. Geçerli uygulama kayıt sırasına bağlıdır, bu nedenle diğer tüm uzantılardan sonra kaydetmek tüm test verilerini yakalamasını sağlar.

Options

Seçenek	Description
--report-trx	TRX raporunu oluşturur.
--report-trx-filename	Oluşturulan TRX raporunun adı. Varsayılan ad, aşağıdaki biçimle <UserName>_<MachineName>_<yyyy-MM-dd_HH_mm_ss.fffffff>.trxeşleşir.

Rapor, komut satırı bağımsız değişkeni aracılığıyla belirtilebilen varsayılan --results-directory klasörüne kaydedilir.

Azure DevOps raporları

Azure DevOps rapor eklentisi, kodlarını GitHub üzerinde barındıran ancak Azure DevOps derleme aracılarını kullanan geliştiriciler için test çalıştırmayı geliştirir. GitHub PR'lerinde hataların doğrudan görünmesi için ek bilgiler ekler.

Bu uzantı için Microsoft.Testing.Extensions.AzureDevOpsReport NuGet paketi gerekir.

El ile kayıt

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

Options

Seçenek	Description
--report-azdo	Azure DevOps rapor oluşturucuyu etkinleştirir. Hatalar ve uyarılar çıkışa Azure DevOps anlayacağı biçimde yazılır.
--report-azdo-severity	Bildirilen olaylar için kullanılacak önem derecesi. Geçerli değerler error (varsayılan) ve warning'dir.
--report-azdo-flaky-history	Son N gün (1-90) için test sonucu geçmişini Azure DevOps sorgular ve bildirilen hatalara flakiness bağlamı ile açıklama ekler. gerektirir --report-azdo.
--report-azdo-demote-known-flaky	Azure DevOps geçmiş penceresinde, yeterince kararsız olan başarısızlıkları (varsayılan eşik %25’tir) hata olmaktan çıkarıp uyarı düzeyine düşürür. --report-azdo ve --report-azdo-flaky-history gerektirir.
--report-azdo-quarantine-file	Karantinaya alınmış testlerin tam nitelikli adlarını veya glob desenlerini listeleyen bir metin dosyasının yolu. Eşleştirme başarısızlıkları uyarı olarak raporlanır. gerektirir --report-azdo.
--report-azdo-upload-artifacts	Test sonucu dosyalarını yükler ve/veya Azure DevOps'a derleme etiketleri ekler. Geçerli değerler şunlardır off : (varsayılan), tags-only, filesve all.
--report-azdo-upload-artifact-include	Test sonuçları dizinine göre glob desenlerini kullanarak Azure DevOps yapıt yüklemesine dosya ekler. Varsayılan değer **/*’dır. --report-azdo-upload-artifacts değerinin off dışında bir değer olması gerekir.
--report-azdo-upload-artifact-exclude	Test sonuçları dizinine göre glob desenleri kullanarak dosyaları Azure DevOps yapıt yüklemesinin dışında tutar. --report-azdo-upload-artifacts değerinin off dışında bir değer olması gerekir.
--report-azdo-upload-artifact-name	Azure DevOps artefakt kapsayıcısı adını geçersiz kılar. Varsayılan değer TestResults_{assemblyName}_{tfm}’dır. --report-azdo-upload-artifacts değerinin off dışında bir değer olması gerekir.
--publish-azdo-test-results	Test sonuçlarını canlı olarak Azure DevOps Tests sekmesinde yayımlar.
--publish-azdo-run-name	Canlı test sonucu yayımlama için özel bir Azure DevOps test çalıştırması adı ayarlar. gerektirir --publish-azdo-test-results.

Uyarı

Azure DevOps uzantısı MTP 1.9.0'da kararlı hale geldi (--report-azdo ve --report-azdo-severity). Tablodaki diğer tüm seçenekler — --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 ve --publish-azdo-run-name — 2.3.0 sürümünden itibaren MTP'de kullanılabilir.

Uzantı, ortam değişkenini denetleyerek TF_BUILD sürekli tümleştirme (CI) ortamında çalıştığını otomatik olarak algılar.