PublishCodeCoverageResults@1 - Menerbitkan tugas hasil cakupan kode v1

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

Penting

Tugas ini tidak digunakan lagi. Pengguna disarankan untuk beralih ke PublishCodeCoverageResults@2. Untuk informasi selengkapnya, lihat Versi baru tugas Terbitkan Hasil Cakupan Kode.

Sintaks

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

Input

codeCoverageTool - Alat cakupan kode
string. Wajib diisi. Nilai yang diizinkan: Cobertura, JaCoCo. Nilai default: JaCoCo.

Menentukan alat yang menghasilkan hasil cakupan kode.

summaryFileLocation - File ringkasan
string. Wajib diisi.

Menentukan jalur file ringkasan yang berisi statistik cakupan kode, seperti cakupan baris, metode, dan 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 $(System.DefaultWorkingDirectory)/MyApp/src/main/java/dengan . Input ini harus menunjuk ke jalur absolut ke file sumber pada host. Contohnya,$(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.

reportDirectory - 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 ketika hasil cakupan kode hilang
boolean. Nilai default: false.

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

Opsi kontrol tugas

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

Variabel output

Tidak ada.

Keterangan

Penting

Tugas ini tidak digunakan lagi. Pengguna disarankan untuk beralih ke PublishCodeCoverageResults@2. Untuk informasi selengkapnya, lihat Versi baru tugas Terbitkan Hasil Cakupan Kode.

Catatan

Lihat Versi baru tugas Terbitkan Hasil Cakupan Kode di blog Azure DevOps untuk informasi tentang fitur baru di V2 dari tugas Terbitkan Hasil Cakupan Kode, dan migrasi dari V1 ke V2.

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 yang 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 dari topik ini, yang juga menyertakan contoh untuk bahasa lain.

Lihat contoh cakupan kode penerbitan menggunakan Cobertura.

Docker

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 tugas Terbitkan Hasil Cakupan Kode . Sebagai referensi, Anda dapat melihat contoh serupa untuk menerbitkan hasil pengujian di bawah bagian Bangun, uji, dan terbitkan dengan file Docker untuk Docker.

Melihat 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 penerbitan dalam alur, ringkasan dan laporan ditampilkan untuk tugas terakhir. 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

Persyaratan	Deskripsi
Jenis alur	YAML, Build klasik
Berjalan pada	Agen, DeploymentGroup
Permintaan	Tidak ada
Kemampuan	Tugas ini tidak memenuhi tuntutan 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	Uji

Lihat juga

• Menerbitkan Hasil Pengujian