PublishCodeCoverageResults@2 - Pubblicare i risultati del code coverage v2

  • Articolo

Usare questa attività per ottenere i risultati di code coverage da una compilazione.

Sintassi

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

Ingressi

summaryFileLocation - Percorso dei file di riepilogo
string. Obbligatorio.

Specifica il percorso del file di riepilogo contenente statistiche di code coverage, ad esempio riga, metodo e copertura della classe. Più file di riepilogo vengono uniti in un singolo report. Il valore può contenere modelli di minimatch. Ad esempio: $(System.DefaultWorkingDirectory)/MyApp/**/site/cobertura/coverage.xml. Altre informazioni sui modelli di minimatch.


pathToSources - percorso dei file di origine
string.

Quando i report XML di copertura non contengono un percorso assoluto ai file di origine, è necessario specificare un percorso ai file di origine. Ad esempio, i report JaCoCo non usano percorsi assoluti, quindi quando si pubblica la copertura JaCoCo per le app Java, il modello è simile a $(System.DefaultWorkingDirectory)/MyApp/src/main/java/. Questo input deve puntare a un percorso assoluto ai file di origine nell'host. Ad esempio, $(System.DefaultWorkingDirectory)/MyApp/.

Questo input può essere usato se i test vengono eseguiti in un contenitore Docker.


failIfCoverageEmpty - Esito negativo se mancano i risultati del code coverage
boolean. Valore predefinito: false.

L'attività ha esito negativo se il code coverage non ha prodotto alcun risultato da pubblicare.


Opzioni di controllo attività

Tutte le attività hanno opzioni di controllo oltre ai relativi input di attività. Per altre informazioni, vedere Opzioni di controllo e proprietà comuni delle attività.

Variabili di output

Nessuno.

Osservazioni

Usare questa attività in una pipeline di compilazione per pubblicare i risultati del code coverage generati durante l'esecuzione di test in Azure Pipelines o TFS e dopo aver generato i file XML di copertura per ottenere i dettagli della scheda code coverage e dei report di code coverage nella pipeline. L'attività supporta i formati XML generati dal code coverage. Questa attività genera un file cjson che contiene i dettagli del code coverage. Produrrà anche un report HTML di code coverage sotto gli artefatti di compilazione.

Questa attività è supportata solo nelle pipeline di compilazione, non nelle pipeline di versione.

Attività come test di Visual Studio, .NET Core, Ant, Maven, Gulpe Grunt offrono anche la possibilità di pubblicare i dati di code coverage nella pipeline. Se si usano queste attività, non è necessaria un'attività Pubblica risultati code coverage separata nella pipeline.

Prerequisito: per usare l'attività Pubblica risultati code coverage v2 nella pipeline, usare l'attività dotnet 7.0.x come prerequisito nella pipeline. Usare l'attività dotnet core prima dell'attività Pubblica code coverage v2.

Prerequisiti

Per configurare i prerequisiti usando una pipeline YAML:

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

Per configurare i prerequisiti tramite la finestra di progettazione:

Screenshot che mostra l'attività .Net Core Sdk nella pipeline.

  1. Configurare l'attività Pubblica risultati code coverage versione 2 usando le impostazioni seguenti.

    Screenshot che mostra l'attività Pubblica risultati code coverage v2

  2. Al termine della compilazione e l'attività Pubblica risultati code coverage v2 ha esito positivo, selezionare la scheda code coverage nel riepilogo dell'esecuzione della pipeline per visualizzare i risultati del code coverage.

    Screenshot che mostra la scheda Code Coverage generata dall'attività Pubblica code coverage V2

Risultati del code coverage per JavaScript con Istanbul con YAML

Per pubblicare i risultati del code coverage per JavaScript con Istanbul usando YAML, vedere Personalizzare JavaScript nella sezione Ecosistemi di questi argomenti, che include anche esempi per altri linguaggi.

Vedere un esempio di pubblicazione del code coverage con Cobertura.

Scaricatore

Per le app che usano Docker, la compilazione e i test possono essere eseguiti all'interno del contenitore e generare risultati di code coverage all'interno del contenitore. Per pubblicare i risultati nella pipeline, gli artefatti risultanti devono essere resi disponibili all'attività Pubblica risultati code coverage. Per riferimento, è possibile visualizzare un esempio simile per la pubblicazione dei risultati dei test nella sezione Compilazione, test e pubblicazione dei risultati con un file Docker per Docker.

Visualizzare i risultati

Per visualizzare i risultati del code coverage nella pipeline, vedere Esaminare i risultati del code coverage.

Problemi noti

L'attività pubblica risultati code coverage v2 genera un file cjson e pubblica il report di code coverage nella scheda code coverage. Produce anche un artefatto di compilazione che è un set di file HTML collegati dal file principale index.html. Se la scheda code coverage non visualizza il report code coverage, verificare se il file XML di code coverage di input è nel formato corretto e contiene i dettagli validi.

Fabbisogno

Requisito Descrizione
Tipi di pipeline YAML, build classica
Viene eseguito in Agente
richieste Nessuno
funzionalità di Questa attività non soddisfa alcuna richiesta di attività successive nel processo.
restrizioni dei comandi Qualunque
variabili impostabili Qualunque
Versione dell'agente 2.144.0 o versione successiva
Categoria attività Test

Vedere anche