Erstellung konfigurieren

Der Mechanismus für die Komponentenerstellung wird durch eine Erstellungskonfiguration gesteuert. Die Erstellungskonfiguration für ein einzelnes Plug-in, ein Fragment oder eine einzelne Komponente befindet sich in einer Datei build.properties für das betreffende Element.

PDE stellt Assistenten zur Verfügung, die die Datei build.properties für alle Plug-ins und Fragmente erstellt, die in einer Komponente gepackt werden. Die Datei build.properties enthält Informationen dazu, wie Quellenordner in JAR-Dateien kompiliert werden. Normalerweise verwenden Sie zum Ändern dieser Datei den Editor für Komponentenmanifeste. Sie können aber auch einen anderen Editor benutzen, um Einträge direkt zur Datei hinzuzufügen.

PDE bietet einen einfachen Editor für die Datei build.properties, der eine Format- und eine Quellensicht enthält. Die Datei selbst verwendet das Format für Java-Eigenschaften. Sie müssen eine Reihe von Schlüsseln und ihre entsprechenden Werte angeben. Mehrere Werte werden durch ein Komma als Begrenzer voneinander abgegrenzt.

Es gibt insgesamt sechs Stellen, an denen Text durch ein Plug-in oder ein Fragment angegeben werden kann, der in die Erstellung aufgenommen werden soll:

Die an diesen Punkten definierten Werte werden in Form von Ant-"Mustern" ausgedrückt. Normalerweise handelt es sich hierbei um eine durch Kommata untergliederte Liste von Zeichenfolgen, mit denen Übereinstimmungen vorliegen müssen.

Standardformate produzieren die erwarteten Ergebnisse. Der Wert .jar beispielsweise gibt alle JAR-Dateien im Verzeichnis der höchsten Ebene an.

Die Muster dringen standardmäßig nicht sehr tief in die Struktur ein. Wenn Sie beispielsweise alle Java-Dateien beschreiben wollen, sollten Sie das Muster **/*.java verwenden. Das Muster ** entspricht einer beliebigen Anzahl von Verzeichnisebenen. Analog sollten Sie zur Beschreibung aller Unterbaumstrukturen den Wert foo/ verwenden. 

Für diese Punkte werden immer automatisch Standardwerte mit Kennungen im Format auto.<letzter_teil_der_punktsegment-id> generiert, damit Sie diese Standardwerte bei Bedarf durch Überschreiben erweitern können. Zum Festlegen von Überschreibungswerten definiert ein Plug-in zusätzliche Eigenschaften im Format "Name/Wert" in der bereits beschriebenen Datei build.properties. Einige Beispiele:

bin.includes=plugin.xml,*.jar
javadoc.packages=${auto.packages},org.eclipse.core.target.*
src.excludes=${auto.excludes},*Hack.java

Wenn diese Werte im Editor für die Datei build.properties eingegeben werden, sieht dieser etwa so aus: