PublishCodeCoverageResults@2 — publikowanie wyników pokrycia kodu w wersji 2

Użyj tego zadania, aby uzyskać wyniki pokrycia kodu z kompilacji.

Składnia

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

Wejścia

summaryFileLocation - ścieżka do plików podsumowania
string. Wymagane.

Określa ścieżkę pliku podsumowania zawierającego statystyki pokrycia kodu, takie jak wiersz, metoda i pokrycie klasy. Wiele plików podsumowania jest scalanych z jednym raportem. Wartość może zawierać wzorce minimatch. Na przykład: $(System.DefaultWorkingDirectory)/MyApp/**/site/cobertura/coverage.xml. więcej informacji na temat wzorców minimatch.

pathToSources - ścieżka do plików źródłowych
string.

Określenie ścieżki do plików źródłowych jest wymagane, gdy raporty XML pokrycia nie zawierają ścieżki bezwzględnej do plików źródłowych. Na przykład raporty JaCoCo nie używają ścieżek bezwzględnych, więc podczas publikowania pokrycia JaCoCo dla aplikacji Java wzorzec jest podobny do $(System.DefaultWorkingDirectory)/MyApp/src/main/java/. Te dane wejściowe powinny wskazywać ścieżkę bezwzględną do plików źródłowych na hoście. Na przykład $(System.DefaultWorkingDirectory)/MyApp/.

Te dane wejściowe mogą być używane, jeśli testy są uruchamiane w kontenerze platformy Docker.

failIfCoverageEmpty - Niepowodzenie, jeśli brakuje wyników pokrycia kodu
boolean. Wartość domyślna: false.

Zadanie kończy się niepowodzeniem, jeśli pokrycie kodu nie wygenerowało żadnych wyników do opublikowania.

Opcje sterowania zadaniami

Wszystkie zadania mają opcje sterowania oprócz danych wejściowych zadań podrzędnych. Aby uzyskać więcej informacji, zobacz opcje kontroli i typowe właściwości zadań.

Zmienne wyjściowe

Żaden.

Uwagi

Użyj tego zadania w potoku kompilacji, aby opublikować wyniki pokrycia kodu wygenerowane podczas uruchamiania testów w usłudze Azure Pipelines lub TFS i po wygenerowaniu plików XML pokrycia w celu uzyskania karty pokrycia kodu i szczegółów raportowania pokrycia w potoku. Zadanie obsługuje formaty xml wygenerowane przez pokrycie kodu. To zadanie generuje plik cjson zawierający szczegóły pokrycia kodu. Spowoduje to również utworzenie raportu HTML pokrycia kodu w ramach artefaktów kompilacji.

To zadanie jest obsługiwane tylko w potokach kompilacji, a nie w potokach wydania.

Zadania, takie jak Test programu Visual Studio, .NET Core, Ant, Maven, Gulpi Grunt również umożliwiają publikowanie danych pokrycia kodu w potoku. Jeśli używasz tych zadań, nie potrzebujesz oddzielnego zadania Publikuj wyniki pokrycia kodu w potoku.

Wymaganie wstępne — aby użyć zadania Publikowanie wyników pokrycia kodu w wersji 2 w potoku, użyj zadania dotnet 7.0.x jako wymagania wstępne w potoku. Użyj zadania dotnet core przed zadaniem Publikuj pokrycie kodu w wersji 2.

Warunki wstępne

Aby skonfigurować wymagania wstępne przy użyciu potoku YAML:

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

Aby skonfigurować wymagania wstępne przy użyciu projektanta:

1. Skonfiguruj zadanie Publikowanie wyników pokrycia kodu w wersji 2 przy użyciu następujących ustawień.

   

2. Po zakończeniu kompilacji i pomyślnym wykonaniu zadania Publikowanie wyników pokrycia kodu w wersji 2 wybierz kartę Pokrycie kodu w podsumowaniu przebiegu potoku, aby wyświetlić wyniki pokrycia kodu.

   

Wyniki pokrycia kodu dla języka JavaScript w Stambule przy użyciu kodu YAML

Aby opublikować wyniki pokrycia kodu dla języka JavaScript w Stambule przy użyciu języka YAML, zobacz Dostosowywanie kodu JavaScript w sekcji Ekosystemy w tych tematach, która zawiera również przykłady dla innych języków.

Zobacz przykład publikowania pokrycia kodu przy użyciu narzędzia Cobertura.

Doker

W przypadku aplikacji korzystających z platformy Docker kompilacja i testy mogą być uruchamiane wewnątrz kontenera i generować wyniki pokrycia kodu w kontenerze. Aby opublikować wyniki w potoku, wynikowe artefakty powinny zostać udostępnione publikowanie wyników pokrycia kodu zadania. Aby uzyskać informacje na ten temat, zobacz podobny przykład publikowania wyników testów w sekcji Build, test i publish results with a Docker file section for Docker( ).

Wyświetlanie wyników

Aby wyświetlić wyniki pokrycia kodu w potoku, zobacz Przeglądanie wyników pokrycia kodu.

Znane problemy

Zadanie publikowania pokrycia kodu w wersji 2 generuje plik cjson i publikuje raport pokrycia kodu na karcie pokrycie kodu. Tworzy również artefakty kompilacji, które są zestawem plików HTML połączonych z głównym plikiem index.html. Jeśli karta pokrycia kodu nie wyświetli raportu pokrycia kodu, sprawdź, czy plik XML pokrycia kodu wejściowego jest w poprawnym formacie i ma prawidłowe szczegóły.

Wymagania

Wymaganie	Opis
Typy potoków	YAML, klasyczna kompilacja
Działa na	Agent
Wymagania	Żaden
możliwości	To zadanie nie spełnia żadnych wymagań dotyczących kolejnych zadań w zadaniu.
ograniczenia poleceń	Jakikolwiek
zmienne ustawiane	Jakikolwiek
Wersja agenta	2.144.0 lub nowsza
Kategoria zadań	Test

Zobacz też

• publikowanie wyników testów