Featuremanifest der Eclipse-Plattform
Version 3.0 - Letzte Aktualisierung: 22. Juni 2004
Das Format des Featuremanifests wird durch die folgende DTD definiert:
<?xml encoding="ISO-8859-1"?>
<!ELEMENT feature (install-handler? | description? | copyright? |
license? | url? | includes* | requires? | plugin* | data*)>
<!ATTLIST feature
id
CDATA #REQUIRED
version
CDATA #REQUIRED
label
CDATA #IMPLIED
provider-name CDATA #IMPLIED
image
CDATA #IMPLIED
os
CDATA #IMPLIED
arch
CDATA #IMPLIED
ws
CDATA #IMPLIED
nl
CDATA #IMPLIED
colocation-affinity
CDATA #IMPLIED
primary
(true | false) "false"
exclusive (true | false)
"false"
plugin CDATA
#IMPLIED
application CDATA #IMPLIED
>
<!ELEMENT install-handler EMPTY>
<!ATTLIST install-handler
library
CDATA #IMPLIED
handler
CDATA #IMPLIED
>
<!ELEMENT description (#PCDATA)>
<!ATTLIST description
url
CDATA #IMPLIED
>
<!ELEMENT copyright (#PCDATA)>
<!ATTLIST copyright
url
CDATA #IMPLIED
>
<!ELEMENT license (#PCDATA)>
<!ATTLIST license
url
CDATA #IMPLIED
>
<!ELEMENT url (update?, discovery*)>
<!ELEMENT update EMPTY>
<!ATTLIST update
url
CDATA #REQUIRED
label
CDATA #IMPLIED
>
<!ELEMENT discovery EMPTY>
<!ATTLIST discovery
type
(web | update) "update"
url
CDATA #REQUIRED
label
CDATA #IMPLIED
>
<!ELEMENT includes EMPTY>
<!ATTLIST includes
id
CDATA #REQUIRED
version CDATA #REQUIRED
name
CDATA #IMPLIED
optional (true | false)
"false"
search-location (root | self | both)
"root"
os
CDATA #IMPLIED
arch
CDATA #IMPLIED
ws
CDATA #IMPLIED
nl CDATA #IMPLIED
>
<!ELEMENT requires (import+)>
<!ELEMENT import EMPTY>
<!ATTLIST import
plugin
CDATA #IMPLIED
feature CDATA #IMPLIED
version
CDATA #IMPLIED
match
(perfect | equivalent | compatible | greaterOrEqual) "compatible"
patch (true |
false) "false"
>
<!ELEMENT plugin EMPTY>
<!ATTLIST plugin
id
CDATA #REQUIRED
version
CDATA #REQUIRED
fragment (true
| false) "false"
os
CDATA #IMPLIED
arch
CDATA #IMPLIED
ws
CDATA #IMPLIED
nl
CDATA #IMPLIED
download-size CDATA #IMPLIED
install-size CDATA #IMPLIED
unpack (true |
false) "true"
>
<!ELEMENT data EMPTY>
<!ATTLIST data
id
CDATA #REQUIRED
os
CDATA #IMPLIED
arch
CDATA #IMPLIED
ws
CDATA #IMPLIED
nl
CDATA #IMPLIED
download-size CDATA #IMPLIED
install-size CDATA #IMPLIED
>
Die Elemente und Attribute werden wie folgt definiert:
- <feature> - definiert die Komponente
- id - Erforderliche Komponentenkennung (z.B. com.xyz.myfeature)
- version: Erforderliche Komponentenversion (z. B. 1.0.3).
- label - Optional anzeigbare Bezeichnung (Name). Zur Übersetzung gedacht.
- provider-name - Optionale Anzeigebezeichnung zur Identifikation der Organisation, die diese Komponente bereitstellt. Zur Übersetzung gedacht.
- image - Optionales Image, das zum Anzeigen von Informationen über das Feature verwendet wird.
Wird relativ zur Datei feature.xml angegeben.
- os - Optionale Spezifikation des Betriebssystems. Eine durch Kommas getrennte Aufstellung von Betriebssystem-Laufwerkskennzeichungen, die von Eclipse definiert werden (siehe Javadoc für
org.eclipse.core.runtime.Platform).
Weist darauf hin, dass diese Komponente nur auf einem der angegebenen Betriebssysteme installiert werden sollte. Wenn dieses Attribut nicht angegeben wird, kann die Komponente auf allen Systemen installiert werden (tragbare Implementierung). Diese Information wird von der Installations- und Aktualisierungsunterstützung als ein Hinweis verwendet (Benutzer können die Installation eines Features ungeachtet dieser Einstellung erzwingen).
- arch - Optionale Spezifikation der Systemarchitektur. Eine durch Kommas getrennte Aufstellung von Architektur-Laufwerkskennzeichungen, die von Eclipse definiert werden (siehe Javadoc für
org.eclipse.core.runtime.Platform).
Weist darauf hin, dass diese Komponente nur auf einem der angegebenen Systeme installiert werden sollte. Wenn dieses Attribut nicht angegeben wird, kann die Komponente auf allen Systemen installiert werden (tragbare Implementierung). Diese Information wird von der Installations- und Aktualisierungsunterstützung als ein Hinweis verwendet (Benutzer können die Installation eines Features ungeachtet dieser Einstellung erzwingen).
- ws - Optionale Angabe des Fenstertechniksystems. Eine durch Kommas getrennte Aufstellung von Fenstersystem-Laufwerkskennzeichungen, die von Eclipse definiert werden (siehe Javadoc für
org.eclipse.core.runtime.Platform).
Weist darauf hin, dass diese Komponente nur auf einem der angegebenen Fenstersysteme installiert werden sollte. Wenn dieses Attribut nicht angegeben wird, kann die Komponente auf allen Systemen installiert werden (tragbare Implementierung). Diese Information wird von der Installations- und Aktualisierungsunterstützung als ein Hinweis verwendet (Benutzer können die Installation eines Features ungeachtet dieser Einstellung erzwingen).
- nl - Optionale Angabe der Ländereinstellung. Eine durch Komma getrennte, von Java definierte Liste von Localedesignatoren. Weist darauf hin, dass diese Komponente nur auf einem System, das mit einer kompatiblen Locale läuft, installiert werden sollte. Wenn dieses Attribut nicht angegeben wird, kann die Komponente auf allen Systemen installiert werden (sprachunabhängige Implementierung). Diese Information wird von der Installations- und Aktualisierungsunterstützung als ein Hinweis verwendet (Benutzer können die Installation eines Features ungeachtet dieser Einstellung erzwingen).
- colocation-affinity - Optionaler Verweis auf eine andere Komponentenkennung, um den standardmäßigen Installationsort für diese Komponente auszuwählen. Wenn dieses Feature als ein neues Feature installiert wird (und keine anderen Versionen von ihm installiert sind), wird versucht, dieses Feature an derselben Installationsposition zu installieren wie das Feature, auf das verwiesen wird.
- primary - Optionale Angabe, ob diese Komponente als primäre Komponente verwendet werden kann. Der Standardwert ist false
(keine primäre Komponente).
- application - Optionale Angabe der Eclipse-Applikation zur Verwendung beim Systemstart, wenn die deklarierende Komponente die primäre Komponente ist. Die Applikationskennung muss eine gültige Applikation repräsentieren, die im Erweiterungspunkt org.eclipse.core.runtime.applications registriert ist. Der Standard ist org.eclipse.ui.ide.workbench.
- plugin - Optionale Kennung, die die ID des in dem Feature aufgeführten Plug-ins darstellt, die für die Übertragung der Brandinginformationen für das Feature verwendet wird (Images, Übersetzungen, Eingangsanzeigen bei einem Hauptfeature, etc.). Wenn keine Angabe vorhanden ist, wird davon ausgegangen, dass das Zuordnungs-Plug-in dieselbe ID wie das Feature hat.
- exclusive - Optionale Markierung, wenn "true", weist darauf hin, dass das Feature nicht mit anderen Features in einer Gruppe installiert werden kann.
- <install-handler>
- library - Optionale .jar-Bibliothek mit den Klassen der Installationssteuerroutinen.
Falls eine Angabe vorhanden ist, muss die .jar, auf die verwiesen wird, in dem Featurearchiv enthalten sein.
Sie wird als Pfad innerhalb des Komponentenarchivs in Bezug auf den feature.xml-Eintrag angegeben. Wenn nicht angegeben, wird das Komponentenarchiv selbst zum Laden der Klassen der Installationssteuerroutinen verwendet. Dieses Attribut wird nur interpretiert, wenn auch das Klassen-Attribut angegeben ist.
- handler - Optionale Kennung der Installationssteuerroutine. Der Wert wird abhängig vom Wert des Attributs library interpretiert. Wenn library angegeben ist, wird der Wert als vollständig qualifizierter Name einer Klasse interpretiert, die in der angegebenen library enthalten ist. Wenn library nicht angegeben ist, wird der Wert als Erweiterungskennung einer Erweiterung interpretiert, die beim Erweiterungspunkt org.eclipse.update.installHandlers registriert ist. In beiden Fällen muss die resultierende Klasse die Schnittstelle IInstallHandler implementieren. Die Klasse wird während der Komponentenverarbeitung dynamisch geladen und bei bestimmten Punkten aufgerufen. Wenn die Steuerroutine als eine Klasse angegeben ist, verfügt sie über Sichtbarkeit in den API-Klassen aus dem Plug-in org.eclipse.update.core und den Eclipse-Plug-ins, die von diesem Plug-in benötigt werden; anderenfalls, wenn sie als Erweiterung angegeben ist, hat sie als die das Plug-in definierende Erweiterung Zugriff auf alle Klassen.
- <description> - Kurzbeschreibung der Komponente als einfacher Text. Sollte übersetzt werden.
- url - Optionale URL für die vollständige Beschreibung als HTML. Die URL kann absolut oder relativ angegeben werden. Bei einer relativen Angabe wird davon ausgegangen, dass sie relativ zum Komponentenarchiv ist (und darin verpackt ist). Beachten Sie, dass für die NL-Bearbeitung der URL-Wert getrennt sein muss, um die Angabe alternativer URLs für jede Landessprache zu ermöglichen.
- <copyright> - Copyright der Komponente als einfacher Text. Sollte übersetzt werden.
- url - Optionale URL für die vollständige Beschreibung als HTML. Die URL kann absolut oder relativ angegeben werden. Bei einer relativen Angabe wird davon ausgegangen, dass sie relativ zum Komponentenarchiv ist (und darin verpackt ist). Beachten Sie, dass für die NL-Bearbeitung der URL-Wert getrennt sein muss, um die Angabe alternativer URLs für jede Landessprache zu ermöglichen.
- <license> - "Durchklick"-Lizenz der Komponente als einfacher Text. Sollte übersetzt werden. Wird während des Downloads bzw. der Installation in einem Standarddialog mit den Aktionen [Akzeptieren] [Zurückweisen] angezeigt. Beachten Sie, dass die Durchklick-Lizenz für jede Komponente angegeben werden muss, die zur Installation oder zum Update mit Hilfe des Eclipse Update Manager ausgewählt wird. Bei der Verwendung von verschachtelten Features muss nur das übergeordnete Verschachtelungselement (d. h. das für die Installation oder das Update ausgewählte Feature) über einen definierten "Durchklick"-Lizenztext verfügen. Der Lizenztext ist erforderlich, selbst wenn das optionale URL-Attribut angegeben ist.
- url - Optionale URL für die vollständige Beschreibung als HTML. Die URL kann absolut oder relativ angegeben werden. Bei einer relativen Angabe wird davon ausgegangen, dass sie relativ zum Komponentenarchiv ist (und darin verpackt ist). Beachten Sie, dass der URL-Wert für die Verarbeitung der Landessprachen getrennt sein sollte, so dass unterschiedliche URLs für die einzelnen Landessprachen angegeben werden können. Beachten Sie, dass der "Inhalt" dieser URL nicht das ist, was während der Installation als Durchklick-Lizenz angezeigt wird. Die Durchklick-Lizenz ist der tatsächliche Wert des Elements <Lizenz> (z.B. <Lizenz>Durchklick-Text</Lizenz>)
- <url> - Optionale URL, die die Site(s) angibt, die Featureaktualisierungen oder neue Features enthält/enthalten
- <update> - URL für Updates dieser Komponente.
- url: Tatsächliche URL.
- label: Anzeigbare Bezeichnung (Name) für die verwiesene Site.
- <discovery> - URL für neue Komponenten. Ein
Provider kann mit diesem Element generell auf seine eigene(n) Site(s)
oder die Site(s) von Partnern verweisen, die ergänzende Komponenten anbieten. Eclipse verwendet diese Element einfach zur Verteilung neuer
Site-URLs an die Clients. Sites, die zu Stammkomponenten gehören (also Komponenten, die in der höchsten Ebene der Hierarchie angesiedelt sind) werden im Update-Manager normalerweise unter "Interessante Sites" angezeigt.
- url: Tatsächliche URL.
- label: Anzeigbare Bezeichnung (Name) für die verwiesene Site.
- type (neu in 2.1) - In der Standardeinstellung gelten Erkennungssites als Update-Site
("update"). Wenn Sie den Wert dieses Attributs mit "web" festlegen, können Sie auf diese Weise für Eclipse angeben, dass die URL als regulärer Hyperlink im Internet behandelt werden soll, der in einem geeigneten Browser direkt aufgerufen werden kann.
- <includes> - Optionaler Verweis auf eine verschachtelte Komponente, die als Teil dieser Komponente betrachtet wird. Verschachtelte Features müssen sich auf derselben Update-Site wie dieses Feature befinden.
- id - Erforderliche Kennung für verschachtelte Features. Falls dieses Feature ein Patch-Code ist (siehe den nachstehenden Abschnitt <requires>), muss es sich hierbei um die ID eines anderen Patch-Codes handeln.
- version - Erforderliche Version der verschachtelten Komponente.
- optional - Ein Feature kann als optional hinzugefügt werden, wenn dieses Attribut "true" ist. Benutzer dürfen optionale Komponenten weder installieren noch deinstallieren und später erneut installieren. Eine fehlende optionale Komponente wird nicht als Fehler behandelt.
- name - Falls ein optionales Feature fehlt, kann Eclipse seinen Namen nicht ordnungsgemäß übergeben. Dieses Attribut kann als Platzhalter verwendet werden, damit Eclipse den Namen der optionalen Komponente wiedergeben kann, wenn diese nicht installiert ist.
- search-location - Ein integriertes Feature kann durch Patch-Codes aktualisiert werden.
In der Standardeinstellung lautet die Suchposition "root". Dies bedeutet,
dass die im Element "update" des Elements "url" für das übergeordnete Element angegebene Komponente berücksichtigt wird. Falls für eine enthaltene Komponente ein eigenes Element "update" definiert ist, wird sie standardmäßig ignoriert.
Sofern die übergeordnete Komponente die Aktualisierung der ihr untergeordneten Komponenten aus ihre eigenen Position heraus zulassen soll, kann
dieses Attribut auf "both" oder "self" gesetzt werden.
- os - Optionale Spezifikation des Betriebssystems. Eine durch Kommas getrennte Aufstellung von Betriebssystem-Laufwerkskennzeichungen, die von Eclipse definiert werden (siehe Javadoc für
org.eclipse.core.runtime.Platform).
Weist darauf hin, dass dieser Eintrag nur auf einem der angegebenen Betriebssysteme installiert werden sollte. Wenn dieses Attribut nicht angegeben wird, kann dieser Eintrag auf allen Systemen installiert werden (tragbare Implementierung). Diese Information wird von der Installations- und Aktualisierungsunterstützung als ein Hinweis verwendet (Benutzer können die Installation eines Eintrags ungeachtet dieser Einstellung erzwingen).
- arch - Optionale Spezifikation der Systemarchitektur. Eine durch Kommas getrennte Aufstellung von Architektur-Laufwerkskennzeichungen, die von Eclipse definiert werden (siehe Javadoc für
org.eclipse.core.runtime.Platform).
Weist darauf hin, dass diese Komponente nur auf einem der angegebenen Systeme installiert werden sollte. Wenn dieses Attribut nicht angegeben wird, kann die Komponente auf allen Systemen installiert werden (tragbare Implementierung). Diese Information wird von der Installations- und Aktualisierungsunterstützung als ein Hinweis verwendet (Benutzer können die Installation eines Features ungeachtet dieser Einstellung erzwingen).
- ws - Optionale Angabe des Fenstertechniksystems. Eine durch Kommas getrennte Aufstellung von Fenstersystem-Laufwerkskennzeichungen, die von Eclipse definiert werden (siehe Javadoc für
org.eclipse.core.runtime.Platform).
Weist darauf hin, dass dieser Eintrag nur auf einem der angegebenen Fenstersysteme installiert werden sollte.
Wenn dieses Attribut nicht angegeben wird, kann dieser Eintrag auf allen Systemen installiert werden (tragbare Implementierung). Diese Information wird von der Installations- und Aktualisierungsunterstützung als ein Hinweis verwendet (Benutzer können die Installation eines Eintrags ungeachtet dieser Einstellung erzwingen).
- nl - Optionale Angabe der Ländereinstellung. Eine durch Komma getrennte, von Java definierte Liste von Localedesignatoren. Weist darauf hin, dass dieser Eintrag nur auf einem System, das mit einer kompatiblen Locale läuft, installiert werden sollte. Wenn dieses Attribut nicht angegeben wird, kann dieser Eintrag auf allen Systemen installiert werden (sprachunabhängige Implementierung). Diese Information wird von der Installations- und Aktualisierungsunterstützung als ein Hinweis verwendet (Benutzer können die Installation eines Eintrags ungeachtet dieser Einstellung erzwingen).
- <requires> - Optionale Information über Komponentenabhängigkeit. Wird in Form von Plug-in-Abhängigkeiten ausgedrückt. Falls angegeben, wird dies durch die Installations- und Aktualisierungsunterstützung zum Zeitpunkt der Installation erzwungen.
- <import> - Abhängigkeitseintrag. Spezifikation und Verarbeitung ist eine Untergruppe der <Import>-Spezifikation in plugin.xml
- plugin - Die Kennung eines abhängigen Plug-ins, wenn die Abhängigkeit unter Verwendung von "plug-in" ausgedrückt wird.
- feature (neu in 2.1) - Die Kennung der abhängigen Komponente, wenn die Abhängigkeit unter Verwendung von "feature" ausgedrückt wird. Entweder das Attribut "plugin" oder das Attribut "feature" muss definiert sein. Beide Attribute dürfen nicht gleichzeitig verwendet werden. Falls das Attribut "patch" auf "true" gesetzt ist, muss das Attribut "feature" verwendet werden.
- version - Optionale Spezifikation der Plug-in-Version. Falls das Attribut "patch" auf "true" gesetzt ist, muss das Attribut "version" verwendet werden.
- match - Optionale Regel für die Übereinstimmung. Die folgenden Werte und Verarbeitungen sind gültig:
- Falls das Versionsattribut nicht angegeben ist, wird das Übereinstimmungsattribut (falls angegeben) ignoriert.
- perfect - Abhängige Plug-in-Version muss mit der angegebenen Version exakt übereinstimmen. Falls das Attribut "patch" auf "true" gesetzt ist, wird "perfect" angenommen, und andere Werte können nicht definiert werden.
- equivalent - Abhängige Plug-in-Version muss mindestens der angegebenen Version oder einem höheren Service Level entsprechen (höhere und tiefere Versionsstufen müssen der angegebenen Version entsprechen).
- compatible - Die abhängige Plug-in-Version muss mindestens die angegebene Version oder auf einer höheren Serviceebene eine untergeordnete Version sein (die übergeordnete Version muss der angegebenen Version entsprechen).
- compatible - Die abhängige Plug-in-Version muss mindestens die angegebene Version oder auf einer höheren Serviceebene eine untergeordnete oder übergeordnete Version sein.
- patch - falls "true", Diese Integritätsbedingung deklariert das einschließende Feature als einen Patch-Code für das Feature, auf das verwiesen wird. Beim Festlegen dieses Attributs müssen bestimmte Regeln beachtet werden:
- Das Featureattribut muss für die Kennung des Features, für das der Patch-Code bereitgestellt wird, verwendet werden.
- Das Attribut "version" muss definiert sein.
- Das Attribut "match" sollte nicht festgelegt werden, der Wert "perfect" wird angenommen.
- Wenn die anderen Features <include>'ed sind, muss es sich ebenfalls um Patch-Codes handeln.
Ein Patch-Code ist ein spezielles Feature, das neuere Versionen von Plug-ins für das Feature, für das der Patch-Code bereitgestellt wird, überträgt. Er ersetzt nicht das Feature. Ein Patch-Code kann durch Einschluss auch andere Patch-Codes übertragen.
- <plugin> - Kennzeichnet Plug-ins, auf die verwiesen wird.
- id - Erforderliche Plug-in-Kennung (aus plugin.xml)
- version - Erforderliche Plug-in-Version (aus plugin.xml)
- fragment - Optionale Spezifikation, ob dieser Eintag ein Plug-in-Fragment ist. Der Standardwert ist "false".
- os - Optionale Spezifikation des Betriebssystems. Eine durch Kommas getrennte Aufstellung von Betriebssystem-Laufwerkskennzeichungen, die von Eclipse definiert werden (siehe Javadoc für
org.eclipse.core.runtime.Platform).
Weist darauf hin, dass dieser Eintrag nur auf einem der angegebenen Betriebssysteme installiert werden sollte. Wenn dieses Attribut nicht angegeben wird, kann dieser Eintrag auf allen Systemen installiert werden (tragbare Implementierung). Diese Information wird von der Installations- und Aktualisierungsunterstützung als ein Hinweis verwendet (Benutzer können die Installation eines Eintrags ungeachtet dieser Einstellung erzwingen).
- arch - Optionale Spezifikation der Systemarchitektur. Eine durch Kommas getrennte Aufstellung von Architektur-Laufwerkskennzeichungen, die von Eclipse definiert werden (siehe Javadoc für
org.eclipse.core.runtime.Platform).
Weist darauf hin, dass diese Komponente nur auf einem der angegebenen Systeme installiert werden sollte. Wenn dieses Attribut nicht angegeben wird, kann die Komponente auf allen Systemen installiert werden (tragbare Implementierung). Diese Information wird von der Installations- und Aktualisierungsunterstützung als ein Hinweis verwendet (Benutzer können die Installation eines Features ungeachtet dieser Einstellung erzwingen).
- ws - Optionale Angabe des Fenstertechniksystems. Eine durch Kommas getrennte Aufstellung von Fenstersystem-Laufwerkskennzeichungen, die von Eclipse definiert werden (siehe Javadoc für
org.eclipse.core.runtime.Platform).
Weist darauf hin, dass dieser Eintrag nur auf einem der angegebenen Fenstersysteme installiert werden sollte.
Wenn dieses Attribut nicht angegeben wird, kann dieser Eintrag auf allen Systemen installiert werden (tragbare Implementierung). Diese Information wird von der Installations- und Aktualisierungsunterstützung als ein Hinweis verwendet (Benutzer können die Installation eines Eintrags ungeachtet dieser Einstellung erzwingen).
- nl - Optionale Angabe der Ländereinstellung. Eine durch Komma getrennte, von Java definierte Liste von Localedesignatoren. Weist darauf hin, dass dieser Eintrag nur auf einem System, das mit einer kompatiblen Locale läuft, installiert werden sollte. Wenn dieses Attribut nicht angegeben wird, kann dieser Eintrag auf allen Systemen installiert werden (sprachunabhängige Implementierung). Diese Information wird von der Installations- und Aktualisierungsunterstützung als ein Hinweis verwendet (Benutzer können die Installation eines Eintrags ungeachtet dieser Einstellung erzwingen).
- download-size - Optionaler Hinweis, der von dem Featurepackprogramm bereitgestellt wird und die Downloadgröße des Plug-in-Archivs, auf das verwiesen wird, in Kbyte angibt. Falls keine Angabe vorhanden ist, ist die Downloadgröße nicht bekannt (Hinweis für die Implementierung: Bei der Implementierung muss zwischen "nicht bekannt" und 0 unterschieden werden.)
- install-size - Optionaler Hinweis, der von dem Featurepackprogramm bereitgestellt wird und die Installationsgröße des Plug-in-Archivs, auf das verwiesen wird, in Kbyte angibt. Falls keine Angabe vorhanden ist, ist die Installationsgröße nicht bekannt (Hinweis für die Implementierung: Bei der Implementierung muss zwischen "nicht bekannt" und 0 unterschieden werden.)
- unpack (neu in 3.0) - Optionale Spezifikation, die vom Featurepackprogramm bereitgestellt wird und angibt, dass das Plug-in von einer jar-Datei ausgeführt werden kann und die Inhalte der jar-Datei des Plug-ins nicht in ein Verzeichnis entpackt werden sollten. Der Standardwert ist "true".
(Hinweis für die Implementierung: Bei partiellen Plug-ins, die in einem Feature, das org.eclipse.update.core.DeltaInstallHandler als eine Installationssteuerroutine angibt, bereitgestellt werden, sollte das Entpacken nicht auf "false" eingestellt sein.)
- <data> - Identifiziert Nicht-Plug-in-Daten, die Teil des Features bilden.
- id - Erforderliche Datenkennung in Form eines relativen Pfads.
- os - Optionale Spezifikation des Betriebssystems. Eine durch Kommas getrennte Aufstellung von Betriebssystem-Laufwerkskennzeichungen, die von Eclipse definiert werden (siehe Javadoc für
org.eclipse.core.runtime.Platform).
Weist darauf hin, dass dieser Eintrag nur auf einem der angegebenen Betriebssysteme installiert werden sollte.
Wenn dieses Attribut nicht angegeben wird, kann dieser Eintrag auf allen Systemen installiert werden (tragbare Implementierung). Diese Information wird von der Installations- und Aktualisierungsunterstützung als ein Hinweis verwendet (Benutzer können die Installation eines Eintrags ungeachtet dieser Einstellung erzwingen).
- arch - Optionale Spezifikation der Systemarchitektur. Eine durch Kommas getrennte Aufstellung von Architektur-Laufwerkskennzeichungen, die von Eclipse definiert werden (siehe Javadoc für
org.eclipse.core.runtime.Platform).
Weist darauf hin, dass diese Komponente nur auf einem der angegebenen Systeme installiert werden sollte. Wenn dieses Attribut nicht angegeben wird, kann die Komponente auf allen Systemen installiert werden (tragbare Implementierung). Diese Information wird von der Installations- und Aktualisierungsunterstützung als ein Hinweis verwendet (Benutzer können die Installation eines Features ungeachtet dieser Einstellung erzwingen).
- ws - Optionale Angabe des Fenstertechniksystems. Eine durch Kommas getrennte Aufstellung von Fenstersystem-Laufwerkskennzeichungen, die von Eclipse definiert werden (siehe Javadoc für
org.eclipse.core.runtime.Platform).
Weist darauf hin, dass diese Eintrag nur auf einem der angegebenen Fenstersysteme installiert werden sollte. Wenn dieses Attribut nicht angegeben wird, kann dieser Eintrag auf allen Systemen installiert werden (tragbare Implementierung). Diese Information wird von der Installations- und Aktualisierungsunterstützung als ein Hinweis verwendet (Benutzer können die Installation eines Eintrags ungeachtet dieser Einstellung erzwingen).
- nl - Optionale Angabe der Ländereinstellung. Eine durch Komma getrennte, von Java definierte Liste von Localedesignatoren. Weist darauf hin, dass dieser Eintrag nur auf einem System, das mit einer kompatiblen Locale läuft, installiert werden sollte. Wenn dieses Attribut nicht angegeben wird, kann dieser Eintrag auf allen Systemen installiert werden (sprachunabhängige Implementierung). Diese Information wird von der Installations- und Aktualisierungsunterstützung als ein Hinweis verwendet (Benutzer können die Installation eines Eintrags ungeachtet dieser Einstellung erzwingen).
- download-size - Optionaler Hinweis, der von dem Featurepackprogramm bereitgestellt wird und die Downloadgröße des Datenarchivs, auf das verwiesen wird, in Kbyte angibt. Falls keine Angabe vorhanden ist, ist die Downloadgröße nicht bekannt (Hinweis für die Implementierung: Bei der Implementierung muss zwischen "nicht bekannt" und 0 unterschieden werden.)
- install-size - Optionaler Hinweis, der von dem Featurepackprogramm bereitgestellt wird und die Installationsgröße des Datenarchivs, auf das verwiesen wird, in Kbyte angibt. Falls keine Angabe vorhanden ist, ist die Installationsgröße nicht bekannt (Hinweis für die Implementierung: Bei der Implementierung muss zwischen "nicht bekannt" und 0 unterschieden werden.)
Bei der Interaktion mit der Update-Site ordnet die Featureimplementierung die Elemente <Plug-in>
und <Daten> den Pfadkennungen zu, die von der Site verwendet werden, um die tatsächlich herunterzuladenden und zu installierenden Dateien zu ermitteln. Die Standardkomponentenimplementierung durch Eclipse setzt die Pfadkennungen wie folgt zusammen:
-
<Plugin>-Element führt zu Pfadeintrag in Form von plugins/<pluginId>_<pluginVersion>.jar"
(z.B. "plugins/org.eclipse.core.boot_2.0.0.jar")
-
<Daten>-Element führt zu Pfadeintrag in Form von features/<featureId>_<featureVersion>/<dataId>"
(z.B. "features/com.xyz.tools_1.0.3/examples.zip")
Beachten Sie, dass feature.xml -Manifestdokumente im allgemeinen UTF-8-Codierung angeben sollten. Hier ein Beispiel:
<?xml version="1.0" encoding="UTF-8"?>
Übersetzbarer Text, der in der Datei feature.xml enthalten ist, kann mithilfe von Java-Merkmalsproduktpaketkonventionen für in feature<_locale>.properties-Dateien getrennt werden.
Beachten Sie, dass bei der Installation die übersetzten Zeichenfolgen verwendet werden (d. h. nicht den Laufzeitmechanismus für Plug-in-Fragmente verwenden).