Ant@1 - Ant v1 작업

이 작업을 사용하여 Apache Ant를 사용하여 빌드합니다.

Syntax

# Ant v1
# Build with Apache Ant.
- task: Ant@1
  inputs:
    buildFile: 'build.xml' # string. Alias: antBuildFile. Required. Ant build file. Default: build.xml.
    #options: # string. Options. 
    #targets: # string. Target(s). 
  # JUnit Test Results
    #publishJUnitResults: true # boolean. Publish to Azure Pipelines. Default: true.
    testResultsFiles: '**/TEST-*.xml' # string. Required when publishJUnitResults = true. Test results files. Default: **/TEST-*.xml.
    #testRunTitle: # string. Optional. Use when publishJUnitResults = true. Test run title. 
  # Code Coverage
    #codeCoverageToolOptions: 'None' # 'None' | 'Cobertura' | 'JaCoCo'. Alias: codeCoverageTool. Code coverage tool. Default: None.
    codeCoverageClassFilesDirectories: '.' # string. Alias: classFilesDirectories. Required when codeCoverageTool != None. Class files directories. Default: ..
    #codeCoverageClassFilter: # string. Alias: classFilter. Optional. Use when codeCoverageTool != None. Class inclusion/exclusion filters. 
    #codeCoverageSourceDirectories: # string. Alias: srcDirectories. Optional. Use when codeCoverageTool != None. Source files directories. 
    #codeCoverageFailIfEmpty: false # boolean. Alias: failIfCoverageEmpty. Optional. Use when codeCoverageTool != None. Fail when code coverage results are missing. Default: false.
  # Advanced
    #antHomeDirectory: # string. Alias: antHomeUserInputPath. Set ANT_HOME path. 
    javaHomeOption: 'JDKVersion' # 'JDKVersion' | 'Path'. Alias: javaHomeSelection. Required. Set JAVA_HOME by. Default: JDKVersion.
    #jdkVersionOption: 'default' # 'default' | '1.11' | '1.10' | '1.9' | '1.8' | '1.7' | '1.6'. Alias: jdkVersion. Optional. Use when javaHomeSelection = JDKVersion. JDK version. Default: default.
    #jdkUserInputDirectory: # string. Alias: jdkUserInputPath. Required when javaHomeSelection = Path. JDK path. 
    #jdkArchitectureOption: 'x64' # 'x86' | 'x64'. Alias: jdkArchitecture. Optional. Use when jdkVersion != default. JDK architecture. Default: x64.

입력

buildFile - Ant 빌드 파일
입력 별칭: antBuildFile. string. 필수 요소. 기본값은 build.xml입니다.

리포지토리 루트에서 Ant 빌드 파일로의 상대 경로입니다.

빌드 파일에 대한 자세한 내용은 Apache Ant 사용을 참조하세요.

options - 옵션
string.

Ant 명령줄에 전달하는 옵션을 제공합니다. 고유한 속성(예 -DmyProperty=myPropertyValue: )을 제공하고 기본 제공 변수(예 -DcollectionId=$(system.collectionId): )를 사용할 수도 있습니다. 또는 기본 제공 변수는 빌드 중에 이미 환경 변수로 설정되며 직접 전달할 수 있습니다(예: -DcollectionIdAsEnvVar=%SYSTEM_COLLECTIONID%).

Apache Ant 실행을 참조하세요.

targets - 대상(s)
string.

빌드할 선택적 공간으로 구분된 대상 목록입니다. 지정 default 하지 않으면 대상이 사용됩니다. 대상이 정의되지 않은 default 경우 Ant 1.6.0 이상은 모든 최상위 작업을 빌드합니다.

Apache Ant 대상 사용을 참조하세요.

publishJUnitResults - Azure Pipelines에 게시
boolean. 기본값은 true입니다.

Ant 빌드에서 생성된 JUnit 테스트 결과를 Azure Pipelines에 게시하려면 이 옵션을 선택합니다. 각 테스트 결과 파일 일치 Test Results Files 는 Azure Pipelines에서 테스트 실행으로 게시됩니다.

testResultsFiles - 테스트 결과 파일
string. 필요한 경우 publishJUnitResults = true입니다. 기본값은 **/TEST-*.xml입니다.

테스트 결과 파일 경로입니다. 와일드카드를 사용할 수 있습니다. 자세한 내용은 파일 일치 패턴 참조를 참조하세요. 예를 들어 이름이 **/TEST-*.xml 로 시작하는 모든 XML 파일의 경우입니다 TEST-.

testRunTitle - 실행 타이틀 테스트
string. 선택 사항입니다. 를 사용하는 경우 publishJUnitResults = true를 사용합니다.

테스트 실행의 이름을 제공합니다.

codeCoverageToolOptions - 코드 검사 도구
입력 별칭: codeCoverageTool. string. 허용되는 값: None, Cobertura, JaCoCo. 기본값은 None입니다.

코드 검사 도구를 선택합니다.

