Примечание.
Для доступа к этой странице требуется авторизация. Вы можете попробовать войти или изменить каталоги.
Для доступа к этой странице требуется авторизация. Вы можете попробовать изменить каталоги.
Используйте эту задачу для сборки с помощью 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 или более поздней версии |
| Категория задач | Строить |