Ant@1 – Aufgabe "Ant v1"

Verwenden Sie diese Aufgabe, um mit Apache Ant zu erstellen.

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.

Eingaben

buildFile - Ant-Builddatei
Eingabealias: antBuildFile. string. Erforderlich. Standardwert. build.xml.

Der relative Pfad vom Repositorystamm zur Ant-Builddatei.

Weitere Informationen zu Builddateien finden Sie unter Verwenden von Apache Ant.

options - Optionen
string.

Stellt Optionen bereit, die an die Ant-Befehlszeile übergeben werden können. Sie können Ihre eigenen Eigenschaften (z. B -DmyProperty=myPropertyValue. ) angeben und auch integrierte Variablen verwenden (z. B -DcollectionId=$(system.collectionId). ). Alternativ werden die integrierten Variablen bereits während des Builds als Umgebungsvariablen festgelegt und können direkt übergeben werden (z. B -DcollectionIdAsEnvVar=%SYSTEM_COLLECTIONID%).

Weitere Informationen finden Sie unter Ausführen von Apache Ant.

targets - Ziel(en)
string.

Eine optionale, durch Leerzeichen getrennte Liste der zu erstellenden Ziele. Wenn nicht angegeben, wird das default Ziel verwendet. Wenn kein default Ziel definiert ist, erstellen Ant 1.6.0 und höher alle Aufgaben der obersten Ebene.

Weitere Informationen finden Sie unter Verwenden von Apache Ant-Zielen.

publishJUnitResults - Veröffentlichen in Azure Pipelines
boolean. Standardwert. true.

Wählen Sie diese Option aus, um vom Ant-Build erstellte JUnit-Testergebnisse in Azure Pipelines zu veröffentlichen. Jeder Testergebnisdateiabgleich Test Results Files wird als Testlauf in Azure Pipelines veröffentlicht.

testResultsFiles - Testergebnisdateien
string. Erforderlich, wenn publishJUnitResults = true. Standardwert. **/TEST-*.xml.

Der Dateipfad der Testergebnisse. Platzhalter können verwendet werden. Weitere Informationen finden Sie in der Referenz zu Dateiabgleichsmustern. Beispielsweise **/TEST-*.xml für alle XML-Dateien, deren Name mit TEST- beginnt.

testRunTitle - Titel der Testausführung
string. Optional. Verwenden Sie , wenn publishJUnitResults = true.

Stellt einen Namen für die Testausführung bereit.

codeCoverageToolOptions - Code Coverage-Tool
Eingabealias: codeCoverageTool. string. Zulässige Werte: None, Cobertura und JaCoCo. Standardwert. None.

Wählt das Code Coverage-Tool aus.

Wenn Sie die von Microsoft gehosteten Agents verwenden, sind die Tools für Sie eingerichtet. Wenn Sie den lokalen Windows-Agent verwenden, müssen Sie sicherstellen, dass der Agent für JaCoco oder Cobertura eingerichtet ist.

• JaCoCo: Stellen Sie sicher, dass jacocoant.jar im Ordner lib der Ant-Installation verfügbar ist. Erfahren Sie mehr über JaCoCo Ant-Aufgaben.
• Cobertura: Stellen Sie sicher, dass eine Umgebungsvariable COBERTURA_HOME auf den Speicherort cobertura .jar Dateien verweist. Erfahren Sie mehr über Cobertura mit Ant-Aufgaben.

Nachdem Sie eines dieser Tools ausgewählt haben, werden die folgenden Argumente angezeigt:

codeCoverageClassFilesDirectories - Klassendateienverzeichnisse
Eingabealias: classFilesDirectories. string. Erforderlich, wenn codeCoverageTool != None. Standardwert. ..

Die durch Trennzeichen getrennte Liste der relativen Pfade von der Ant-Builddatei zu Verzeichnissen, die Klassendateien und Archivdateien (.jar, .warusw.) enthalten. Die Codeabdeckung wird für Klassendateien in diesen Verzeichnissen gemeldet. Beispiel: target/classes,target/testClasses.

