Programme für schrittweise Projekterstellung

Kennung: org.eclipse.core.resources.builders

Beschreibung: Der Arbeitsbereich unterstützt das Konzept eines Programms zur schrittweisen Projekterstellung (kurz "Erstellungsprogramm" genannt). Aufgabe eines Erstellungsprogramms ist die Verarbeitung einer Reihe von Ressourcenänderungen, die in Form eines Ressourcendeltas bereitgestellt werden. Ein Java-Erstellungsprogramm würde beispielsweise Java-Dateien erneut kompilieren und neue Klassendateien erzeugen.

Erstellungsprogramme werden für jedes Projekt separat konfiguriert und automatisch ausgeführt, wenn Ressourcen im jeweiligen Projekt geändert werden. Schnelligkeit und Umfang von Erstellungsprogrammen sollten sich insofern an der Menge der Änderungen und nicht an der Anzahl der Ressourcen im Projekt orientieren. Dies impliziert normalerweise, dass Erstellungsprogramme in der Lage sein müssen, ihren "Erstellungsstatus" schrittweise zu aktualisieren.

Am Erweiterungspunkt für Erstellungsprogramme können Erstellungsprogramme ihre Erstellungsprogrammimplementierungen unter einem symbolischen Namen registrieren, der dann im Arbeitsbereich verwendet wird, um Erstellungsprogramme aufzufinden und auszuführen. Der symbolische Name ist die Kennung der Erstellungsprogrammerweiterung. Beim Definieren einer Erstellungsprogrammerweiterung sollten Benutzer einen aussagekräftigen Wert für das Attribut "name" verwenden, das das Erstellungsprogramm kennzeichnet und möglicherweise auch für andere Benutzer angezeigt wird.

Konfigurationsbefehle:

   <!ELEMENT builder run?>
   <!ATTLIST builder
      hasNature    CDATA #IMPLIED
   >

   <!ELEMENT run parameter*>   <!ATTLIST run
      class          CDATA #REQUIRED
   >    <!ELEMENT parameter EMPTY>
   <!ATTLIST parameter
      name         CDATA #REQUIRED
      value        CDATA #REQUIRED
   > Beispiele:

Das folgende Beispiel stellt die Konfiguration eines Erstellungsprogramms dar:

   <extension id="coolbuilder" name="Cool Builder" point="org.eclipse.core.resources.builders">
      <builder hasNature="false">
         <run class="com.xyz.builders.Cool">
            <parameter name="optimize" value="true"/>
            <parameter name="comment" value="Produced by the Cool Builder"/>
         </run>
      </builder>
   </extension>

Wenn diese Erweiterung in einem Plug-in mit der Kennung "com.xyz.coolplugin" definiert wurde, wäre der vollständig qualifizierte Name dieses Erstellungsprogramms "com.xyz.coolplugin.coolbuilder".

API-Informationen: Der Wert des Attributs class muss eine Unterklasse von org.eclipse.core.resources.IncrementalProjectBuilder sein.

Bereitgestellte Implementierung: Die Plattform selbst stellt keine vordefinierten Erstellungsprogramme bereit. Spezielle Produktinstallationen können ggfs. Erstellungsprogramme enthalten.

Copyright IBM Corp. 2000, 2002. Alle Rechte vorbehalten.