Ant@1 - Ant v1 작업

아티클
03/24/2025

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

구문론

# 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 - 대상
string;

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

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

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

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

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

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

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에 대해 자세히 알아보세요.

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

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

Ant 빌드 파일에서 클래스 파일 및 보관 파일(.jar, .war등)이 포함된 디렉터리에 대한 상대 경로의 쉼표로 구분된 목록입니다. 이러한 디렉터리에 있는 클래스 파일에 대한 코드 적용 범위가 보고됩니다. 예: 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 설정합니다.

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 설정합니다.

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

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

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

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

작업 제어 옵션

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

출력 변수

없음.

비고

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

요구 사항

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

다음을 통해 공유

Ant@1 - Ant v1 작업

구문론

입력

작업 제어 옵션

출력 변수

비고

요구 사항

피드백

추가 리소스