Manifeste des fonctions de la plate-forme Eclipse
Version 3.0 - Dernière révision : 22 juin 2004
Le format du manifeste des fonctions est défini par la DTD
suivante :
<?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
>
Les définitions d'élément et d'attribut sont les suivantes :
- <feature> - définit la fonction
- id : identificateur de fonction requis (par exemple,
com.xyz.myfeature)
- version : version de composant requise (par exemple, 1.0.3)
- label : libellé (nom) affichable et facultatif. A traduire.
- provider-name : libellé d'affichage facultatif, identifiant
l'organisation fournissant ce composant. A traduire.
- image : image facultative à utiliser lors de l'affichage des
informations sur la fonction.
Spécifiée par rapport à feature.xml.
- os : spécification facultative du système d'exploitation. Liste de désignateurs de systèmes d'exploitation, séparés par une virgule, définie par Eclipse (reportez-vous au Javadoc pour org.eclipse.core.runtime.Platform).
Indique que cette fonction ne doit être installée que sur l'un des systèmes d'exploitation indiqués. Si cet attribut n'est pas précisé, la fonction peut être
installée sur tous les systèmes (implémentation portable). Ces informations fournissent des
recommandations utiles au support d'installation et de mise à jour
(l'utilisateur peut forcer l'installation
d'une fonction quelle que soit la valeur de ce paramètre).
- arch : spécification facultative de
l'architecture de la machine. Liste de désignateurs d'architecture,
séparés par une virgule, définie par Eclipse (reportez-vous au
Javadoc pour org.eclipse.core.runtime.Platform).
Indique que cette fonction ne doit être installée que sur l'un des
systèmes spécifiés. Si cet attribut n'est pas précisé, la fonction peut être
installée sur tous les systèmes (implémentation portable). Ces informations fournissent des
recommandations utiles au support d'installation et de mise à jour
(l'utilisateur peut forcer l'installation
d'une fonction quelle que soit la valeur de ce paramètre).
- ws : spécification facultative du système de fenêtrage. Liste de désignateurs de systèmes d'exploitation Windows, séparés par une virgule, définie par Eclipse (reportez-vous au Javadoc pour org.eclipse.core.runtime.Platform).
Indique que cette fonction ne doit être installée que sur l'un des systèmes d'exploitation Windows indiqués. Si cet attribut n'est pas précisé, la fonction peut être
installée sur tous les systèmes (implémentation portable). Ces informations fournissent des
recommandations utiles au support d'installation et de mise à jour
(l'utilisateur peut forcer l'installation
d'une fonction quelle que soit la valeur de ce paramètre).
- nl : spécification facultative des paramètres régionaux. Liste
de désignateurs de paramètre régional, séparés par des
virgules, définie par Java. Indique que cette fonction ne doit être installée
que sur un système dont les paramètres régionaux sont compatibles
(à l'aide des règles Java pour la correspondance des paramètres
régionaux). Si cet attribut n'est pas précisé, la fonction peut être
installée sur tous les systèmes (implémentation
indépendante de la langue choisie). Ces informations fournissent des
recommandations utiles au support d'installation et de mise à jour
(l'utilisateur peut forcer l'installation
d'une fonction quelle que soit la valeur de ce paramètre).
- colocation-affinity : Référence facultative à un autre
identificateur de fonction utilisée permettant de sélectionner le
répertoire d'installation par défaut de cette fonction. Si cette
fonction est installée comme nouvelle fonction (aucune autre version
de cette fonction n'est installée), le système tente de l'installer
dans le même répertoire d'installation que la
fonction référencée.
- primary : indication facultative spécifiant si cette fonction
peut être utilisée comme fonction principale. Valeur par défaut : false
(fonction non principale).
- application : identificateur facultatif de l'application Eclipse
à utiliser au démarrage si la fonction de déclaration correspond à
la fonction principale. L'identificateur d'application doit
représenter une application valide enregistrée
dans le point d'extension org.eclipse.core.runtime.applications. La valeur par défaut est org.eclipse.ui.ide.workbench.
- plugin : identificateur facultatif qui représente l'ID du plug-in
répertorié dans le dispositif utilisé pour acheminer des informations de fabricant pour le dispositif (images, conversions, écrans d'accueil dans le cas d'un dispositif principal, etc). S'il n'est pas spécifié, l'hypothèse est que le plug-in d'attribution a le même ID que le dispositif.
- exclusive : indicateur facultatif qui, s'il a la valeur "true", indique que le dispositif ne peut pas être installé dans un groupe avec d'autres dispositifs.
- <install-handler>
- library : bibliothèque .jar facultative contenant les
classes du gestionnaire d'installation.
S'il est spécifié, le fichier .jar référencé doit se trouver dans
l'archive des fonctions.
Il est spécifié comme chemin, dans l'archive des fonctions,
par rapport à l'entrée feature.xml. S'il n'est pas spécifié,
l'archive de fonctions est utilisée pour charger les classes
du gestionnaire d'installation. Cet attribut n'est interprété que si
l'attribut class est également spécifié
- handler : identificateur facultatif du gestionnaire
d'installation. La valeur est interprétée en fonction de la valeur de
l'attribut library. Si l'attribut library
est spécifié, elle est interprétée comme nom complet d'une classe de
la bibliothèque spécifiée. Si library
n'est pas spécifié, la valeur est interprétée comme identificateur de
l'extension enregistrée dans le point d'extension org.eclipse.update.installHandlers. Dans
tous les cas, la classe résultante doit implémenter l'interface IInstallHandler. La
classe est chargée et appelée dynamiquement à des points
spécifiques lors du traitement des fonctions. Lorsque le gestionnaire est spécifié comme classe, il peut voir les classes de l'API provenant du plug-in org.eclipse.update.core et les plug-ins Eclipse requis par ce plug-in ; lorsqu'il est spécifié en tant qu'extension, il a accès à toutes les classes auxquelles a accès le plug-in définissant l'extension.
- <description> - brève description du composant, sous forme de texte simple. A
traduire.
- url : URL facultative de la description intégrale, sous forme
de fichier HTML. L'URL peut être absolue ou relative. Si elle est relative, elle l'est par
rapport à l'archive des fonctions (dans laquelle elle est mise en forme). Pour le traitement des versions localisées, la valeur de l'URL
doit être séparée afin d'autoriser la spécification d'une autre URL
pour chaque langue.
- <copyright> - droits d'auteur de la fonction, sous forme de texte simple. A
traduire.
- url : URL facultative de la description intégrale, sous forme
de fichier HTML. L'URL peut être absolue ou relative. Si elle est relative, elle l'est par
rapport à l'archive des fonctions (dans laquelle elle est mise en forme). Pour le traitement des versions localisées, la valeur de l'URL
doit être séparée afin d'autoriser la spécification d'une autre URL
pour chaque langue.
- <license> - licence "click-through" de la fonction, sous forme de texte simple. A
traduire. Affichée dans une boîte de dialogue standard avec des
actions [Accept] [Reject] lors du processus de
téléchargement/d'installation. La licence "click-through" doit
être spécifiée pour toute fonction à installer ou mettre à jour
à l'aide du gestionnaire de mise à jour Eclipse. Lors de
l'utilisation de fonctions imbriquées, le texte de la licence
click-through ne doit être défini que sur le parent
imbriquant (fonction sélectionnée pour l'installation ou la mise à
jour). Le texte de la licence
est requis même si l'attribut facultatif url est
spécifié.
- url : URL facultative de la description intégrale, sous forme
de fichier HTML. L'URL peut être absolue ou relative. Si elle est relative, elle l'est par
rapport à l'archive des fonctions (dans laquelle elle est mise en forme). Pour le traitement des versions localisées, la valeur de l'URL doit
être séparée afin d'autoriser la spécification d'une autre URL pour
chaque langue. Le "contenu" de cette URL ne correspond
pas à ce qui est présenté comme licence "click-through"
lors du processus d'installation. La licence "click-through"
représente la véritable valeur de l'élément <license> (par
exemple, <license>click through text</license>)
- <url> - URL facultative indiquant des sites contenant des mises à jour de la fonction ou de nouvelles fonctions
- <update> - URL à consulter pour obtenir les mises à jour de cette fonction
- url : URL réelle
- label : libellé affichable (nom) du site référencé
- <discovery> - URL à consulter pour obtenir de nouvelles fonctions. En règle générale, un fournisseur
peut utiliser cet élément pour faire référence à son ou ses propres
sites, ou à ceux de partenaires qui offrent des fonctions complémentaires. Eclipse utilise simplement cet élément comme moyen de distribution des nouvelles URL du site aux clients. Les sites qui appartiennent aux dispositifs racine (situé en haut de la hiérarchie) figurent généralement dans le dossier "Sites à visiter" du gestionnaire des mises à jour.
- url : URL réelle
- label : libellé affichable (nom) du site référencé
- type (nouveau dans 2.1) : par défaut, les sites de recherches sont supposés être des sites de mise à jour ("update"). En affectant à cet attribut la valeur "web",
il est possible d'indiquer à Eclipse que l'URL doit être traitée comme un lien hypertexte Web ordinaire pouvant s'afficher directement dans un navigateur approprié.
- <includes> - référence facultative à une fonction imbriquée considéré comme faisant partie de cette fonction. Les fonctions
imbriquées doivent se trouver dans le même site de mise à jour que
cette fonction
- id : identificateur de fonction imbriquée requis. Si la fonction est un correctif (voir la section
<requires> ci-après), il s'agit de l'ID d'un autre correctif.
- version : version de fonction imbriquée requise
- optional - il est possible d'inclure une fonction facultative lorsque cet attribut a la valeur "true". Les utilisateurs sont autorisés à ne pas installer de dispositifs en option ; désactivez-les s'ils sont installés et installez-les plus tard. Un dispositif en option manquant n'est pas considéré comme une erreur.
- name - si une fonction facultative est manquante, Eclipse ne peut pas afficher correctement son nom. Cet attribut peut être utilisé comme 'marque de réservation' pour autoriser Eclipse
à afficher le nom du dispositif en option lorsque celui-ci n'est pas installé.
- search-location - une fonction incluse peut être mise à jour à l'aide de correctifs.
Par défaut, la valeur de search location est
"root", ce qui signifie que l'URL spécifiée dans l'élément "update" à l'intérieur de l'élément
"url" du parent sera prise en considération. Si un dispositif inclus
a son propre élément "update" défini, il sera ignoré par défaut.
Si le dispositif parent souhaite autoriser la mise à jour de l'enfant à partir de son propre emplacement, il peut affecter
à cet attribut la valeur "both" ou "self".
- os : spécification facultative du système d'exploitation. Liste de désignateurs de systèmes d'exploitation, séparés par une virgule, définie par Eclipse (reportez-vous au Javadoc pour org.eclipse.core.runtime.Platform).
Indique que cette fonction ne doit être installée que sur l'un des systèmes d'exploitation indiqués. Si cet attribut n'est pas précisé, l'entrée peut être
installée sur tous les systèmes (implémentation portable). Ces
informations fournissent des recommandations utiles au support
d'installation et de mise à jour (l'utilisateur peut forcer
l'installation d'une entrée quelle que soit la valeur de ce paramètre).
- arch : spécification facultative de
l'architecture de la machine. Liste de désignateurs d'architecture,
séparés par une virgule, définie par Eclipse (reportez-vous au
Javadoc pour org.eclipse.core.runtime.Platform).
Indique que cette fonction ne doit être installée que sur l'un des
systèmes spécifiés. Si cet attribut n'est pas précisé, la fonction peut être
installée sur tous les systèmes (implémentation portable). Ces informations fournissent des
recommandations utiles au support d'installation et de mise à jour
(l'utilisateur peut forcer l'installation
d'une fonction quelle que soit la valeur de ce paramètre).
- ws : spécification facultative du système de fenêtrage. Liste de désignateurs de systèmes d'exploitation Windows, séparés par une virgule, définie par Eclipse (reportez-vous au Javadoc pour org.eclipse.core.runtime.Platform).
Indique que cette fonction ne doit être installée que sur l'un des systèmes d'exploitation Windows indiqués.
Si cet attribut n'est pas précisé, l'entrée peut être
installée sur tous les systèmes (implémentation portable). Ces
informations fournissent des recommandations utiles au support
d'installation et de mise à jour (l'utilisateur peut forcer
l'installation d'une entrée quelle que soit la valeur de ce paramètre).
- nl : spécification facultative des paramètres régionaux. Liste
de désignateurs de paramètre régional, séparés par des
virgules, définie par Java. Indique que cette entrée ne doit être
installée que sur un système dont les paramètres régionaux sont
compatibles (à l'aide
des règles Java pour la correspondance des paramètres régionaux). Si cet attribut n'est pas précisé, l'entrée peut être installée sur tous
les systèmes (implémentation indépendante de la langue choisie). Ces
informations fournissent des recommandations utiles au support
d'installation et de mise à jour (l'utilisateur peut forcer
l'installation d'une entrée quelle que soit la valeur de ce paramètre).
- <requires> - informations facultatives de dépendance de la fonction. Exprimées en termes de dépendances de plug-in. Si
elles sont spécifiées, elles sont appliquées par le support d'installation
et de mise à jour lors de l'installation
- <import> - entrée de dépendance. La spécification et le
traitement sont des sous-ensembles de la spécification <import>
dans plugin.xml
- plugin : identificateur de plug-in dépendant, si plugin est utilisé pour exprimer la dépendance
- feature (nouveau dans 2.1) : identificateur de dispositif dépendant, si feature est utilisé pour exprimer la dépendance. L'attribut plugin ou feature doit être défini, mais pas les deux en même temps. Si "patch" a pour valeur "true", l'attribut feature doit être utilisé.
- version : spécification facultative de la version du plug-in. Si "patch" a pour valeur
"true", version doit être défini.
- match : - règle de correspondance facultative. Le traitement
et les valeurs valides sont les suivants :
- si l'attribut de version n'est pas spécifié, l'attribut de
correspondance (s'il est spécifié) est ignoré.
- perfect : la version de plug-in dépendant
doit correspondre exactement à la version spécifiée. Si "patch" a pour valeur "true",
"perfect" est défini par défaut et aucune autre valeur ne peut être définie.
- equivalent : la version de plug-in dépendant doit
être au moins égale à la version spécifiée ou à un niveau de service
supérieur (les niveaux de version majeurs et mineurs doivent être
égaux à la version spécifiée).
- compatible : la version de plug-in dépendant doit
être au moins égale à la version spécifiée ou à un niveau de service
supérieur ou un niveau mineur (le niveau de version majeur doit
être égal à la version spécifiée).
- greaterOrEqual : la version de plug-in dépendant doit
être au moins égale à la version spécifiée ou à un niveau de service
supérieur, un niveau mineur ou un niveau majeur.
- patch - lorsqu'elle a la valeur "true", cette contrainte indique que la fonction d'inclusion est un correctif de la fonction référencée. Certaines règles doivent être respectées lors de la définition de
cet attribut :
- l'attribut feature doit être utiliser pour identifier la fonction corrigée,
- l'attribut version doit être défini,
- l'attribut match ne doit pas être défini et la valeur "perfect" est utilisée par défaut,
- si d'autres fonctions sont associées à <include>, elles doivent également être corrigées.
Un correctif est une fonction spéciale qui transmet les versions les plus récentes des plug-ins pour le dispositif qui est corrigé. Il ne remplace pas le dispositif. Un correctif peut aussi transmettre d'autres correctifs par inclusion.
- <plugin> - identifie un plug-in référencé
- id : identificateur de plug-in requis (depuis plugin.xml)
- version : version de plug-in requise (depuis plugin.xml)
- fragment : spécification facultative indiquant si cette
entrée correspond à un fragment de plug-in. Valeur par défaut : "false"
- os : spécification facultative du système d'exploitation. Liste de désignateurs de systèmes d'exploitation, séparés par une virgule, définie par Eclipse (reportez-vous au Javadoc pour org.eclipse.core.runtime.Platform).
Indique que cette entrée ne doit être installée que sur l'un des
systèmes d'exploitation spécifiés. Si cet attribut n'est pas précisé, l'entrée peut être
installée sur tous les systèmes (implémentation portable). Ces
informations fournissent des recommandations utiles au support
d'installation et de mise à jour (l'utilisateur peut forcer
l'installation d'une entrée quelle que soit la valeur de ce paramètre).
- arch : spécification facultative de
l'architecture de la machine. Liste de désignateurs d'architecture,
séparés par une virgule, définie par Eclipse (reportez-vous au
Javadoc pour org.eclipse.core.runtime.Platform).
Indique que cette fonction ne doit être installée que sur l'un des
systèmes spécifiés. Si cet attribut n'est pas précisé, la fonction peut être
installée sur tous les systèmes (implémentation portable). Ces informations fournissent des
recommandations utiles au support d'installation et de mise à jour
(l'utilisateur peut forcer l'installation
d'une fonction quelle que soit la valeur de ce paramètre).
- ws : spécification facultative du système de fenêtrage. Liste de désignateurs de systèmes d'exploitation Windows, séparés par une virgule, définie par Eclipse (reportez-vous au Javadoc pour org.eclipse.core.runtime.Platform).
Indique que cette fonction ne doit être installée que sur l'un des systèmes d'exploitation Windows indiqués.
Si cet attribut n'est pas précisé, l'entrée peut être
installée sur tous les systèmes (implémentation portable). Ces
informations fournissent des recommandations utiles au support
d'installation et de mise à jour (l'utilisateur peut forcer
l'installation d'une entrée quelle que soit la valeur de ce paramètre).
- nl : spécification facultative des paramètres régionaux. Liste
de désignateurs de paramètre régional, séparés par des
virgules, définie par Java. Indique que cette entrée ne doit être
installée que sur un système dont les paramètres régionaux sont
compatibles (à l'aide
des règles Java pour la correspondance des paramètres régionaux). Si cet attribut n'est pas précisé, l'entrée peut être installée sur tous
les systèmes (implémentation indépendante de la langue choisie). Ces
informations fournissent des recommandations utiles au support
d'installation et de mise à jour (l'utilisateur peut forcer
l'installation d'une entrée quelle que soit la valeur de ce paramètre).
- download-size : conseil facultatif fourni par l'outil de mise
en forme, indiquant la taille du téléchargement en kilo-octets de
l'archive de plug-in référencée. Si elle n'est pas spécifiée, la
taille du téléchargement est inconnue (Remarque sur
l'implémentation : l'implémentation doit faire la
différence entre une taille "inconnue" et une taille de 0)
- install-size : conseil facultatif fourni par l'outil de mise en
forme, indiquant la taille de l'installation en kilo-octets de
l'archive de plug-in référencée. Si elle n'est pas spécifiée, la
taille de l'installation est inconnue (Remarque sur
l'implémentation : l'implémentation doit faire la
différence entre une taille "inconnue" et une taille de 0)
- unpack (nouveau dans 3.0) - spécification facultative fournie par l'outil de mise en forme des fonctions, qui indique que le plug-in peut être exécuté à partir d'un fichier Jar et que le contenu du fichier Jar d'un plug-in ne doit pas être décompressé dans un répertoire. La valeur par défaut est "true".
(Remarque sur l'implémentation : les plug-ins temporaires livrés dans une fonction spécifiant
org.eclipse.update.core.DeltaInstallHandler comme gestionnaire d'installation ne doivent pas associer la valeur de décompression (unpack) à "false")
- <data> - identifie des données faisant partie de la fonction, autre qu'un plug-in
- id : identificateur de données requis, sous la forme de chemin
relatif.
- os : spécification facultative du système d'exploitation. Liste de désignateurs de systèmes d'exploitation, séparés par une virgule, définie par Eclipse (reportez-vous au Javadoc pour org.eclipse.core.runtime.Platform).
Indique que cette fonction ne doit être installée que sur l'un des systèmes d'exploitation indiqués.
Si cet attribut n'est pas précisé, l'entrée peut être
installée sur tous les systèmes (implémentation portable). Ces
informations fournissent des recommandations utiles au support
d'installation et de mise à jour (l'utilisateur peut forcer
l'installation d'une entrée quelle que soit la valeur de ce paramètre).
- arch : spécification facultative de
l'architecture de la machine. Liste de désignateurs d'architecture,
séparés par une virgule, définie par Eclipse (reportez-vous au
Javadoc pour org.eclipse.core.runtime.Platform).
Indique que cette fonction ne doit être installée que sur l'un des
systèmes spécifiés. Si cet attribut n'est pas précisé, la fonction peut être
installée sur tous les systèmes (implémentation portable). Ces informations fournissent des
recommandations utiles au support d'installation et de mise à jour
(l'utilisateur peut forcer l'installation
d'une fonction quelle que soit la valeur de ce paramètre).
- ws : spécification facultative du système de fenêtrage. Liste de désignateurs de systèmes d'exploitation Windows, séparés par une virgule, définie par Eclipse (reportez-vous au Javadoc pour org.eclipse.core.runtime.Platform).
Indique que cette fonction ne doit être installée que sur l'un des systèmes d'exploitation Windows indiqués. Si cet attribut n'est pas précisé, l'entrée peut être installée sur tous les systèmes (implémentation portable). Ces
informations fournissent des recommandations utiles au support
d'installation et de mise à jour (l'utilisateur peut forcer
l'installation d'une entrée quelle que soit la valeur de ce paramètre).
- nl : spécification facultative des paramètres régionaux. Liste
de désignateurs de paramètre régional, séparés par des
virgules, définie par Java. Indique que cette entrée ne doit être
installée que sur un système dont les paramètres régionaux sont
compatibles (à l'aide
des règles Java pour la correspondance des paramètres régionaux). Si cet attribut n'est pas précisé, l'entrée peut être installée sur tous
les systèmes (implémentation indépendante de la langue choisie). Ces
informations fournissent des recommandations utiles au support
d'installation et de mise à jour (l'utilisateur peut forcer
l'installation d'une entrée quelle que soit la valeur de ce paramètre).
- download-size : conseil facultatif fourni par l'outil de mise en
forme, indiquant la taille du téléchargement en kilo-octets de
l'archive de données référencée. Si elle n'est pas spécifiée, la
taille du téléchargement est inconnue (Remarque sur
l'implémentation : l'implémentation doit faire la
différence entre une taille "inconnue" et une taille de 0)
- install-size : conseil facultatif fourni par l'outil de mise en
forme, indiquant la taille de l'installation en kilo-octets de
l'archive de données référencée. Si elle n'est pas spécifiée, la
taille de l'installation est inconnue (Remarque sur
l'implémentation : l'implémentation doit faire la
différence entre une taille "inconnue" et une taille de 0)
Si elle interagit avec le site de mise à jour, l'implémentation de
la fonction mappe les éléments <plugin>
et <data> en identificateurs de chemin utilisés par le site
pour déterminer les fichiers à télécharger et installer. L'implémentation
par défaut des fonctions fournie par Eclipse génère les
identificateurs de chemin de la manière suivante :
-
L'élément <plugin> se traduit par une entrée de
chemin sous la forme "plugins/<pluginId>_<pluginVersion>.jar"
(par exemple, "plugins/org.eclipse.core.boot_2.0.0.jar")
-
L'élément <data> se traduit par une entrée de
chemin sous la forme "features/<featureId>_<featureVersion>/<dataId>"
(par exemple, "features/com.xyz.tools_1.0.3/examples.zip")
En général, les documents du manifeste feature.xml doivent
spécifier un encodage UTF-8. Par exemple :
<?xml version="1.0" encoding="UTF-8"?>
Le texte traduisible du fichier feature.xml peut être séparé en
fichiers feature<_envLocal>.properties à l'aide des conventions de
regroupement des propriétés Java.
Les
chaînes traduites sont utilisées lors de l'installation (n'utilisez
donc pas le mécanisme d'exécution des fragments de plug-in).