PublishCodeCoverageResults@2 - Menerbitkan tugas hasil cakupan kode v2

Artikel
11/08/2024

Gunakan tugas ini untuk mendapatkan hasil cakupan kode dari build.

Sintaksis

# Publish code coverage results v2
# Publish any of the code coverage results from a build.
- task: PublishCodeCoverageResults@2
  inputs:
    summaryFileLocation: # string. Required. Path to summary files. 
    #pathToSources: # string. Path to Source files. 
    #failIfCoverageEmpty: false # boolean. Fail if code coverage results are missing. Default: false.

Input

summaryFileLocation - Jalur ke 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. Informasi selengkapnya tentang pola minimatch.

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.

failIfCoverageEmpty - Gagal jika 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 dan setelah menghasilkan file xml cakupan untuk mendapatkan tab cakupan kode dan detail pelaporan cakupan dalam alur. Tugas ini mendukung cakupan kode yang dihasilkan format xml. Tugas ini menghasilkan file cjson yang berisi detail cakupan kode. Ini juga akan menghasilkan laporan HTML cakupan kode di bawah artefak build.

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.

Prasyarat- Untuk menggunakan tugas Terbitkan Hasil Cakupan Kode v2 dalam alur, gunakan tugas dotnet 7.0.x sebagai prasyarat dalam alur. Gunakan tugas inti dotnet sebelum tugas Terbitkan Cakupan Kode v2.

Prasyarat

Untuk mengonfigurasi prasyarat menggunakan alur YAML:

# Dotnet core sdk task 7.0.x
- task: UseDotNet@2
  displayName: 'Use .NET Core sdk 7.0.x'
  inputs:
    version: 7.0.x

Untuk mengonfigurasi prasyarat menggunakan perancang:

Cuplikan layar yang memperlihatkan tugas .Net Core Sdk dalam alur.

Konfigurasikan tugas Terbitkan Hasil Cakupan Kode versi 2 menggunakan pengaturan berikut.
Setelah build selesai dan tugas Terbitkan Hasil Cakupan Kode v2 berhasil, pilih tab Cakupan Kode di ringkasan eksekusi alur untuk melihat hasil cakupan kode.

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.

Masalah yang diketahui

Tugas hasil cakupan kode publikasi v2 menghasilkan file cjson dan menerbitkan laporan cakupan kode di bawah tab cakupan kode. Ini juga menghasilkan artefak build yang merupakan sekumpulan file HTML yang ditautkan dari file index.html utama. Jika tab cakupan kode gagal menampilkan laporan cakupan kode, periksa apakah file xml cakupan kode input dalam format yang benar dan memiliki detail yang valid.

Persyaratan

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

Lihat juga

Menerbitkan Hasil Pengujian

Bagikan melalui