Importaufgaben werden verwendet, um eine Build-Datei in das aktuelle Projekt zu importieren. Die importierten Dateien werden mithilfe von ProjectHelper analysiert. Der ProjectHelper ist eigentlich für das Parsen der importierten Dateien verantwortlich.
Wolf gegen Fuchs
Die Importaufgabe ist eine Aufgabe der obersten Ebene und kann daher nicht innerhalb des Zielelements verwendet werden. Es gibt zwei funktionale Aspekte, die mit dieser Aufgabe zusammenhängen.
Zielüberschreibung
Wenn ein Ziel in der aktuellen Datei auch in der importierten Datei verfügbar ist, hat das Ziel der aktuellen Datei Vorrang.
Besondere Eigenschaften
Importierte Dateien sind lokal im aktuellen Hauptprojekt. Um zwischen importierten und lokalen Dateien zu unterscheiden, fügt Ant eine Eigenschaft hinzu, die den Pfad zur importierten Build-Datei enthält.
Hinweis: Wenn die importierte Datei kein Namensattribut enthält, wird die Eigenschaft nicht festgelegt.
Attribute der Apache Ant-Importaufgabe
| Attribut | Beschreibung | Erforderlich |
|---|---|---|
| Datei | Die zu importierende Datei. | Ja |
| Optional | Wenn „true“, den Build nicht stoppen, wenn die Datei nicht vorhanden ist. | NEIN |
| als | Gibt das Präfix an, das den Zielnamen vorangestellt wird. | NEIN |
| PräfixTrennzeichen | Ein Trennzeichen, das zwischen dem Präfix und dem Zielnamen verwendet wird. | NEIN |
Beispiel für eine Apache Ant-Importaufgabe
Der folgende Code importiert Ziele aus der Datei common-targets.xml, die sich im übergeordneten Verzeichnis befindet.
Es importiert ein Projekt
Es importiert das Ziel aus der Datei „targets.xml“, die sich im gemeinsamen Verzeichnis befindet.