Programme für schrittweise Projekterstellung
Kennung:
org.eclipse.core.resources.builders
Beschreibung:
Der Areitsbereichunterstützt das Konzept eines Programms für die schrittweise Projekterstellung (oder kurz "Erstellungsprogramm" genannt). Aufgabe eines Erstellungsprogramms ist die Verarbeitung einer Reihe von Ressourcenänderungen (die als Ressourcendelta bereitgestellt werden). Ein Java-Erstellungsprogramm würde beispielsweise geänderte Java-Dateien erneut kompilieren und neue Klassendateien erzeugen.
Erstellungsprogramme werden projektbezogen konfiguriert und automatisch ausgeführt, sobald Ressourcen im jeweiligen Projekt geändert werden. Insofern sollten sich Durchsatz und Leistungsfähigkeit von Erstellungsprogrammen nicht an der Anzahl der Ressourcen im Projekt, sondern vielmehr am Umfang der vorgenommenen Änderungen orientieren. Dies impliziert typischerweise, dass Erstellungsprogramme in der Lage sind, 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 ID der Erstellungsprogrammerweiterung. Beim Definieren einer Erstellungsprogrammerweiterung sollten Benutzer einen aussagekräftigen Wert für das Attribut "Name" einbeziehen, der ihr Erstellungsprogramm identifiziert und möglicherweise Benutzern vorgestellt werden könnte.
Konfigurationsbefehle:
<!ELEMENT extension (builder)>
<!ATTLIST extension
point CDATA #REQUIRED
id CDATA #REQUIRED
name CDATA #IMPLIED>
- point - Vollständig qualifizierte ID des Zielerweiterungspunkts
- id - Optionale ID des Erweiterungsexemplars
- name - Optionaler Name des Erweiterungsexemplars
<!ELEMENT builder (run?)>
<!ATTLIST builder
hasNature (true | false)
isConfigurable (true | false) >
- hasNature - Mit "true" oder "false" wird angegeben, ob eine Projektgattung Eigner des Erstellungsprogramms ist oder nicht. Falls "true" angegeben ist und keine entsprechende Gattung gefunden wird, wird das Erstellungsprogramm nicht ausgeführt, verbleibt allerdings in der Erstellungsspezifikation des Projekts. Wenn dieses Attribut nicht angegeben ist, wird von der Einstellung "false" ausgegangen.
- isConfigurable - Mit "true" oder "false" wird angegeben, ob das Erstellungsprogramm eine Anpassung des Erstellungsauslösers, auf den es reagiert, zulässt. Bei "true" sind Clients in der Lage, die API ICommand.setBuilding zu verwenden, um anzugeben, ob dieses Erstellungsprogramm für einen bestimmten Erstellungsauslöser ausgeführt werden soll. Wenn dieses Attribut nicht angegeben ist, wird von der Einstellung "false" ausgegangen.
<!ELEMENT run (parameter*)>
<!ATTLIST run
class CDATA #REQUIRED>
- class - Der vollständig qualifizierte Name einer Unterklasse von
org.eclipse.core.resources.IncrementalProjectBuilder.
<!ELEMENT parameter EMPTY>
<!ATTLIST parameter
name CDATA #REQUIRED
value CDATA #REQUIRED>
- name: Der Name dieses Parameters, der für Exemplare der
angegebenen Erstellungsprogrammklasse zur Verfügung gestellt wird.
- value: Ein willkürlicher Wert, der dem gegebenen Namen
zugeordnet ist und Exemplaren der angegebenen
Erstellungsprogrammklasse zur Verfügung gestellt wird.
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-Information:
Der Wert des Attributs "class" muss eine Unterklasse von
org.eclipse.core.resources.IncrementalProjectBuilder implementieren.
Bereitgestellte Implementierung:
Die Plattform selbst stellt keine vordefinierten Erstellungsprogramme bereit. Spezielle
Produktinstallationen können ggfs. Erstellungsprogramme enthalten.
Copyright (c) 2002, 2005 IBM Corporation und Andere.
Alle Rechte vorbehalten. Dieses Programm und sein Begleitmaterial werden gemäß den Bedingungen der "Eclipse Public License v1.0" zur Verfügung gestellt, die dieser Lieferung beiliegt und unter
http://www.eclipse.org/legal/epl-v10.html abgerufen werden kann.