PublishCodeCoverageResults@1 - Kod kapsamı sonuçlarını yayımlama v1 görevi

Derlemeden Cobertura veya JaCoCo kod kapsamı sonuçlarını yayımlamak için bu görevi kullanın.

Önemli

Bu görev kullanım dışı bırakıldı. Kullanıcıların PublishCodeCoverageResults@2 geçmeleri önerilir. Daha fazla bilgi için bkz. Kod Kapsamı Sonuçlarını Yayımla görevinin yeni sürümü.

Syntax

# Publish code coverage results v1
# [DEPRECATION WARNING! Users are recommended to switch to version 2*.] Publish Cobertura or JaCoCo code coverage results from a build.
- task: PublishCodeCoverageResults@1
  inputs:
    codeCoverageTool: 'JaCoCo' # 'Cobertura' | 'JaCoCo'. Required. Code coverage tool. Default: JaCoCo.
    summaryFileLocation: # string. Required. Summary file. 
    #pathToSources: # string. Path to Source files. 
    #reportDirectory: # string. Report directory. 
    #additionalCodeCoverageFiles: # string. Additional files. 
    #failIfCoverageEmpty: false # boolean. Fail when code coverage results are missing. Default: false.

Girişler

codeCoverageTool - Kod kapsamı aracı
string. Gereklidir. İzin verilen değerler: Cobertura, JaCoCo. Varsayılan değer: JaCoCo.

Kod kapsamı sonuçları oluşturan aracı belirtir.

summaryFileLocation - Özet dosyası
string. Gereklidir.

Satır, yöntem ve sınıf kapsamı gibi kod kapsamı istatistiklerini içeren özet dosyasının yolunu belirtir. Birden çok özet dosyası tek bir raporda birleştirilir. Değer, minimatch desenleri içerebilir. Örneğin: $(System.DefaultWorkingDirectory)/MyApp/**/site/cobertura/coverage.xml.

pathToSources - Kaynak dosyaların yolu
string.

Kapsam XML raporları kaynak dosyaların mutlak yolunu içermediğinde kaynak dosyalara bir yol belirtmek gerekir. Örneğin, JaCoCo raporları mutlak yollar kullanmaz, bu nedenle Java uygulamaları için JaCoCo kapsamını yayımlarken desen ile $(System.DefaultWorkingDirectory)/MyApp/src/main/java/benzerdir. Bu giriş, konak üzerindeki kaynak dosyaların mutlak yoluna işaret etmelidir. Örneğin, $(System.DefaultWorkingDirectory)/MyApp/.

Testler bir Docker kapsayıcısında çalıştırılırsa bu giriş kullanılabilir.

Her liste öğesini karakteriyle ; sınırlandırarak birden çok kaynak eklenebilir, örneğin pathToSources: $(System.DefaultWorkingDirectory)/path/to/first/source;$(System.DefaultWorkingDirectory)/path/to/second/source.

reportDirectory - Rapor dizini
string.

Kod kapsamı HTML rapor dizininin yolunu belirtir. Rapor dizini daha sonra derlemenin yapıtı olarak görüntülenmek üzere yayımlanır. Değer, minimatch desenleri içerebilir. Örneğin: $(System.DefaultWorkingDirectory)/MyApp/**/site/cobertura.

additionalCodeCoverageFiles - Ek dosyalar
string.

Dosya yolu desenini belirtir ve derlemenin yapıtları olarak yayımlanacak ek kod kapsamı dosyalarını not eder. Değer, minimatch desenleri içerebilir. Örneğin: $(System.DefaultWorkingDirectory)/**/*.exec.

failIfCoverageEmpty - Kod kapsamı sonuçları eksik olduğunda başarısız olur
boolean. Varsayılan değer: false.

Kod kapsamı yayımlamak için herhangi bir sonuç üretmediyse görev başarısız olur.

Görev denetim seçenekleri

Tüm görevlerde görev girişlerine ek olarak denetim seçenekleri vardır. Daha fazla bilgi için bkz . Denetim seçenekleri ve ortak görev özellikleri.

Çıkış değişkenleri

Yok.

Açıklamalar

Önemli

Bu görev kullanım dışı bırakıldı. Kullanıcıların PublishCodeCoverageResults@2 geçmeleri önerilir. Daha fazla bilgi için bkz. Kod Kapsamı Sonuçlarını Yayımla görevinin yeni sürümü.

Not

Kod Kapsamı Sonuçlarını Yayımla görevinin V2'deki yeni özellikler ve V1'den V2'ye geçiş hakkında bilgi için Bkz. Azure DevOps blogunda Kod Kapsamı Sonuçlarını Yayımla görevinin yeni sürümü.

