PublishCodeCoverageResults@2 — zadanie publikowania 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.

Dane wejściowe

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 klas. 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 minimatu.

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 zadania

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

Zmienne wyjściowe

Brak.

Uwagi

Uwaga

Aby uzyskać informacje o nowych funkcjach w wersji 2 zadania Publikuj wyniki pokrycia kodu , zobacz blog Dotyczący usługi Azure DevOps , aby uzyskać informacje o nowych funkcjach w wersji 2 zadania Publikowanie wyników pokrycia kodu i migracji z wersji 1 do wersji 2.

Użyj tego zadania w potoku kompilacji, aby opublikować wyniki pokrycia kodu generowane 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ż wygenerowanie raportu HTML pokrycia kodu w artefaktach kompilacji.

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

Zadania takie jak Visual Studio Test, .NET Core, Ant, Maven, Gulp i Grunt zapewniają również opcję publikowania 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 Publikuj wyniki pokrycia kodu w wersji 2 w potoku, użyj zadania dotnet 7.0.x jako wymagania wstępne w potoku. Przed zadaniem Publikuj pokrycie kodu w wersji 2 użyj zadania dotnet core.

Wymagania 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 Publikuj wyniki pokrycia kodu w wersji 2 przy użyciu następujących ustawień.

   

2. Po zakończeniu kompilacji i pomyślnym zadaniu 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 języka YAML

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

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

Docker

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 zadaniu Publikuj wyniki pokrycia kodu . Aby uzyskać informacje na ten temat, możesz zobaczyć podobny przykład publikowania wyników testów w sekcji Kompilowanie, testowanie i publikowanie wyników za pomocą sekcji pliku platformy Docker dla platformy 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 pokrycia kodu. Tworzy również artefakty kompilacji, które są zestawem plików HTML połączonych z głównym plikiemindex.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, kompilacja klasyczna
Działa na	Agent
Wymagania	Brak
Możliwości	To zadanie nie spełnia żadnych wymagań dotyczących kolejnych zadań w zadaniu.
Ograniczenia poleceń	Dowolne
Zmienne w formie tabeli settable	Dowolne
Wersja agenta	2.144.0 lub nowsza
Kategoria zadania	Testowanie

Zobacz też

• Publikowanie wyników testu