Microsoft 호스팅 에이전트를 사용하는 경우 도구가 설정됩니다. 온-프레미스 Windows 에이전트를 사용하는 경우 에이전트가 JaCoco 또는 Cobertura에 대해 설정되어 있는지 확인해야 합니다.

• JaCoCo - Ant 설치의 lib 폴더에서 jacocoant.jar 사용할 수 있는지 확인합니다. JaCoCo Ant 작업에 대해 자세히 알아보세요.
• Cobertura - 환경 변수가 COBERTURA_HOME Cobertura .jar 파일 위치를 가리키는지 확인합니다. Cobertura with Ant 작업에 대해 자세히 알아보세요.

이러한 도구 중 하나를 선택하면 다음 인수가 나타납니다.

codeCoverageClassFilesDirectories - 클래스 파일 디렉터리
입력 별칭: classFilesDirectories. string. 필요한 경우 codeCoverageTool != None입니다. 기본값은 .입니다.

Ant 빌드 파일에서 클래스 파일 및 보관 파일(, .war등)이 포함된 디렉터리에 대한 상대 경로의.jar 쉼표로 구분된 목록입니다. 이러한 디렉터리에 있는 클래스 파일에 대한 코드 검사가 보고됩니다. 예: target/classes,target/testClasses

codeCoverageClassFilter - 클래스 포함/제외 필터
입력 별칭: classFilter. string. 선택 사항입니다. 를 사용하는 경우 codeCoverageTool != None를 사용합니다.

코드 검사 수집에서 클래스를 포함하거나 제외할 쉼표로 구분된 필터 목록입니다. 예: +:com., +:org., -:my.app*..

codeCoverageSourceDirectories - 원본 파일 디렉터리
입력 별칭: srcDirectories. string. 선택 사항입니다. 를 사용하는 경우 codeCoverageTool != None를 사용합니다.

Ant 빌드 파일에서 소스 코드 디렉터리로 쉼표로 구분된 상대 경로 목록입니다. 코드 검사 보고서는 이를 사용하여 소스 코드를 강조 표시합니다. 예: src/java,src/Test

codeCoverageFailIfEmpty - 코드 검사 결과가 누락된 경우 실패
입력 별칭: failIfCoverageEmpty. boolean. 선택 사항입니다. 를 사용하는 경우 codeCoverageTool != None를 사용합니다. 기본값은 false입니다.

코드 검사에서 게시할 결과를 생성하지 않은 경우 빌드에 실패합니다.

antHomeDirectory - ANT_HOME 경로 설정
입력 별칭: antHomeUserInputPath. string.

설정되면 기존 ANT_HOME 환경 변수를 지정된 경로로 재정의합니다.

javaHomeOption - 다음으로 JAVA_HOME 설정
입력 별칭: javaHomeSelection. string. 필수 요소. 허용되는 값: JDKVersion (JDK 버전), Path. 기본값은 JDKVersion입니다.

빌드 중에 검색될 JDK 버전을 선택하거나 JDK 경로를 수동으로 입력하여 JAVA_HOME 설정합니다.

jdkVersionOption - JDK 버전
입력 별칭: jdkVersion. string. 선택 사항입니다. 를 사용하는 경우 javaHomeSelection = JDKVersion를 사용합니다. 허용되는 값: default, 1.11 (JDK 11), 1.10 (JDK 10(지원되지 않음)), 1.9 (JDK 9(지원되지 않음)), 1.8 (JDK 8), 1.7 (JDK 7), 1.6 (JDK 6(지원되지 않음)) 기본값은 default입니다.

선택한 JDK 버전의 경로를 검색하고 그에 따라 JAVA_HOME 설정합니다.

jdkUserInputDirectory - JDK 경로
입력 별칭: jdkUserInputPath. string. 필요한 경우 javaHomeSelection = Path입니다.

지정된 경로에 JAVA_HOME 설정합니다.

jdkArchitectureOption - JDK 아키텍처
입력 별칭: jdkArchitecture. string. 선택 사항입니다. 를 사용하는 경우 jdkVersion != default를 사용합니다. 허용되는 값: x86, x64. 기본값은 x64입니다.

필요에 따라 JDK의 아키텍처(x86, x64)를 제공합니다.

작업 제어 옵션

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

출력 변수

없음

설명

이 작업을 사용하여 Apache Ant를 사용하여 빌드합니다.

요구 사항

요구 사항	Description
파이프라인 유형	YAML, 클래식 빌드, 클래식 릴리스
실행 중	에이전트, DeploymentGroup
요청	자체 호스팅 에이전트에는 이 작업을 사용하는 작업을 실행하기 위한 다음 요구 사항과 일치하는 기능이 있어야 합니다. ant
Capabilities	이 작업은 작업의 후속 작업에 대한 요구를 충족하지 않습니다.
명령 제한 사항	모두
Settable 변수	모두
에이전트 버전	1.89.0 이상
작업 범주	빌드