PublishCodeCoverageResults@1 - Menerbitkan tugas hasil cakupan kode v1

Gunakan tugas ini untuk menerbitkan hasil cakupan kode Cobertura atau JaCoCo dari build.

Nota

PublishCodeCoverageResults@2 adalah versi terbaru tugas dan harus digunakan dalam alur Anda. Tugas v1 tidak akan digunakan lagi.

Sintaksis

# 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.

Input

alat cakupan kode
string. Diperlukan. Nilai yang diizinkan: Cobertura, JaCoCo. Nilai default: JaCoCo.

Menentukan alat yang menghasilkan hasil cakupan kode.

file Ringkasan
string. Diperlukan.

Menentukan jalur file ringkasan yang berisi statistik cakupan kode, seperti garis, metode, dan cakupan kelas. Beberapa file ringkasan digabungkan ke dalam satu laporan. Nilai mungkin berisi pola minimatch. Misalnya: $(System.DefaultWorkingDirectory)/MyApp/**/site/cobertura/coverage.xml.

pathToSources - Jalur ke file Sumber
string.

Menentukan jalur ke file sumber diperlukan saat laporan XML cakupan tidak berisi jalur absolut ke file sumber. Misalnya, laporan JaCoCo tidak menggunakan jalur absolut, jadi saat menerbitkan cakupan JaCoCo untuk aplikasi Java, polanya mirip dengan $(System.DefaultWorkingDirectory)/MyApp/src/main/java/. Input ini harus menunjuk ke jalur absolut ke file sumber pada host. Misalnya, $(System.DefaultWorkingDirectory)/MyApp/.

Input ini dapat digunakan jika pengujian dijalankan dalam kontainer Docker.

Beberapa sumber dapat ditambahkan dengan memisahkan setiap item daftar dengan karakter ;, misalnya pathToSources: $(System.DefaultWorkingDirectory)/path/to/first/source;$(System.DefaultWorkingDirectory)/path/to/second/source.

direktori Laporan
string.

Menentukan jalur direktori laporan HTML cakupan kode. Direktori laporan diterbitkan untuk dilihat nanti sebagai artefak build. Nilai mungkin berisi pola minimatch. Misalnya: $(System.DefaultWorkingDirectory)/MyApp/**/site/cobertura.

additionalCodeCoverageFiles - File tambahan
string.

Menentukan pola jalur file dan mencatat file cakupan kode tambahan yang akan diterbitkan sebagai artefak build. Nilai mungkin berisi pola minimatch. Misalnya: $(System.DefaultWorkingDirectory)/**/*.exec.

failIfCoverageEmpty - Gagal saat hasil cakupan kode hilang
boolean. Nilai default: false.

Gagal tugas jika cakupan kode tidak menghasilkan hasil apa pun untuk diterbitkan.

Opsi kontrol tugas

Semua tugas memiliki opsi kontrol selain input tugasnya. Untuk informasi selengkapnya, lihat opsi Kontrol dan properti tugas umum.

Variabel output

Tidak.

Komentar

Gunakan tugas ini dalam alur build untuk menerbitkan hasil cakupan kode yang dihasilkan saat menjalankan pengujian ke Azure Pipelines atau TFS untuk mendapatkan pelaporan cakupan. Tugas ini mendukung format hasil cakupan populer seperti Cobertura dan JaCoCo.

Tugas ini hanya didukung dalam alur build, bukan alur rilis.

Tugas seperti Visual Studio Test, .NET Core, Ant, Maven, Gulp, dan Grunt juga menyediakan opsi untuk menerbitkan data cakupan kode ke alur. Jika Anda menggunakan tugas-tugas ini, Anda tidak memerlukan tugas Terbitkan Hasil Cakupan Kode terpisah dalam alur.

Untuk menghasilkan laporan cakupan kode HTML, Anda memerlukan kerangka kerja dotnet 2.0.0 atau yang lebih baru pada agen. Folder dotnet harus berada di jalur lingkungan. Jika ada beberapa folder yang berisi dotnet, folder dengan versi 2.0.0 harus sebelum folder lain dalam daftar jalur.

Hasil cakupan kode untuk JavaScript dengan Istanbul menggunakan YAML

Untuk menerbitkan hasil cakupan kode untuk JavaScript dengan Istanbul menggunakan YAML, lihat Menyesuaikan JavaScript di bagian Ekosistem topik ini, yang juga menyertakan contoh untuk bahasa lain.

Lihat contoh cakupan kode penerbitan menggunakan Cobertura.

Buruh kapal

Untuk aplikasi yang menggunakan Docker, build dan pengujian dapat berjalan di dalam kontainer dan menghasilkan hasil cakupan kode dalam kontainer. Untuk menerbitkan hasil ke alur, artefak yang dihasilkan harus tersedia untuk Menerbitkan Hasil Cakupan Kode tugas. Sebagai referensi, Anda dapat melihat contoh serupa untuk menerbitkan hasil pengujian di bawah Membangun, menguji, dan menerbitkan hasil dengan file Docker bagian untuk Docker.

Lihat hasil

Untuk melihat hasil cakupan kode dalam alur, lihat Meninjau hasil cakupan kode.

Apakah data cakupan kode digabungkan ketika beberapa file disediakan sebagai input ke tugas atau beberapa tugas digunakan dalam alur?

Saat ini, fungsionalitas pelaporan cakupan kode yang disediakan oleh tugas ini terbatas, dan tidak menggabungkan data cakupan. Jika Anda menyediakan beberapa file sebagai input ke tugas, hanya kecocokan pertama yang dipertimbangkan. Jika Anda menggunakan beberapa tugas cakupan kode publikasi dalam alur, ringkasan dan laporan diperlihatkan untuk tugas terakhir. Setiap data yang diunggah sebelumnya diabaikan.

Masalah yang diketahui

Tugas hasil cakupan kode publikasi menghasilkan dan menerbitkan laporan HTML, yang merupakan sekumpulan file HTML yang ditautkan dari file index.html utama. Jika tab cakupan kode gagal menampilkan laporan cakupan kode, periksa apakah ukuran file index.html mendekati atau lebih besar dari 7 MB. Selesaikan langkah-langkah berikut untuk memeriksa ukuran file. Kemudian, jika ukuran file mendekati atau lebih besar dari 7 MB, Anda dapat menggunakan solusi berikut untuk melihat laporan cakupan.

1. Pilih tab Ringkasan build, lalu pilih tautan yang diterbitkan :

   

2. Di samping artefak Cakupan Kode Report_*, pilih Unduh artefak:

   

3. Saat laporan cakupan kode diunduh, ekstrak file .zip.

4. Dalam laporan cakupan kode, periksa ukuran index.html untuk membantu menentukan apakah ukuran file menyebabkan masalah yang dijelaskan di sini.

5. Buka index.html di browser untuk melihat laporan cakupan kode.

Persyaratan

Syarat	Deskripsi
Jenis alur	YAML, Build klasik
Berjalan pada	Agen, DeploymentGroup
Permintaan	Tidak
Kemampuan	Tugas ini tidak memenuhi tuntutan apa pun untuk tugas berikutnya dalam pekerjaan.
pembatasan Perintah	Apa pun
variabel yang Dapat Diatur	Tugas ini memiliki izin untuk mengatur variabel berikut: Pengaturan variabel dinonaktifkan
Versi agen	2.182.1 atau lebih tinggi
Kategori tugas	Ujian

Lihat juga

• Menerbitkan Hasil Pengujian