Ant@1 - Attività Ant v1

Usare questa attività per compilare con Apache Ant.

Sintassi

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

Input

buildFile - File di compilazione Ant
Alias di input: antBuildFile. string. Obbligatorio. Valore predefinito: build.xml.

Percorso relativo dalla radice del repository al file di compilazione Ant.

Per altre informazioni sui file di compilazione, vedere Uso di Apache Ant.

options - Opzioni
string.

Fornisce opzioni per passare alla riga di comando Ant. È possibile specificare le proprie proprietà ( ad esempio , -DmyProperty=myPropertyValue) e usare anche variabili predefinite (ad esempio, -DcollectionId=$(system.collectionId)). In alternativa, le variabili predefinite sono già impostate come variabili di ambiente durante la compilazione e possono essere passate direttamente (ad esempio, -DcollectionIdAsEnvVar=%SYSTEM_COLLECTIONID%).

Vedere Esecuzione di Apache Ant.

targets - Target(s)
string.

Elenco facoltativo e separato da spazi di destinazioni da compilare. Se non specificato, verrà usata la default destinazione. Se non viene definita alcuna default destinazione, Ant 1.6.0 e versioni successive creerà tutte le attività di primo livello.

Vedere Uso di Destinazioni Apache Ant.

publishJUnitResults - Pubblicare in Azure Pipelines
boolean. Valore predefinito: true.

Selezionare questa opzione per pubblicare i risultati dei test JUnit prodotti dalla compilazione Ant in Azure Pipelines. Ogni file di risultati di test corrispondente Test Results Files verrà pubblicato come esecuzione di test in Azure Pipelines.

testResultsFiles - File dei risultati dei test
string. Obbligatorio quando publishJUnitResults = true. Valore predefinito: **/TEST-*.xml.

Percorso del file dei risultati del test. È possibile usare caratteri jolly. Per altre informazioni, vedere il riferimento ai modelli di corrispondenza dei file. Ad esempio, **/TEST-*.xml per tutti i file XML il cui nome inizia con TEST-.

testRunTitle - Titolo esecuzione test
string. facoltativo. Usare quando publishJUnitResults = true.

Fornisce un nome per l'esecuzione del test.

codeCoverageToolOptions - Strumento code coverage
Alias di input: codeCoverageTool. string. Valori consentiti: None, Cobertura, JaCoCo. Valore predefinito: None.

Seleziona lo strumento code coverage.

Se si usano gli agenti ospitati da Microsoft, gli strumenti vengono configurati per l'utente. Se si usa l'agente Windows locale, è necessario assicurarsi che l'agente sia configurato per JaCoco o Cobertura.

• JaCoCo: assicurarsi che jacocoant.jar sia disponibile nella cartella lib dell'installazione di Ant. Altre informazioni sulle attività JaCoCo Ant.
• Cobertura: assicurarsi che una variabile di ambiente COBERTURA_HOME punti al percorso dei file cobertura .jar. Altre informazioni su Cobertura con attività Ant.

Dopo aver selezionato uno di questi strumenti, vengono visualizzati gli argomenti seguenti:

codeCoverageClassFilesDirectories - Directory dei file di classe
Alias di input: classFilesDirectories. string. Obbligatorio quando codeCoverageTool != None. Valore predefinito: ..

Elenco delimitato da virgole dei percorsi relativi dal file di compilazione Ant alle directory contenenti file di classe e file di archivio (.jar, .warecc.). Il code coverage viene segnalato per i file di classe in queste directory. Ad esempio: target/classes,target/testClasses.

codeCoverageClassFilter - Filtri di inclusione/esclusione della classe
Alias di input: classFilter. string. facoltativo. Usare quando codeCoverageTool != None.

Elenco delimitato da virgole di filtri da includere o escludere classi dalla raccolta di code coverage. Ad esempio: +:com., , -:my.app*.+:org..

codeCoverageSourceDirectories - Directory dei file di origine
Alias di input: srcDirectories. string. facoltativo. Usare quando codeCoverageTool != None.

Elenco delimitato da virgole di percorsi relativi dal file di compilazione Ant alle directory del codice sorgente. I report di Code coverage useranno questi per evidenziare il codice sorgente. Ad esempio: src/java,src/Test.

codeCoverageFailIfEmpty - Esito negativo quando mancano i risultati della code coverage
Alias di input: failIfCoverageEmpty. boolean. facoltativo. Usare quando codeCoverageTool != None. Valore predefinito: false.

Non riesce la compilazione se il code coverage non ha prodotto risultati da pubblicare.

antHomeDirectory - Impostare ANT_HOME percorso
Alias di input: antHomeUserInputPath. string.

Se impostato, esegue l'override di qualsiasi variabile di ambiente ANT_HOME esistente con il percorso specificato.

javaHomeOption - Impostare JAVA_HOME per
Alias di input: javaHomeSelection. string. Obbligatorio. Valori consentiti: JDKVersion (versione JDK), Path. Valore predefinito: JDKVersion.

Imposta JAVA_HOME selezionando una versione JDK che verrà individuata durante le compilazioni o immettendo manualmente un percorso JDK.

jdkVersionOption - Versione JDK
Alias di input: jdkVersion. string. facoltativo. Usare quando javaHomeSelection = JDKVersion. Valori consentiti: default, 1.11 (JDK 11), (JDK 10 (fuori supporto) 1.9 ), (JDK 9 (fuori supporto)), (JDK 8 1.7 ), 1.10 (JDK 7 1.6 ), (JDK 6 (fuori supporto 1.8 )). Valore predefinito: default.

Tenta di individuare il percorso della versione JDK selezionata e imposta JAVA_HOME di conseguenza.

jdkUserInputDirectory - Percorso JDK
Alias di input: jdkUserInputPath. string. Obbligatorio quando javaHomeSelection = Path.

Imposta JAVA_HOME sul percorso specificato.

jdkArchitectureOption - Architettura JDK
Alias di input: jdkArchitecture. string. facoltativo. Usare quando jdkVersion != default. Valori consentiti: x86, x64. Valore predefinito: x64.

Facoltativamente, fornisce l'architettura (x86, x64) di JDK.

Opzioni di controllo delle attività

Tutte le attività dispongono di opzioni di controllo oltre ai relativi input attività. Per altre informazioni, vedere Opzioni di controllo e proprietà comuni delle attività.

Variabili di output

Nessuno.

Osservazioni

Usare questa attività per compilare con Apache Ant.

Requisiti

Requisito	Descrizione
Tipi di pipeline	YAML, build classica, versione classica
Viene eseguito in	Agente, DeploymentGroup
Richieste	Gli agenti self-hosted devono avere funzionalità che soddisfano le richieste seguenti per eseguire processi che usano questa attività: ant
Capabilities	Questa attività non soddisfa le richieste per le attività successive nel processo.
Restrizioni dei comandi	Qualsiasi
Variabili impostabili	Qualsiasi
Versione agente	1.89.0 o versione successiva
Categoria attività	Compilazione