Nota
El acceso a esta página requiere autorización. Puede intentar iniciar sesión o cambiar directorios.
El acceso a esta página requiere autorización. Puede intentar cambiar los directorios.
Use esta tarea para compilar con Apache Ant.
Sintaxis
# 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
-
de 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 obtener más información sobre los archivos de compilación, consulte Uso de Apache Ant.
opciones de options
-
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 se establecen 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
.
Una lista opcional separada por espacios de destinos que se van a compilar. Si no se especifica, se usará el destino default
. Si no se define ningún destino default
, Ant 1.6.0 y versiones posteriores compilarán todas las tareas de nivel superior.
Consulte uso de Apache Ant Targets.
publishJUnitResults
-
publicar 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 pruebas coincidentes Test Results Files
se publicará como una ejecución de prueba en Azure Pipelines.
testResultsFiles
-
archivos de resultados de pruebas
string
. Obligatorio cuando publishJUnitResults = true
. Valor predeterminado: **/TEST-*.xml
.
Ruta de acceso del archivo de resultados de la prueba. Pueden emplearse comodines. 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 ejecución de pruebas
string
. Opcional. Use cuando publishJUnitResults = true
.
Proporciona un nombre para la ejecución de pruebas.
de la herramienta de cobertura de código de codeCoverageToolOptions
-
Alias de entrada: codeCoverageTool
.
string
. Valores permitidos: None
, Cobertura
, JaCoCo
. Valor predeterminado: None
.
Selecciona la herramienta de cobertura de código.
Si usa los 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 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 ant.
Después de seleccionar una de estas herramientas, aparecen los argumentos siguientes:
codeCoverageClassFilesDirectories
-
directorios de archivos de clase
Alias de entrada: classFilesDirectories
.
string
. Obligatorio 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 de 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 genera 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 ANT_HOME existente con la ruta de acceso especificada.
javaHomeOption
-
Establecer JAVA_HOME
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.
de la versión de JDK de
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
-
de ruta de acceso de JDK
Alias de entrada: jdkUserInputPath
.
string
. Obligatorio cuando javaHomeSelection = Path
.
Establece JAVA_HOME en la ruta de acceso especificada.
de arquitectura de JDK de
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 sus entradas de tarea. Para obtener más información, consulte Opciones de control y propiedades de tareas comunes.
Variables de salida
Ninguno.
Observaciones
Use esta tarea para compilar 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 |
demandas | Los agentes autohospedados deben tener funcionalidades que coincidan con los siguientes exigen ejecutar trabajos que usen esta tarea: ant |
funcionalidades de |
Esta tarea no satisface ninguna demanda de tareas posteriores en el trabajo. |
restricciones de comandos | Cualquiera |
variables settable | Cualquiera |
Versión del agente | 1.89.0 o superior |
Categoría de tarea | Construir |