Kapsam raporlaması almak için testleri Azure Pipelines veya TFS'de çalıştırırken üretilen kod kapsamı sonuçlarını yayımlamak için bu görevi derleme işlem hattında kullanın. Görev , Cobertura ve JaCoCo gibi popüler kapsam sonuç biçimlerini destekler.

Bu görev yalnızca derleme işlem hatlarında desteklenir, yayın işlem hatlarında desteklenmez.

Visual Studio Test, .NET Core, Ant, Maven, Gulp ve Grunt gibi görevler de işlem hattında kod kapsamı verileri yayımlama seçeneği sağlar. Bu görevleri kullanıyorsanız işlem hattında ayrı bir Kod Kapsamı Sonuçlarını Yayımla görevine ihtiyacınız yoktur.

HTML kod kapsamı raporunu oluşturmak için aracıda dotnet framework 2.0.0 veya üzeri gerekir. dotnet klasörü ortam yolunda olmalıdır. Dotnet içeren birden çok klasör varsa, 2.0.0 sürümüne sahip olan klasör yol listesindeki diğer klasörlerden önce olmalıdır.

YAML kullanarak İstanbul ile JavaScript için kod kapsamı sonuçları

YAML kullanarak JavaScript'e yönelik kod kapsamı sonuçlarını İstanbul ile yayımlamak için, diğer dillere yönelik örnekler de içeren bu konuların Ekosistemler bölümündeki JavaScript'i özelleştirme bölümüne bakın.

Cobertura kullanarak kod kapsamı yayımlama örneğine bakın.

Docker

Docker kullanan uygulamalar için derleme ve testler kapsayıcı içinde çalıştırılabilir ve kapsayıcı içinde kod kapsamı sonuçları oluşturabilir. Sonuçları işlem hattında yayımlamak için, sonuçta elde edilen yapıtlar Kod Kapsamı Sonuçlarını Yayımla görevinde kullanılabilir hale getirilmelidir. Başvuru için, Docker için Bir Docker dosyasıyla sonuçları derleme, test etme ve yayımlama bölümünde test sonuçlarını yayımlamaya yönelik benzer bir örnek görebilirsiniz.

Sonuçları görüntüleme

İşlem hattındaki kod kapsamı sonuçlarını görüntülemek için bkz. Kod kapsamı sonuçlarını gözden geçirme.

Göreve giriş olarak birden çok dosya sağlandığında veya işlem hattında birden çok görev kullanıldığında kod kapsamı verileri birleştirilir mi?

Şu anda, bu görev tarafından sağlanan kod kapsamı raporlama işlevselliği sınırlıdır ve kapsam verilerini birleştirmez. Göreve giriş olarak birden çok dosya sağlarsanız, yalnızca ilk eşleşme dikkate alınır. İşlem hattında birden çok yayımlama kodu kapsamı görevi kullanıyorsanız, son görev için özet ve rapor gösterilir. Daha önce karşıya yüklenen veriler yoksayılır.

Bilinen sorunlar

Kod kapsamı sonuçlarını yayımlama görevi, ana index.html dosyasından bağlanan bir DIZI HTML dosyası olan HTML raporunu oluşturur ve yayımlar. Kod kapsamı sekmesi kod kapsamı raporunu gösteremezse, index.html dosyasının boyutunun 7 MB'a yakın mı yoksa 7 MB'tan büyük mü olduğunu denetleyin. Dosyanın boyutunu denetlemek için aşağıdaki adımları tamamlayın. Ardından, dosya boyutu 7 MB'a yakın veya daha büyükse, kapsam raporunu görüntülemek için aşağıdaki geçici çözümü kullanabilirsiniz.

1. Derleme Özeti sekmesini ve ardından yayımlanan bağlantıyı seçin:

   

2. Kod Kapsamı Report_* yapıtın yanındaki Yapıtları indir'i seçin:

   

3. Kod kapsamı raporu indirildiğinde .zip dosyasını ayıklayın.

4. Kod kapsamı raporunda, dosya boyutunun burada açıklanan soruna neden olup olmadığını saptamaya yardımcı olmak için index.html boyutunu denetleyin.

5. Kod kapsamı raporunu görüntülemek için tarayıcıda index.html açın.

Gereksinimler

Gereksinim	Açıklama
İşlem hattı türleri	YAML, Klasik derleme
Üzerinde çalışır	Agent, DeploymentGroup
Talep	Hiçbiri
Özellikler	Bu görev, işteki sonraki görevler için hiçbir talebi karşılamaz.
Komut kısıtlamaları	Herhangi biri
Ayarlanabilir değişkenler	Bu görevin şu değişkenleri ayarlama izni var: Değişkenleri ayarlama devre dışı bırakıldı
Aracı sürümü	2.182.1 veya üzeri
Görev kategorisi	Test etme

Ayrıca bkz.

• Test Sonuçlarını Yayımla