PublishCodeCoverageResults@1 - 코드 검사 결과 v1 작업 게시

이 작업을 사용하여 빌드에서 Cobertura 또는 JaCoCo 코드 검사 결과를 게시합니다.

중요

이 작업은 더 이상 사용되지 않습니다. 사용자는 PublishCodeCoverageResults@2 전환하는 것이 좋습니다. 자세한 내용은 새 버전의 코드 검사 결과 게시 작업을 참조하세요.

이 작업을 사용하여 빌드에서 Cobertura 또는 JaCoCo 코드 검사 결과를 게시합니다.

Syntax

# Publish code coverage results v1
# [DEPRECATION WARNING! Users are recommended to switch to version 2*.] Publish Cobertura or JaCoCo code coverage results from a build.
- task: PublishCodeCoverageResults@1
  inputs:
    codeCoverageTool: 'JaCoCo' # 'Cobertura' | 'JaCoCo'. Required. Code coverage tool. Default: JaCoCo.
    summaryFileLocation: # string. Required. Summary file. 
    #pathToSources: # string. Path to Source files. 
    #reportDirectory: # string. Report directory. 
    #additionalCodeCoverageFiles: # string. Additional files. 
    #failIfCoverageEmpty: false # boolean. Fail when code coverage results are missing. Default: false.
# Publish code coverage results v1
# Publish Cobertura or JaCoCo code coverage results from a build.
- task: PublishCodeCoverageResults@1
  inputs:
    codeCoverageTool: 'JaCoCo' # 'Cobertura' | 'JaCoCo'. Required. Code coverage tool. Default: JaCoCo.
    summaryFileLocation: # string. Required. Summary file. 
    #pathToSources: # string. Path to Source files. 
    #reportDirectory: # string. Report directory. 
    #additionalCodeCoverageFiles: # string. Additional files. 
    #failIfCoverageEmpty: false # boolean. Fail when code coverage results are missing. Default: false.
# Publish Code Coverage Results v1
# Publish Cobertura or JaCoCo code coverage results from a build.
- task: PublishCodeCoverageResults@1
  inputs:
    codeCoverageTool: 'JaCoCo' # 'Cobertura' | 'JaCoCo'. Required. Code coverage tool. Default: JaCoCo.
    summaryFileLocation: # string. Required. Summary file. 
    #reportDirectory: # string. Report directory. 
    #additionalCodeCoverageFiles: # string. Additional files. 
    #failIfCoverageEmpty: false # boolean. Fail when code coverage results are missing. Default: false.
# YAML Syntax is not supported in TFS 2018.
# Use the classic designer to add and configure tasks.
# See the following Inputs section for details on the inputs that this task supports.

입력

codeCoverageTool - 코드 검사 도구
string. 필수 요소. 허용되는 값: Cobertura, JaCoCo. 기본값은 JaCoCo입니다.

코드 검사 결과를 생성하는 도구를 지정합니다.


summaryFileLocation - 요약 파일
string. 필수 요소.

줄, 메서드 및 클래스 검사와 같은 코드 검사 통계가 포함된 요약 파일의 경로를 지정합니다. 여러 요약 파일이 단일 보고서에 병합됩니다. 값에는 미니매치 패턴이 포함될 수 있습니다. 예: $(System.DefaultWorkingDirectory)/MyApp/**/site/cobertura/coverage.xml


pathToSources - 원본 파일 경로
string.

검사 XML 보고서에 원본 파일에 대한 절대 경로가 없는 경우 원본 파일에 대한 경로를 지정해야 합니다. 예를 들어 JaCoCo 보고서는 절대 경로를 사용하지 않으므로 Java 앱에 대한 JaCoCo 검사를 게시할 $(System.DefaultWorkingDirectory)/MyApp/src/main/java/때 패턴은 와 유사합니다. 이 입력은 호스트의 원본 파일에 대한 절대 경로를 가리킵니다. $(System.DefaultWorkingDirectory)/MyApp/)을 입력합니다.

이 입력은 Docker 컨테이너에서 테스트가 실행되는 경우 사용할 수 있습니다.

각 목록 항목을 문자로 구분하여 여러 원본을 ; 추가할 수 있습니다(예 pathToSources: $(System.DefaultWorkingDirectory)/path/to/first/source;$(System.DefaultWorkingDirectory)/path/to/second/source: ).


reportDirectory - 보고서 디렉터리
string.

코드 검사 HTML 보고서 디렉터리의 경로를 지정합니다. 나중에 빌드의 아티팩트로 볼 수 있도록 보고서 디렉터리가 게시됩니다. 값에는 미니매치 패턴이 포함될 수 있습니다. 예: $(System.DefaultWorkingDirectory)/MyApp/**/site/cobertura


additionalCodeCoverageFiles - 추가 파일
string.

파일 경로 패턴을 지정하고 빌드의 아티팩트로 게시할 추가 코드 검사 파일을 메모합니다. 값에는 미니매치 패턴이 포함될 수 있습니다. 예: $(System.DefaultWorkingDirectory)/**/*.exec


failIfCoverageEmpty - 코드 검사 결과가 누락된 경우 실패
boolean. 기본값은 false입니다.

코드 검사에서 게시할 결과를 생성하지 못한 경우 태스크에 실패합니다.


작업 제어 옵션

모든 작업에는 작업 입력 외에 제어 옵션이 있습니다. 자세한 내용은 컨트롤 옵션 및 일반적인 작업 속성을 참조하세요.

출력 변수

없음

설명

중요

