Condividi tramite

Ant@1 - Attività Ant v1

  • Articolo

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.

Ingressi dati

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 Using Apache Ant.


options - Opzioni
string.

Fornisce opzioni da passare alla riga di comando Ant. È possibile specificare proprietà personalizzate ( ad esempio, -DmyProperty=myPropertyValue) e usare anche le 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.


target targets -
string.

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

Vedere uso di destinazioni Apache Ant.


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

Selezionare questa opzione per pubblicare i risultati dei test JUnit generati dalla compilazione Ant in Azure Pipelines. Ogni file di risultati del 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 utilizzare caratteri jolly. Per altre informazioni, vedere il riferimento ai criteri di corrispondenza dei file . Ad esempio, **/TEST-*.xml per tutti i file XML il cui nome inizia con TEST-.


testRunTitle - Titolo esecuzione test
string. Opzionale. 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 di 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 di percorsi relativi dal file di compilazione Ant alle directory contenenti file di classe e file di archivio (.jar, .ware così via). Il code coverage viene segnalato per i file di classe in queste directory. Ad esempio: target/classes,target/testClasses.


codeCoverageClassFilter - filtri di inclusione/esclusione di classi
Alias di input: classFilter. string. Opzionale. Usare quando codeCoverageTool != None.

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


codeCoverageSourceDirectories - directory dei file di origine
Alias di input: srcDirectories. string. Opzionale. 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 elementi per evidenziare il codice sorgente. Ad esempio: src/java,src/Test.


codeCoverageFailIfEmpty - Fail when code coverage results are missing
Alias di input: failIfCoverageEmpty. boolean. Opzionale. Usare quando codeCoverageTool != None. Valore predefinito: false

Non riesce la compilazione se il code coverage non ha prodotto alcun risultato 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 di JDK
Alias di input: jdkVersion. string. Opzionale. Usare quando javaHomeSelection = JDKVersion. Valori consentiti: default, 1.11 (JDK 11), 1.10 (JDK 10 (non supportato)), 1.9 (JDK 9 (non supportato)), 1.8 (JDK 8), 1.7 (JDK 7), 1.6 (JDK 6 (non supportato)). 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. Opzionale. 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 corrispondono alle seguenti richiedono di eseguire processi che usano questa attività:
funzionalità di Questa attività non soddisfa alcuna richiesta di attività successive nel processo.
restrizioni dei comandi Qualunque
variabili impostabili Qualunque
Versione dell'agente 1.89.0 o versione successiva
Categoria attività Costruire