Поделиться через


Ant@1 — задача Ant версии 1

Используйте эту задачу для сборки с помощью 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.
# 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/TFS. 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.


publishJUnitResults - Публикация в Azure Pipelines
boolean. Значение по умолчанию: true.

Выберите этот параметр, чтобы опубликовать результаты тестов JUnit, созданные сборкой Ant, в Azure Pipelines. Каждое сопоставление Test Results Files файлов результатов теста будет опубликовано в виде тестового запуска в Azure Pipelines.


publishJUnitResults - Публикация в Azure Pipelines/TFS
boolean. Значение по умолчанию: true.

Выберите этот параметр, чтобы опубликовать результаты тестов JUnit, созданные сборкой Ant, в Azure Pipelines. Каждое сопоставление Test Results Files файлов результатов теста будет опубликовано в виде тестового запуска в Azure Pipelines.


testResultsFiles - Файлы результатов тестирования
string. Требуется при .publishJUnitResults = true Значение по умолчанию: **/TEST-*.xml.

Путь к файлу результатов теста. Можно использовать подстановочные знаки. Дополнительные сведения см. в справочнике по шаблонам сопоставления файлов. Например, для всех XML-файлов, **/TEST-*.xml имя которых начинается с TEST-.


testRunTitle - Заголовок тестового запуска
string. Необязательный элемент. Используйте при publishJUnitResults = true.

Предоставляет имя тестового запуска.


codeCoverageToolOptions - Средство покрытия кода
Входной псевдоним: codeCoverageTool. string. Допустимые значения: None, Cobertura, JaCoCo. Значение по умолчанию: None.

Выбирает средство покрытия кода.

Если вы используете агенты, размещенные в Майкрософт, средства настроены для вас. Если вы используете локальный агент Windows, необходимо убедиться, что агент настроен для JaCoco или Cobertura.

  • JaCoCo — убедитесь, что jacocoant.jar доступен в папке lib установки Ant. Дополнительные сведения о задачах JaCoCo Ant.
  • Cobertura — убедитесь, что переменная среды COBERTURA_HOME указывает на расположение файлов cobertura .jar. Узнайте больше о задачах Cobertura с Ant.

После выбора одного из этих средств отображаются следующие аргументы:


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.

Задает JAVA_HOME путем выбора версии JDK, которая будет обнаружена во время сборки, или путем ввода пути JDK вручную.


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


Параметры управления задачами

Помимо входных данных, все задачи имеют параметры управления. Дополнительные сведения см. в разделе Параметры управления и общие свойства задачи.

Выходные переменные

Нет.

Remarks

Используйте эту задачу для сборки с помощью Apache Ant.

Требования

Требование Описание
Типы конвейеров YAML, классическая сборка, классический выпуск
Выполняется в Агент, DeploymentGroup
Требования Для выполнения заданий, использующих эту задачу, локальные агенты должны иметь возможности, соответствующие следующим требованиям:
Capabilities Эта задача не удовлетворяет требованиям для последующих задач в задании.
Ограничения команд Любой
Устанавливаемые переменные Любой
Версия агента 1.89.0 или более поздней версии
Категория задач Сборка