Quelltext der Seite Apache Ant

{{Infobox Software
| Name                              = <!-- Nur falls abweichend vom Artikelnamen -->
| Logo                              = [[Datei:Apache-Ant-logo.svg|200px|Apache Ant Logo – Entworfen von Nick King]]
| Screenshot                        = <!-- Bildschirmfoto -->
| Beschreibung                      = <!-- Beschreibung des Bildschirmfotos -->
| Maintainer                        =
| Hersteller                        = [[Apache Software Foundation]]
| Erscheinungsjahr                  = 19. Juli 2000<br /><small>(Version 1.1)</small>
| AktuelleVersion                   = <!-- Wikidata -->
| AktuelleVersionFreigabeDatum      = <!-- Wikidata -->
| AktuelleVorabVersion              = 
| AktuelleVorabVersionFreigabeDatum = 
| Betriebssystem                    = <!-- Wikidata -->
| Programmiersprache                = <!-- Wikidata -->
| Kategorie                         = [[Erstellungsprozess|Build-Management]]-Tool
| Lizenz                            = <!-- Wikidata -->
| Deutsch                           = 
| Website                           = [https://ant.apache.org/ ant.apache.org]
| Sonstiges                         =
}}

'''Apache Ant''' ({{enS}} für ''[[Ameise]]'') ist ein in [[Java (Programmiersprache)|Java]] geschriebenes Programm zum [[Erstellungsprozess|automatisierten Erzeugen]] von ausführbaren [[Computerprogramm]]en aus [[Quelltext]]en.

Es erfüllt den gleichen Zweck wie das sehr verbreitete Programm [[make]], nämlich die automatisierte Erstellung von installierbaren Software-Paketen aus existierendem Quelltext, [[Programmbibliothek|Bibliotheken]] und sonstigen Dateien. Ant ist [[Open Source]], startete als Teil des [[Jakarta-Projekt]]s und ist nun ein [[Apache Software Foundation|Apache]]-Top-Level-Projekt. Ant ist ein [[Apronym]]<!--Ein Apronym ist ein besonderes Akronym (Siehe Link). Stehenlassen!--> und steht für „Another Neat Tool“ (englisch für „Noch ein hübsches Werkzeug“). Entwickelt wurde die erste Version von [[James Duncan Davidson]], der [[1999]] ein Werkzeug wie make für Java benötigte, während er die erste [[Jakarta EE|Jakarta-EE]]-Referenz-Implementierung entwickelte. Davidson gilt außerdem als Vater von [[Jakarta Tomcat]]. Für ihn steht der Name „Ant“ dafür, dass es als kleines Programm, genau wie die kleinen Ameisen, Großes leisten kann.

== Beschreibung ==
Im Unterschied zu ''[[make]]'' ist Ant in [[Java (Programmiersprache)|Java]] implementiert und benötigt somit zur Ausführung eine [[Java-Laufzeitumgebung]] (JRE).

=== Begriffe ===
Gesteuert wird Ant durch eine [[Extensible Markup Language|XML]]-Datei, die sogenannte ''Build-Datei''. Sie heißt standardmäßig <code>build.xml</code>. In der Build-Datei wird ein ''project'' (deutsch „Projekt“) definiert. Dies ist das Wurzelelement der XML-Datei. Zu einem Software-Projekt sollte genau eine Build-Datei und damit genau ein Ant-Project gehören.

Das Ant-Project enthält ''Targets'' (deutsch „Ziele“). Diese sind vergleichbar mit Funktionen in [[Programmiersprache]]n und können von außen, zum Beispiel vom Entwickler über die [[Kommandozeileninterpreter|Kommandozeile]] oder die [[Integrierte Entwicklungsumgebung|Entwicklungsumgebung]], gezielt aufgerufen werden. Die Targets sollten in ihrer Gesamtheit alle bei der Arbeit mit einem Software-Projekt anfallenden Tätigkeiten abdecken. Zwischen den ''Targets'' können Abhängigkeiten definiert werden, entsprechend den Anforderungen an die Abhängigkeiten. Beim Aufrufen eines Targets löst Ant diese Abhängigkeiten auf und arbeitet die Targets entsprechend ab. Wenn man ein Target definiert hat, welches direkt oder indirekt Abhängigkeiten zu anderen Targets hat, so genügt es, dieses aufzurufen und Ant führt dann alle notwendigen Arbeitsschritte in der richtigen Reihenfolge aus.

Im Project kann ein Target als ''Default-Target'' angegeben werden. Dies ist normalerweise das Target, das aus dem Rohzustand oder einem Zwischenzustand des Software-Projektes die jeweils nötigen Schritte durchführt, um einen lauffähigen Zustand herzustellen.

Ein Target besteht aus Aufrufen von ''Tasks'' (deutsch „Aufgaben“). Sie sind vergleichbar mit Befehlen in Programmiersprachen.

=== Syntax und Schnittstellen ===
Da es sich bei der ''Build-Datei'' um eine XML-Datei handelt, hängt ihre Bedeutung nicht von [[Tabulatorzeichen]], [[Leerzeichen]] oder Pfadtrennzeichen ab, die auf unterschiedlichen [[Betriebssystem]]en unterschiedlich definiert sind. Dies ist insbesondere eine Verbesserung gegenüber den von make benutzten [[Makefile]]s.

Ant ist ein offenes System mit definierten Schnittstellen, wodurch es z.&nbsp;B. durch selbst erstellte Tasks beliebig erweitert werden kann. Viele Java-Werkzeuge unterstützen Ant. Außerdem lässt es sich auch in eigene Anwendungen –&nbsp;z.&nbsp;B. Installationsprogramme&nbsp;– einbinden, um verschiedenste meist [[Stapelverarbeitung|Batch]]-artige Aufgaben zu übernehmen.

== Häufig verwendete Tasks ==
Ant enthält über 150 Tasks, wobei man auch eigene Tasks in Java selbst programmieren kann. Diese Liste enthält einige eingebaute (englisch ''built-in'') Tasks von Ant.
* ''javac'' zum [[Kompilieren]] von Quellcode.
* ''copy'' zum Kopieren von [[Datei]]en.
* ''delete'' zum Löschen von Dateien oder [[Verzeichnis]]sen.
* ''mkdir'' zum Erstellen von [[Verzeichnis]]sen.
* ''junit'' für automatisierte ([[JUnit]]-)Tests.
* ''move'' zum Umbenennen von Dateien oder Verzeichnissen.
* ''exec'' zum Ausführen von System-Programmen. Achtung: Bei Benutzung dieses Tasks begibt man sich häufig in die Abhängigkeit eines Betriebssystems!
* ''zip'' zum [[ZIP-Dateiformat|Zippen]], also zum Komprimieren von Dateien.
* ''cvs'' zum Durchführen von [[Concurrent Versions System|CVS]]-Operationen.
* ''mail'' zum Versenden von [[E-Mail]]s.
* ''replace'' zum Ersetzen von Text in Dateien.
Flexibel einsetzbar ist auch der vordefinierte Task ''Xslt'' zur Transformation einer XML-Datei in z.&nbsp;B. eine HTML-Datei unter Verwendung einer gegebenen [[XSL Transformation|XSLT]]-Datei.

== Beispiele für Targets ==
Während Tasks als Java-Klassen implementiert sind, werden Targets in XML definiert und rufen Tasks auf. Es können auch eigene Tasks in Form von Java-Klassen erstellt werden.

Der folgende Ausschnitt aus einer typischen Build-Datei zeigt zwei Targets: ''build'' erzeugt ein Verzeichnis und kompiliert eine Menge von Java-Klassen dort hinein. Es hängt von einem anderen Target ''clean'' ab, das zuvor einige Verzeichnisse und Dateien löscht, um Überbleibsel früherer Aufrufe zu beseitigen.
<syntaxhighlight lang="xml">

<?xml version="1.0"?>
 <project name="Demo" basedir="." default="build">
  <property name="build.classes" value="bin" />
  <property name="build.lib" value="lib" />
  <property name="java.dir" value="." />
  <property name="name" value="Wikipedia-Demo" />
  <property name="manifest" value="manifest" />

  <path id="classpath">
      <pathelement location="." />
  </path>

  <!-- Anwendung bauen  -->
  <target name="build" depends="clean" description="Baut die komplette Anwendung">
    <!-- Verzeichnis anlegen -->
    <mkdir dir="${build.classes}"/>

    <!-- Quelltext kompilieren -->
    <javac srcdir="${java.dir}"
           destdir="${build.classes}"
           debug="false"
           deprecation="true"
           optimize="true" >
      <classpath refid="classpath" />
    </javac>

    <!-- Kopiert notwendige Dateien -->
    <copy todir="${build.classes}">
      <fileset dir="${java.dir}">
        <include name="**/*.properties" />
        <include name="**/*.gif" />
      </fileset>
    </copy>

    <!-- Baut die JAR-Datei -->
    <jar jarfile="${build.lib}/${name}.jar" manifest="${manifest}">
      <fileset dir="${build.classes}"/>
    </jar>
  </target>

  <!-- Aufräumen  -->
  <target name="clean" description="Räumt die temporär angelegten Dateien weg">
    <!-- Löscht Dateien -->
    <delete dir="${build.dir}" />
    <delete dir="${dist.base}" />
    <delete dir="${defaultdist.dir}" />
    <delete>
      <fileset dir="." includes="**/*~" defaultexcludes="no"/>
    </delete>
  </target>
</project>

</syntaxhighlight>
Die mit einem Dollar-Zeichen ($) versehenen Bereiche stellen ''Properties'' dar. Es handelt sich dabei um vorher im Projekt oder in anderen ''Targets'' definierte Variablen.

== Siehe auch ==
* [[Apache Maven]] – konkurrierendes Build-Management-Tool für Java
* [[Apache Ivy]] – Subprojekt von Apache Ant zur Verwaltung und Einbindung von Abhängigkeiten
* [[Gradle]] – weiteres Build-Management-Tool für Java

== Literatur ==
* Bernd Matzke: ''Ant''. Addison-Wesley, ISBN 3-8273-2066-6
* Erik Hatcher, Steve Loughran: ''Java-Entwicklung mit Ant''. Mitp-Verlag 2004, ISBN 3-8266-1409-7
* Stefan Edlich: ''Ant kurz & gut''. O’Reilly 2006, ISBN 3-89721-241-2
* Jessy Tilly, Eric M. Burke: ''Ant, The Definitive Guide''. O’Reilly 2002, ISBN 0-596-00184-3
* Steve Loughran, Eric Hatcher: ''Ant in Action, Second Edition of Java Development with Ant''. Manning, ISBN 1-932394-80-X
* Gunther Popp: ''Projektautomatisierung mit Ant''. In: ''Konfigurationsmanagement''. dpunkt-Verlag, ISBN 978-3-89864-487-7

== Weblinks ==
* [https://ant.apache.org/ Offizielle Website]

== Einzelnachweise ==
<references responsive />

{{Normdaten|TYP=s|GND=4689797-5|LCCN=n/2002/66009|VIAF=181177554}}

[[Kategorie:Apache-Projekt]]
[[Kategorie:Java-Programmierwerkzeug]]
[[Kategorie:Freies Programmierwerkzeug]]
[[Kategorie:Java-Programm]]
[[Kategorie:Java-Bibliothek]]
[[Kategorie:Build-Management]]