Condividi tramite


PublishCodeCoverageResults@2 - Pubblicare i risultati della code coverage v2 attività

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.

Input

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 minimatch. Ad esempio: $(System.DefaultWorkingDirectory)/MyApp/**/site/cobertura/coverage.xml. Altre informazioni sui modelli di minimatch.


pathToSources - Percorso dei file di origine
string.

Se si specifica un percorso per i file di origine, è necessario quando i report XML di copertura non contengono un percorso assoluto per i file di origine. Ad esempio, i report JaCoCo non usano percorsi assoluti, quindi quando si pubblica JaCoCo coverage per le app Java, il modello è simile a $(System.DefaultWorkingDirectory)/MyApp/src/main/java/. Questo input deve puntare a un percorso assoluto per i 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 della code coverage
boolean. Valore predefinito: false.

Non riesce l'attività se code coverage non ha prodotto risultati da pubblicare.


Opzioni di controllo delle attività

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

Variabili di output

Nessuno.

Osservazioni

Nota

Vedere Nuova versione dell'attività Pubblica risultati code coverage nel blog di Azure DevOps per informazioni sulle nuove funzionalità nell'attività Pubblica risultati code coverage e migrazione da V1 a V2.

Usare questa attività in una pipeline di compilazione per pubblicare i risultati della code coverage prodotti 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 copertura nella pipeline. L'attività supporta i formati xml generati da code coverage. Questa attività genera un file cjson che contiene i dettagli della code coverage. Produrrà anche un report HTML code coverage sotto gli artefatti di compilazione.

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

Le attività come Test di Visual Studio, .NET Core, Ant, Maven, Gulp e Grunt offrono anche l'opzione per 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 usando 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 della code coverage.

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

Risultati della code coverage per JavaScript con Istanbul con YAML

Per pubblicare i risultati della 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 di code coverage usando Cobertura.

Docker

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 informazioni di 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.

Visualizzazione dei risultati

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

Problemi noti

L'attività publish code coverage results v2 genera un file cjson e pubblica il report 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 riesce a visualizzare il report code coverage, verificare se il file xml di code coverage di input è nel formato corretto e contiene i dettagli validi.

Requisiti

Requisito Descrizione
Tipi di pipeline YAML, build classica
Esecuzione in Agente
Richieste Nessuno
Capabilities Questa attività non soddisfa le richieste per le attività successive nel processo.
Restrizioni dei comandi Qualsiasi
Variabili impostabili Qualsiasi
Versione agente 2.144.0 o versione successiva
Categoria attività Test

Vedi anche