codeCoverageClassFilter - Klasseneinschluss-/Ausschlussfilter
Eingabealias: classFilter. string. Optional. Verwenden Sie , wenn codeCoverageTool != None.

Die durch Trennzeichen getrennte Liste der Filter, die Klassen einschließen oder von der Erfassung von Code Coverage ausschließen sollen. Beispiel: +:com., +:org., -:my.app*..

codeCoverageSourceDirectories - Quelldateienverzeichnisse
Eingabealias: srcDirectories. string. Optional. Verwenden Sie , wenn codeCoverageTool != None.

Die durch Trennzeichen getrennte Liste der relativen Pfade von der Ant-Builddatei zu den Quellcodeverzeichnissen. Code Coverage-Berichte verwenden diese Pfade, um Quellcode hervorzuheben. Beispiel: src/java,src/Test.

codeCoverageFailIfEmpty - Fehler, wenn Code coverage-Ergebnisse fehlen
Eingabealias: failIfCoverageEmpty. boolean. Optional. Verwenden Sie , wenn codeCoverageTool != None. Standardwert. false.

Schlägt beim Build fehl, wenn die Codeabdeckung keine Ergebnisse zur Veröffentlichung generiert hat.

antHomeDirectory - Festlegen ANT_HOME Pfads
Eingabealias: antHomeUserInputPath. string.

Wenn festgelegt, überschreibt jede vorhandene ANT_HOME Umgebungsvariable mit dem angegebenen Pfad.

javaHomeOption - Festlegen JAVA_HOME nach
Eingabealias: javaHomeSelection. string. Erforderlich. Zulässige Werte: JDKVersion (JDK-Version), Path. Standardwert. JDKVersion.

Legt JAVA_HOME entweder durch Auswählen einer JDK-Version fest, die während builds ermittelt wird, oder durch manuelle Eingabe eines JDK-Pfads.

jdkVersionOption - JDK-Version
Eingabealias: jdkVersion. string. Optional. Verwenden Sie , wenn javaHomeSelection = JDKVersion. Zulässige Werte: default, 1.11 (JDK 11), 1.10 (JDK 10 (nicht unterstützt)), 1.9 (JDK 9 (nicht unterstützt)), 1.8 (JDK 8), 1.7 (JDK 7), 1.6 (JDK 6 (nicht unterstützt)). Standardwert. default.

Versucht, den Pfad zur ausgewählten JDK-Version zu ermitteln, und legt JAVA_HOME entsprechend fest.

jdkUserInputDirectory - JDK-Pfad
Eingabealias: jdkUserInputPath. string. Erforderlich, wenn javaHomeSelection = Path.

Legt JAVA_HOME auf den angegebenen Pfad fest.

jdkArchitectureOption - JDK-Architektur
Eingabealias: jdkArchitecture. string. Optional. Verwenden Sie , wenn jdkVersion != default. Zulässige Werte: x86, x64. Standardwert. x64.

Stellt optional die Architektur (x86, x64) des JDK bereit.

Optionen für die Vorgangskontrolle

Alle Vorgänge verfügen zusätzlich zu ihren Eingaben über Steuerungsoptionen. Weitere Informationen finden Sie unter Steuerungsoptionen und allgemeine Aufgabeneigenschaften.

Ausgabevariablen

Keine.

Hinweise

Verwenden Sie diese Aufgabe, um mit Apache Ant zu erstellen.

Anforderungen

Anforderung	BESCHREIBUNG
Pipelinetypen	YAML, Klassischer Build, klassische Version
Wird ausgeführt auf	Agent, DeploymentGroup
Forderungen	Selbstgehostete Agents müssen über Funktionen verfügen, die den folgenden Anforderungen entsprechen , um Aufträge auszuführen, die diese Aufgabe verwenden: ant
Capabilities	Diese Aufgabe erfüllt keine Anforderungen an nachfolgende Aufgaben im Auftrag.
Befehlseinschränkungen	Any
Einstellbare Variablen	Any
Agent-Version	1.89.0 oder höher
Aufgabenkategorie	Entwickeln