Ant@1: tarea Ant v1

Use esta tarea para compilar aplicaciones con 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.

Entradas

buildFile - Archivo de compilación ant
Alias de entrada: antBuildFile. string. Obligatorio. Valor predeterminado: build.xml.

Ruta de acceso relativa de la raíz del repositorio al archivo de compilación ant.

Para más información sobre los archivos de compilación, consulte Uso de Apache Ant.

options - Opciones
string.

Proporciona opciones para pasar a la línea de comandos ant. Puede proporcionar sus propias propiedades (por ejemplo, -DmyProperty=myPropertyValue) y también usar variables integradas (por ejemplo, -DcollectionId=$(system.collectionId)). Como alternativa, las variables integradas ya están establecidas como variables de entorno durante la compilación y se pueden pasar directamente (por ejemplo, -DcollectionIdAsEnvVar=%SYSTEM_COLLECTIONID%).

Consulte Ejecución de Apache Ant.

targets - Destinos
string.

Lista opcional separada por espacios de destinos que se van a compilar. Si no se especifica, se usará el default destino. Si no se define ningún default destino, Ant 1.6.0 y versiones posteriores compilarán todas las tareas de nivel superior.

Consulte Uso de destinos de Apache Ant.

publishJUnitResults - Publicación en Azure Pipelines
boolean. Valor predeterminado: true.

Seleccione esta opción para publicar los resultados de pruebas de JUnit generados por la compilación ant en Azure Pipelines. Cada archivo de resultados de prueba que coincida con Test Results Files se publicará como una serie de pruebas en Azure Pipelines.

testResultsFiles - Archivos de resultados de pruebas
string. Necesario cuando publishJUnitResults = true. Valor predeterminado: **/TEST-*.xml.

Ruta de acceso del archivo de resultados de la prueba. Se pueden usar caracteres comodín. Para obtener más información, consulte la referencia de patrones de coincidencia de archivos. Por ejemplo, **/TEST-*.xml para todos los archivos XML cuyo nombre comienza por TEST-.

testRunTitle - Título de la ejecución de pruebas
string. Opcional. Use cuando publishJUnitResults = true.

Proporciona un nombre para la ejecución de pruebas.

codeCoverageToolOptions - Herramienta de cobertura de código
Alias de entrada: codeCoverageTool. string. Valores permitidos: None, Cobertura y JaCoCo. Valor predeterminado: None.

Selecciona la herramienta de cobertura de código.

Si usa Agentes hospedados por Microsoft, las herramientas se configuran automáticamente. Si usa el agente de Windows local, debe asegurarse de que el agente esté configurado para JaCoco o Cobertura.

• JaCoCo: asegúrese de que jacocoant.jar está disponible en la carpeta lib de la instalación de Ant. Obtenga más información sobre las tareas de JaCoCo Ant.
• Cobertura: asegúrese de que una variable de entorno COBERTURA_HOME apunte a la ubicación de los archivos de cobertura .jar. Obtenga más información sobre Cobertura con tareas de Ant.

Después de seleccionar una de estas herramientas, aparecen los argumentos siguientes:

codeCoverageClassFilesDirectories - Directorios de archivos de clase
Alias de entrada: classFilesDirectories. string. Necesario cuando codeCoverageTool != None. Valor predeterminado: ..

Lista separada por comas de rutas de acceso relativas del archivo de compilación ant a directorios que contienen archivos de clase y archivos de archivo (.jar, .war, etc.). La cobertura de código se notifica para los archivos de clase que están en estos directorios. Por ejemplo: target/classes,target/testClasses.

codeCoverageClassFilter - Filtros de inclusión y exclusión de clases
Alias de entrada: classFilter. string. Opcional. Use cuando codeCoverageTool != None.

Lista separada por comas de filtros que se van a incluir o excluir clases de recopilación de cobertura de código. Por ejemplo: +:com., +:org., -:my.app*..

codeCoverageSourceDirectories - Directorios de archivos de origen
Alias de entrada: srcDirectories. string. Opcional. Use cuando codeCoverageTool != None.

Lista separada por comas de rutas de acceso relativas del archivo de compilación ant a directorios de código fuente. Los informes de cobertura de código los usarán para resaltar el código fuente. Por ejemplo: src/java,src/Test.

codeCoverageFailIfEmpty - Error cuando faltan resultados de cobertura de código
Alias de entrada: failIfCoverageEmpty. boolean. Opcional. Use cuando codeCoverageTool != None. Valor predeterminado: false.

Se produce un error en la compilación si la cobertura de código no ha generado ningún resultado para publicar.

antHomeDirectory - Establecer ANT_HOME ruta de acceso
Alias de entrada: antHomeUserInputPath. string.

Si se establece, invalida cualquier variable de entorno de ANT_HOME existente con la ruta de acceso especificada.

javaHomeOption - Establecer JAVA_HOME por
Alias de entrada: javaHomeSelection. string. Obligatorio. Valores permitidos: JDKVersion (versión de JDK), Path. Valor predeterminado: JDKVersion.

Establece JAVA_HOME seleccionando una versión de JDK que se detectará durante las compilaciones o escribiendo manualmente una ruta de acceso de JDK.

jdkVersionOption - Versión de JDK
Alias de entrada: jdkVersion. string. Opcional. Use cuando javaHomeSelection = JDKVersion. Valores permitidos: default, 1.11 (JDK 11), 1.10 (JDK 10 (fuera de soporte)), 1.9 (JDK 9 (fuera de soporte)), 1.8 (JDK 8), 1.7 (JDK 7), 1.6 (JDK 6 (fuera de soporte)). Valor predeterminado: default.

Intenta detectar la ruta de acceso a la versión de JDK seleccionada y establece JAVA_HOME en consecuencia.

jdkUserInputDirectory - Ruta de acceso de JDK
Alias de entrada: jdkUserInputPath. string. Necesario cuando javaHomeSelection = Path.

Establece JAVA_HOME en la ruta de acceso especificada.

jdkArchitectureOption - Arquitectura de JDK
Alias de entrada: jdkArchitecture. string. Opcional. Use cuando jdkVersion != default. Valores permitidos: x86, x64. Valor predeterminado: x64.

Opcionalmente, proporciona la arquitectura (x86, x64) del JDK.

Opciones de control de tareas

Todas las tareas tienen opciones de control además de las entradas de tareas. Para obtener más información, vea Opciones de control y propiedades de tareas comunes.

Variables de salida

Ninguno.

Comentarios

Use esta tarea para compilar aplicaciones con Apache Ant.

Requisitos

Requisito	Descripción
Tipos de canalización	YAML, compilación clásica, versión clásica
Se ejecuta en	Agente, DeploymentGroup
Peticiones	Los agentes autohospedados deben tener funcionalidades que coincidan con las siguientes demandas para ejecutar trabajos que usan esta tarea: ant
Capabilities	Esta tarea no satisface ninguna demanda de tareas posteriores en el trabajo.
Restricciones de comandos	Any
Variables que se pueden establecer	Any
Versión del agente	1.89.0 o superior
Categoría de la tarea:	Build