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

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.

Входные данные

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.


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

Путь к файлу результатов теста. Подстановочные знаки могут быть использованы. Дополнительные сведения см. всправочнике по шаблонам сопоставления файлов. Например, **/TEST-*.xml для всех 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 указывает на расположение файлов .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 вручную.


версии 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 заданному пути.


архитектуры JDK
Псевдоним ввода: jdkArchitecture. string. Необязательно. Используется при jdkVersion != default. Допустимые значения: x86, x64. Значение по умолчанию: x64.

При необходимости предоставляет архитектуру (x86, x64) JDK.


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

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

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

Нет.

Замечания

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

Требования

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