Freigeben über

Ant@1 – Vorgang "Ant v1"

  • Artikel

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.

Eingänge

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


options - Optionen
string.

Bietet Optionen zum Übergeben an die Ant-Befehlszeile. Sie können eigene Eigenschaften (z. B. -DmyProperty=myPropertyValue) bereitstellen 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%).

Siehe Running Apache Ant.


targets - Target(s)
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, erstellt Ant 1.6.0 und höher alle Aufgaben der obersten Ebene.

Siehe Using Apache Ant Targets.


publishJUnitResults - In Azure-Pipelines veröffentlichen
boolean. Standardwert: true.

Wählen Sie diese Option aus, um JUnit-Testergebnisse zu veröffentlichen, die vom Ant-Build in Azure-Pipelines erstellt wurden. Jede Testergebnissedatei, die Test Results Files abgleicht, wird als Testlauf in Azure Pipelines veröffentlicht.


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

Der Dateipfad der Testergebnisse. Platzhalter können verwendet werden. Weitere Informationen finden Sie im Dateiabgleichsmuster. Beispiel: **/TEST-*.xml für alle XML-Dateien, deren Name mit TEST-beginnt.


testRunTitle - Titel der Testausführung
string. Wahlfrei. Wird verwendet, wenn publishJUnitResults = true.

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


codeCoverageToolOptions - Codeabdeckungstool
Eingabealias: codeCoverageTool. string. Zulässige Werte: None, Cobertura, JaCoCo. Standardwert: None.

Wählt das Codeabdeckungstool aus.

Wenn Sie die von Microsoft gehosteten Agentsverwenden, werden die Tools für Sie eingerichtet. Wenn Sie den lokalen Windows-Agentverwenden, 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 der Dateien cobertura .jar verweist. Erfahren Sie mehr über Cobertura mit Ant-Aufgaben.

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


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

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


codeCoverageClassFilter - Klasseneinschluss-/Ausschlussfilter
Eingabealias: classFilter. string. Wahlfrei. Wird verwendet, wenn codeCoverageTool != None.

Die durch Trennzeichen getrennte Liste der Filter, die Klassen aus dem Sammeln von Codeabdeckung einschließen oder ausschließen sollen. Beispiel: +:com., +:org., -:my.app*..


codeCoverageSourceDirectories - Quelldateien
Eingabealias: srcDirectories. string. Wahlfrei. Wird verwendet, wenn codeCoverageTool != None.

Die durch Trennzeichen getrennte Liste der relativen Pfade aus der Ant-Builddatei zu Quellcodeverzeichnissen. Codeabdeckungsberichte verwenden diese, um Quellcode hervorzuheben. Beispiel: src/java,src/Test.


codeCoverageFailIfEmpty - Fehlschlagen, wenn die Ergebnisse der Codeabdeckung
Eingabealias: failIfCoverageEmpty. boolean. Wahlfrei. Wird verwendet, wenn codeCoverageTool != None. Standardwert: false.

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


antHomeDirectory - Festlegen ANT_HOME Pfads
Eingabealias: antHomeUserInputPath. string.

Wenn festgelegt, überschreibt eine 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 fest, indem entweder eine JDK-Version ausgewählt wird, die während der Builds erkannt wird, oder indem sie manuell einen JDK-Pfad eingeben.


jdkVersionOption - JDK-Version
Eingabealias: jdkVersion. string. Wahlfrei. Wird verwendet, 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. Wahlfrei. Wird verwendet, wenn jdkVersion != default. Zulässige Werte: x86, x64. Standardwert: x64.

Gibt optional die Architektur (x86, x64) des JDK an.


Aufgabensteuerungsoptionen

Alle Aufgaben verfügen zusätzlich zu ihren Aufgabeneingaben über Steuerungsoptionen. Weitere Informationen finden Sie unter Steuerelementoptionen und allgemeinen Aufgabeneigenschaften.

Ausgabevariablen

Keiner.

Bemerkungen

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

Anforderungen

Anforderung BESCHREIBUNG
Pipelinetypen YAML, Classic Build, Classic Release
Läuft auf Agent, DeploymentGroup
Anforderungen Selbst gehostete Agents müssen über Funktionen verfügen, die den folgenden Anforderungen zum Ausführen von Aufträgen entsprechen, die diese Aufgabe verwenden:
Funktionen Dieser Vorgang erfüllt keine Anforderungen für nachfolgende Vorgänge im Auftrag.
Befehlseinschränkungen Jegliche
Settable-Variablen Jegliche
Agentversion 1.89.0 oder höher
Vorgangskategorie Bauen