Ant-Scripts generieren

Ant ist eine einfache Open-Source-Steuerkomponente für die Script-Erstellung, die im XML-Format geschriebene Scripts ausführen kann. Ant ist für die Ausführung von Tasks, die normalerweise zu einer automatisierten Erstellung gehören, optimal geeignet.

Die in der Datei build.properties von Plug-ins, Fragmenten und Komponenten definierten Eigenschaften werden durch die Scripts zur automatisierten Erstellung für Ant verwendet. PDE generiert Ant-Scripts für die Erstellung einzelner Plug-in- und Fragmenterstellungsdateien sowie ein Gesamt-Script für die Erstellung der Komponenten-JAR. Dieses "Haupt-Script" ist auch für die Ausführung der einzelnen Script-Dateien in der richtigen Reihenfolge zuständig (die Reihenfolge ist durch die Abhängigkeitskette der Plug-ins definiert). Jede Erstellungsdatei hat denselben Namen (build.xml) und wird als gleichgeordnetes Element der Manifestdateien in den entsprechenden Projekten erstellt.

Da Ant-Scripts die Ersetzungsvariablen in der Datei build.properties verwenden, können Sie diese Variablen normalerweise unverändert verwenden und müssen die generierten Scripts nicht modifizieren. Wenn Sie die Scripts ändern, dürfen Sie sie nicht jedes Mal erneut erstellen, wenn Sie die Komponente erneut erstellen wollen. Aus diesem Grund können Generierung und Ausführung von Scripts separat gesteuert werden.

Um Scripts zu erstellen, können Sie einfach im Komponentenmanifest auf die Schaltfläche Paket klicken. Wenn das Manifest nicht geöffnet ist, können Sie die Manifestdatei auswählen und dann im Kontextmenü die Option Komponenten-JAR erstellen auswählen (ein ähnlicher Befehl ist für Plug-ins und Fragmentmanifeste vorhanden). Der Befehl generiert das Erstellungs-Script und öffnet den Ant-Assistenten, um es auszuführen.

Ant-Ausführungsassistent, der verfügbare Ziel anzeigt

Der standardmäßige Ant-Assistent ermöglicht Ihnen das Anpassen auf zwei Arten: Bereitstellen der Ausführungsargumente und Auswahl eines oder mehrerer Erstellungsziele.

Ant-Argumente werden üblicherweise verwendet, um Eigenschaftswerte bereitzustellen, die Standardwerte außer Kraft setzen und den Erstellungsprozess steuern. Argumente werden mit "-Dproperty=value" festgelegt. Die folgenden Eigenschaften werden erkannt:

Wenn Sie Komponentenerstellungs-Scripts ausführen, werden die folgenden Ziele zum Aufrufen einzelner Ziele von Plug-ins oder Fragmenten verwendet. Geben Sie das auszuführende Ziel an, indem Sie die Eigenschaft Ziel festlegen (z. B. -Dtarget=refresh):

In diesem Szenario dient eines der Ziele all.* als Iterator. Dabei wird das eigentlich auszuführende Ziel über die Eigenschaft Ziel angegeben, wie oben beschrieben.

Die folgenden Ziel erstellen JAR-Dateien und Quellen für alle untergeordneten Elemente der Komponente:

Das Ziel build.update.jar kann ausgewählt werden, um eine JAR-Komponente im Format zu generieren, das vom Installations-/Aktualisierungsmechanismus verwendet wird. Die oben beschriebene Eigenschaft feature.destination kann verwendet werden, um festzulegen, wo die JAR-Datei platziert wird. plugin.destination steuert, wo die einzelnen Aktualisierungs-JAR-Dateien für Plug-ins und Fragmente platziert werden.

Das Ziel zip.distribution erstellt eine ZIP-Datei mit der Komponente und deren Plug-ins und Fragmenten in einer Struktur, die SDK ähnlich ist, allerdings enthält sie keinen Quellcode. Quellen können mit dem Ziel zip.sources generiert werden.

Verwenden Sie das Ziel clean, um Alles zu bereinigen, das durch das Ausführen von Zielen produziert wird. Schließlich führt das Ziel refresh eine "Aktualisierung" im aktuellen Projekt aus. Dadurch werden die neu generierten Ressourcen im "Navigator" oder "Package Explorer" sichtbar gemacht.

Wenn Sie Erstellungs-Scripts für einzelne Plug-ins und Fragmente ausführen, kann ein zusätzliches Ziel mit dem Namen zip.plugin verwendet werden. Dadurch wird eine ZIP-Datei mit dem Binär- und Quellinhalt eines Plug-ins mit der folgenden Struktur erstellt:

id_version/
    Inhalt

Dabei ist 'id' die für das Plug-in eindeutige Kennung und 'version' die Version des Plug-ins. Diese ZIP-Datei kann unmittelbar im Eclipse-Installationsverzeichnis als eine Form einer schnellen manuellen Implementierung dekomprimiert werden.

 

Copyright IBM Corporation und Andere 2000, 2002.