이 작업은 더 이상 사용되지 않습니다. 사용자는 PublishCodeCoverageResults@2 전환하는 것이 좋습니다. 자세한 내용은 새 버전의 코드 검사 결과 게시 작업을 참조하세요.

참고

코드 검사 결과 게시 태스크의 V2의 새로운 기능과 V1에서 V2로 마이그레이션하는 방법에 대한 자세한 내용은 Azure DevOps 블로그에서 새 버전의 코드 검사 결과 게시 작업을 참조하세요.

빌드 파이프라인에서 이 작업을 사용하여 검사 보고를 얻기 위해 테스트를 실행할 때 생성된 코드 검사 결과를 Azure Pipelines 또는 TFS에 게시합니다. 이 작업은 CoberturaJaCoCo와 같은 인기 있는 검사 결과 형식을 지원합니다.

이 작업은 릴리스 파이프라인이 아닌 빌드 파이프라인에서만 지원됩니다.

Visual Studio Test, .NET Core, Ant, Maven, GulpGrunt와 같은 작업은 코드 검사 데이터를 파이프라인에 게시하는 옵션도 제공합니다. 이러한 작업을 사용하는 경우 파이프라인에 별도의 코드 검사 결과 게시 작업이 필요하지 않습니다.

HTML 코드 검사 보고서를 생성하려면 에이전트에 dotnet framework 2.0.0 이상이 필요합니다. dotnet 폴더는 환경 경로에 있어야 합니다. dotnet을 포함하는 폴더가 여러 개 있는 경우 버전 2.0.0이 있는 폴더는 경로 목록의 다른 폴더 앞에 있어야 합니다.

YAML을 사용하여 이스탄불에서 JavaScript에 대한 코드 검사 결과

YAML을 사용하여 이스탄불과 함께 JavaScript에 대한 코드 검사 결과를 게시하려면 이러한 topics 에코시스템 섹션에서 JavaScript 사용자 지정을 참조하세요. 여기에는 다른 언어에 대한 예제도 포함되어 있습니다.

Cobertura를 사용하여 코드 검사를 게시하는 예제를 참조하세요.

Docker

Docker를 사용하는 앱의 경우 빌드 및 테스트가 컨테이너 내에서 실행되고 컨테이너 내에서 코드 검사 결과를 생성할 수 있습니다. 파이프라인에 결과를 게시하려면 결과 아티팩트가 코드 검사 결과 게시 태스크에 제공되어야 합니다. 참고로 DockerDocker 파일로 결과 빌드, 테스트 및 게시 섹션에서 테스트 결과를 게시하는 유사한 예제를 볼 수 있습니다.

결과 보기

파이프라인에서 코드 검사 결과를 보려면 코드 검사 결과 검토를 참조하세요.

여러 파일이 작업에 대한 입력으로 제공되거나 파이프라인에서 여러 작업이 사용될 때 코드 검사 데이터가 병합되나요?

현재 이 작업에서 제공하는 코드 검사 보고 기능은 제한되며 검사 데이터를 병합하지 않습니다. 작업에 입력으로 여러 파일을 제공하는 경우 첫 번째 일치 항목만 고려됩니다. 파이프라인에서 여러 게시 코드 검사 작업을 사용하는 경우 마지막 작업에 대한 요약 및 보고서가 표시됩니다. 이전에 업로드한 데이터는 무시됩니다.

알려진 문제

코드 검사 결과 게시 작업은 기본index.html파일에서 연결된 HTML 파일 집합인 HTML 보고서를 생성하고 게시합니다. 코드 검사 탭에 코드 검사 보고서가 표시되지 않으면 index.html 파일의 크기가 7MB에 가깝거나 큰지 검사. 파일 크기를 검사 다음 단계를 완료합니다. 그런 다음 파일 크기가 7MB에 가까울 경우 다음 해결 방법을 사용하여 검사 보고서를 볼 수 있습니다.

  1. 빌드 요약 탭을 선택한 다음 , 게시된 링크를 선택합니다.

    요약 창에 게시된 링크를 보여 주는 스크린샷.

  2. 코드 검사 Report_* 아티팩트 옆에 있는 아티팩트 다운로드를 선택합니다.

    아티팩트 아래의 코드 검사 보고서에 대한 아티팩트 다운로드 링크를 보여 주는 스크린샷

  3. 코드 검사 보고서를 다운로드하면 .zip 파일을 추출합니다.

  4. 코드 검사 보고서에서 파일 크기가 여기에 설명된 문제를 일으키는지 여부를 확인하는 데 도움이 되도록 index.html크기를 검사.

  5. 브라우저에서 index.html 열어 코드 검사 보고서를 봅니다.

요구 사항

요구 사항 Description
파이프라인 유형 YAML, 클래식 빌드
실행 중 에이전트, DeploymentGroup
요청 없음
Capabilities 이 작업은 작업의 후속 작업에 대한 요구를 충족하지 않습니다.
명령 제한 사항 모두
Settable 변수 이 작업에는 다음 변수를 설정할 수 있는 권한이 있습니다. 변수 설정을 사용할 수 없습니다.
에이전트 버전 2.182.1 이상
작업 범주 테스트
요구 사항 Description
파이프라인 유형 YAML, 클래식 빌드
실행 중 에이전트, DeploymentGroup
요청 없음
Capabilities 이 작업은 작업의 후속 작업에 대한 요구를 충족하지 않습니다.
명령 제한 사항 모두
Settable 변수 모두
에이전트 버전 2.102.0 이상
작업 범주 테스트

추가 정보