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.

Derlemeden Cobertura veya JaCoCo kod kapsamı sonuçlarını yayımlayın.

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

Sözdizimi

# Publish code coverage results v1
- 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.
# Publish code coverage results v1
# 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.
# Publish Code Coverage Results v1
# 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. 
    #reportDirectory: # string. Report directory. 
    #additionalCodeCoverageFiles: # string. Additional files. 
    #failIfCoverageEmpty: false # boolean. Fail when code coverage results are missing. Default: false.

Giriş

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

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


summaryFileLocation - Özet dosyası
string. Gerekli.

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.


Kaynak dosyalara pathToSources - Yolu
string.

Kapsam XML raporları kaynak dosyaların mutlak yolunu içermediğinde kaynak dosyaların yolunu belirtmek gerekir. Örneğin, JaCoCo raporları mutlak yollar kullanmaz, bu nedenle Java uygulamaları için JaCoCo kapsamı yayımlarken desen $(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 öğesi ; karakteriyle sınırlandırılarak birden çok kaynak eklenebilir, örneğin pathToSources: $(System.DefaultWorkingDirectory)/path/to/first/source;$(System.DefaultWorkingDirectory)/path/to/second/source.


rapor dizini
string.

Kod kapsamı HTML rapor dizininin yolunu belirtir. Rapor dizini daha sonra derlemenin yapıtı olarak görüntülemek ü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
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 denetimi seçenekleri

Tüm görevlerin, 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

Hiç kimse.

Açıklamalar

Kapsam raporlaması elde etmek 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 JaCoCogibi 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, Gulpve Grunt gibi görevler de kod kapsamı verilerini işlem hattına yayımlama seçeneği sunar. 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ğerlerinden önce olmalıdır.

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

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

Coberturakullanarak kod kapsamını yayımlamanın bir ö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örevi için kullanılabilir hale getirilmelidir. Başvuru için, Dockeriçin Bir Docker dosyası ile sonuçları derleme, test etme ve yayımlama bölümünde test sonuçlarını yayımlamak için 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 veya daha büyük olup olmadığını 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 Özet sekmesini ve ardından yayımlanan bağlantısını seçin:

    özet bölmesinde yayımlanan bağlantıyı gösteren ekran görüntüsü .

  2. Kod Kapsamı Report_* yapıtın yanındaki Yapıtları indirseçin:

    Yapıtlar altındaki kod kapsamı raporu için Yapıtları indir bağlantısını gösteren ekran görüntüsü.

  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.

Gereksinim -leri

Gereksinim Açıklama
İşlem hattı türleri YAML, Klasik derleme
Üzerinde çalışır Agent, DeploymentGroup
Talepleri Hiç kimse
Özellikleri Bu görev, işteki sonraki görevler için herhangi bir talebi karşılamaz.
Komut kısıtlamaları Herhangi
Ayarlanabilir değişkenleri Bu görevin aşağıdaki 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
Gereksinim Açıklama
İşlem hattı türleri YAML, Klasik derleme
Üzerinde çalışır Agent, DeploymentGroup
Talepleri Hiç kimse
Özellikleri Bu görev, işteki sonraki görevler için herhangi bir talebi karşılamaz.
Komut kısıtlamaları Herhangi
Ayarlanabilir değişkenleri Herhangi
Aracı sürümü 2.102.0 veya üzeri
Görev kategorisi Test

Ayrıca bkz.

  • Test Sonuçlarını Yayımlama