Not
Bu sayfaya erişim yetkilendirme gerektiriyor. Oturum açmayı veya dizinleri değiştirmeyi deneyebilirsiniz.
Bu sayfaya erişim yetkilendirme gerektiriyor. Dizinleri değiştirmeyi deneyebilirsiniz.
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.
Rapor dosyası adları
Her rapor uzantısı, dosyasını test sonuçları dizinine yazar ve bunu seçeneğiyle --results-directory ayarlayabilirsiniz. Adı geçersiz kılmak için eşleşen --report-*-filename seçeneği kullanın. Her rapor bölümünde bu rapor için varsayılan ad listelenir.
Dosya adı, test sonuçları dizininde kalan göreli bir yol içerebilir ve aşağıdaki değiştirme öğelerini (yer tutucular) kullanabilir:
| Yer tutucu | Description |
|---|---|
{asm} |
Giriş derlemesinin adı veya kullanılamadığında unknown. |
{tfm} |
Çalışma zamanında, örneğin net9.0 gibi bir hedef çerçeve tanımlayıcısı algılandı. |
{arch} |
x64, x86 veya arm64 gibi işlem mimarisi. |
{pname} |
İşlem adı. |
{pid} |
İşlem Kimliği. |
{time} |
Yüksek hassasiyetli zaman damgası. |
Örneğin, --report-trx-filename "{asm}_{tfm}_{arch}.trx" varsayılan TRX adını yeniden oluşturur.
Uyarı
Yer tutucu adları büyük/küçük harfe duyarlıdır ve küçük harfle yazılır. Rapor dosyası adları için yer tutucu desteği, 2.3.0 sürümünden itibaren MTP'de kullanılabilir.
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.
Uyarı
1.9.0 sürümünden itibaren MTP'de kullanılabilen TRX raporu test Description alanını içerir.
Uyarı
2.3.0 sürümünden itibaren MTP'de kullanılabilir, çalıştırma ilerledikçe TRX sonuçları diske akışla gönderilir. Test barındırıcısı çökerse, TRX dosyası çökmeden önce toplanan sonuçları korur.
Options
| Seçenek | Description |
|---|---|
--report-trx |
TRX raporunu oluşturur. |
--report-trx-filename |
Oluşturulan TRX raporunun adı. MTP 2.3.0'dan başlayarak, varsayılan ayar belirleyici {asm}_{tfm}_{arch}.trx formdur; MTP 2.3.0'dan önce varsayılan olarak şeklindedir <UserName>_<MachineName>_<yyyy-MM-dd_HH_mm_ss.fffffff>.trx. Adı özelleştirmek için bkz. Rapor dosyası adları. |
Rapor, komut satırı bağımsız değişkeni aracılığıyla belirtilebilen varsayılan --results-directory klasörüne kaydedilir.
HTML raporları
HTML raporu, test oturumu için etkileşimli, bağımsız bir HTML dosyası oluşturur. Bu uzantı, Microsoft.Testing.Extensions.HtmlReport NuGet paketini gerektirir.
Uyarı
2.3.0 sürümünden itibaren MTP'de kullanılabilir. Bu uzantı deneyseldir ve seçenekleri ve çıkış biçimi gelecekteki bir sürümde değişebilir.
El ile kayıt
var builder = await TestApplication.CreateBuilderAsync(args);
builder.AddHtmlReportProvider();
Options
| Seçenek | Description |
|---|---|
--report-html |
HTML raporunu oluşturur. |
--report-html-filename |
Oluşturulan HTML raporunun adı. Değer, .html ile bitmelidir. Varsayılan değer: {asm}_{tfm}_{arch}.html. Adı özelleştirmek için bkz. Rapor dosyası adları. gerektirir --report-html. |
JUnit raporları
JUnit raporu, test oturumu için JUnit uyumlu bir XML dosyası oluşturur. Bu uzantı, Microsoft.Testing.Extensions.JUnitReport NuGet paketini gerektirir.
Uyarı
2.3.0 sürümünden itibaren MTP'de kullanılabilir. Bu uzantı deneyseldir ve seçenekleri ve çıkış biçimi gelecekteki bir sürümde değişebilir.
El ile kayıt
var builder = await TestApplication.CreateBuilderAsync(args);
builder.AddJUnitReportProvider();
Options
| Seçenek | Description |
|---|---|
--report-junit |
JUnit XML raporunu oluşturur. |
--report-junit-filename |
Oluşturulan JUnit XML raporunun adı. Değer, .xml ile bitmelidir. Varsayılan değer: {asm}_{tfm}_{arch}.xml. Adı özelleştirmek için bkz. Rapor dosyası adları. gerektirir --report-junit. |
CTRF raporları
CTRF raporu, bir test oturumu için Ortak Test Raporu Biçimini kullanan bir JSON dosyası oluşturur. Bu uzantı, Microsoft.Testing.Extensions.CtrfReport NuGet paketini gerektirir.
Uyarı
2.3.0 sürümünden itibaren MTP'de kullanılabilir. Bu uzantı deneyseldir ve seçenekleri ve çıkış biçimi gelecekteki bir sürümde değişebilir.
El ile kayıt
var builder = await TestApplication.CreateBuilderAsync(args);
builder.AddCtrfReportProvider();
Options
| Seçenek | Description |
|---|---|
--report-ctrf |
CTRF JSON raporunu oluşturur. |
--report-ctrf-filename |
Oluşturulan CTRF JSON raporunun adı. Değer, .json ile bitmelidir. Varsayılan değer: <UserName>_<MachineName>_<assembly>_<tfm>_<timestamp>.ctrf.json. Adı özelleştirmek için bkz. Rapor dosyası adları. gerektirir --report-ctrf. |
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 | MTP sürümü | Description |
|---|---|---|
--report-azdo |
1.9.0 | Azure DevOps rapor oluşturucuyu etkinleştirir. Hatalar ve uyarılar çıkışa Azure DevOps anlayacağı biçimde yazılır. |
--report-azdo-severity |
1.9.0 | Bildirilen olaylar için kullanılacak önem derecesi. Geçerli değerler error (varsayılan) ve warning'dir. |
--report-azdo-flaky-history |
2.3.0 | 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 |
2.3.0 | 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 |
2.3.0 | 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-summary |
2.3.0 | Test çalıştırmasının sonunda Markdown biçiminde bir iş özeti yazar ve bunu ##vso[task.uploadsummary] aracılığıyla yükler. İsteğe bağlı bir dosya yolu bağımsız değişkeni, varsayılan konumu ({testResultsDir}/azdo-summary-{tfm}.md ) geçersiz kılar. gerektirir --report-azdo. |
--report-azdo-stackframe-filter |
2.3.0 | Uzantı açıklama eklemek için kullanıcının çağrı sitesini bulduğunda atlanan, her yığın çerçevesinin tam tür ön eki ile eşleşen regex desenleri ekler. Bu seçenek 16 desene kadar yinelenebilir ve her desen 500 ms eşleşme zaman aşımı ile derlenebilir. Bu desenler uzantının yerleşik MSTest onaylama-uygulama ön eklerine eklenir. gerektirir --report-azdo. |
--report-azdo-upload-artifacts |
2.3.0 | 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 |
2.3.0 | 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 |
2.3.0 | 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 |
2.3.0 | 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 |
2.3.0 | Test sonuçlarını canlı olarak Azure DevOps Tests sekmesinde yayımlar. |
--publish-azdo-run-name |
2.3.0 | Canlı test sonucu yayımlama için özel bir Azure DevOps test çalıştırması adı ayarlar. gerektirir --publish-azdo-test-results. |
Uyarı
MTP sürüm sütunu, her seçeneğin ilk olarak kararlı bir derlemede kullanıma sunulduğu MTP sürümünü listeler. Azure DevOps uzantısının kendisi, MTP 1.9.0’da --report-azdo ve --report-azdo-severity ile kararlı hale geldi; geri kalan seçenekler ise MTP 2.3.0’da eklendi.
Uzantı, ortam değişkenini denetleyerek TF_BUILD sürekli tümleştirme (CI) ortamında çalıştığını otomatik olarak algılar.
GitHub Actions raporları
GitHub Actions raporu, GitHub Actions’a özgü yerel iş akışı komutları üretir; böylece test çalıştırmaları çalıştırıcıda üst düzey bir deneyim sunar: derleme başına log grupları, başarısız ve atlanan test ek açıklamaları (iş akışındaki Annotations sekmesinde ve kaynak konumu çözümlendiğinde pull request’in Files changed fark görünümünde gösterilir), GITHUB_STEP_SUMMARY tarafından başvurulan dosyaya eklenen bir Markdown iş özeti ve yavaş test bildirimleri.
Uzantı yalnızca çalıştırma GitHub Actions üzerinde olduğunda ( GITHUB_ACTIONS ortam değişkeni true olduğunda) ve --report-gh anahtarı ayarlandığında etkinleştirilir; aksi takdirde hiçbir şey yapmaz. Etkin olduğunda, her özellik varsayılan olarak etkinleştirilir ve seçeneğiyle --report-gh-* tek tek kapatılabilir.
Uyarı
2.3.0 sürümünden itibaren MTP'de kullanılabilir. Bu uzantı deneyseldir ve seçenekleri ve çıkış biçimi gelecekteki bir sürümde değişebilir.
El ile kayıt
var builder = await TestApplication.CreateBuilderAsync(args);
builder.AddGitHubActionsProvider();
Options
| Seçenek | MTP sürümü | Description |
|---|---|---|
--report-gh |
2.3.0 | Test çalıştırmalarının iş akışı komutlarını yayması için GitHub Actions rapor oluşturucuyu etkinleştirir. Çalıştırmanın GitHub Actions üzerinde olmasını gerektirir. |
--report-gh-groups |
2.3.0 | Derleme başına log gruplarını etkinleştirir veya devre dışı bırakır. Geçerli değerler on (varsayılan) ve off'dir. gerektirir --report-gh. |
--report-gh-annotations |
2.3.0 | Başarısız ve atlanan testler için ek açıklamaları etkinleştirir veya devre dışı bırakır. Geçerli değerler on (varsayılan) ve off'dir. gerektirir --report-gh. |
--report-gh-step-summary |
2.3.0 |
GITHUB_STEP_SUMMARY ile belirtilen dosyaya bir Markdown iş özeti yazılmasını etkinleştirir veya devre dışı bırakır. Geçerli değerler on (varsayılan) ve off'dir. gerektirir --report-gh. |
--report-gh-slow-test-notices |
2.3.0 | Yavaş test bildirimlerini etkinleştirir veya devre dışı bırakır. Geçerli değerler on (varsayılan) ve off'dir. gerektirir --report-gh. |
--report-gh-slow-test-threshold |
2.3.0 | Yavaş test uyarısı verilmeden önce bir testin çalışabileceği süre. Yalın bir saniye sayısını veya 90s, 2m ya da 1.5h gibi birim sonekiyle belirtilen bir değeri kabul eder. Varsayılan değer: 60s. gerektirir --report-gh. |
GitHub'da bizimle işbirliği yapın
Bu içeriğin kaynağı GitHub'da bulunabilir; burada ayrıca sorunları ve çekme isteklerini oluşturup gözden geçirebilirsiniz. Daha fazla bilgi için katkıda bulunan kılavuzumuzu inceleyin.
