Personnalisation du manifeste d'installation Notes ® pour les fonctionnalités Eclipse nouvelles ou tierces
Si vous avez créé ou obtenu une fonctionnalité Eclipse personnalisée ou tierce à ajouter à l'installation de Notes ® , vous devez créer une fonctionnalité (installfeature) dans le manifeste d'installation de Notes ® ( install.xml ) en utilisant la même convention que les autres fonctionnalités. (installfeature) dans le manifeste.
La DTD (Document Type Definition) du manifeste d'installation Notes® diffère de la DTD standard du manifeste d'installation ou de provisionnement d'Eclipse ou d'Expeditor. Par exemple, le manifeste d'installation Notes ® contient au moins quatre attributs uniques : "obligatoire", "par défaut", "afficher" et "description".
Pour de plus amples informations sur la configuration, consultez les rubriques connexes.
Elément installfeature
The attributes that determine if the "installfeature" name appears on the Notes® feature installation panel are "default," "required," and "show."
La liste suivante décrit les attributs requis de chaque élément "installfeature" :
- default : indique si le nom "installfeature" est sélectionné pour une installation. Si cet attribut est défini sur "true", le nom "installfeature" est sélectionné dans le panneau d'installation des fonctions. Si cet attribut est défini sur "false", le nom "installfeature" n'est pas sélectionné dans le panneau d'installation des fonctions. Remarque : L'attribut "default" est ignoré lors de la réexécution du programme d'installation et est ignoré lors de la mise à niveau, sauf si "installfeature" n'existait pas dans l'offre précédemment installée. Ceci permet au programme d'installation d'afficher l'état (installé ou non installé) de l'élément "installfeature" disponible dans l'offre précédemment installée.
- id : indique un ID unique pour la fonction à installer. Actuellement, aucune vérification de validation n'est effectuée pour déterminer le caractère unique du champ d'ID.
- name -- Specifies the "installfeature" name as it will appear on the Notes® feature installation panel.
- required -- Specifies whether the "installfeature" must be installed. If set to true, the feature is installed. If set to false, and show is set to true, the feature name appears on the Notes® feature installation panel and the user can select the option.
- show -- Specifies whether the "installfeature" name appears on the Notes® feature installation panel. If set to true, the "installfeature" name is visible. If set to false, the "installfeature" name is not visible.
- version : ajoute un suffixe numérique à l'élément "installfeature" de la version d'installation.
Elément feature
La liste suivante décrit les attributs requis pour chaque élément "feature" :
- download size : indique l'espace disque temporaire nécessaire pour l'installation de cette fonction.
- id : indique l'ID unique qui identifie cette fonction spécifique et qui respecte la convention d'appellation des ID utilisés dans le fichier features.xml pour cette fonction.
- match : indique une dépendance d'action des fonctions associée à l'attribut de la valeur de la version et est utilisé pour définir une règle de correspondance. Remarque : Une valeur de version peut être composée de quatre parties : major.minor.service.qualifier.
- Les options disponibles sont les suivantes :
- GreaterOrEqual : toutes les parties de la version doivent être supérieures ou égales. La version dépendante doit être au moins au même niveau que la version spécifiée, ou à un niveau "service", "minor" ou "major" plus élevé.
- compatible : "major" doit correspondre et les autres parties être supérieures ou égales. La version plug-in dépendante doit être au moins au même niveau que la version spécifiée, ou à un niveau "service" ou "minor" plus élevé (le niveau de la version "major" doit correspondre à la version spécifiée).
- equivalent : "major" et "minor" doivent correspondre et les dernières parties (par exemple, service.qualifier) doivent être supérieures ou égales. La version dépendante doit être au moins au même niveau que la version spécifiée, ou à un niveau "service" plus élevé (les niveaux de version "major" et "minor" doivent correspondre à la version spécifiée).
- perfect : toutes les parties de la version doivent correspondre. La version dépendante doit correspondre parfaitement à la version spécifiée.
Par exemple, les attributs suivants permettent d'effectuer une installation uniquement si la valeur de la version du site de mise à jour et du fichier site.xml est égale à 3.0.0.
version="version="3.0.0" match="perfect"
- size : indique l'espace disque requis pour la fonction installée.
- url : indique l'emplacement où vous pouvez obtenir l'élément "installfeature" au cours de l'installation et du paramétrage initial.
- version : indique la version de la fonction à installer et à paramétrer.
Il s'agit d'une valeur en trois ou quatre parties associée à la fonction à installer. Elle possède une dépendance avec la valeur "match" permettant d'installer ou non la fonction. Elle présente également une dépendance future sur la valeur "match" pour définir la mise à jour de la fonction installée.
L'attribut version contient les valeurs principales suivantes : major.minor.service release.qualifier. L'exemple suivant affiche la version 3.0.0 avec le qualificateur "20100309-1700" représentant un build nommé ou une autre valeur de qualificateur :version="3.0.0.20100300-1700"
Exemple de fonction personnalisée ou d'éditeur tiers
<installfeature default="false" id="ISVExample1" name="YourToolA" required="false" show="true" version "3.0.0.20100309-1700">
<requirements>
<feature
download-size="72457"id="com.abx.yourtoolabxz.tools.feature" match="perfect" size="227855" url="${installer.root}/updateSite.zip"version="3.0.0.20100309-1700"/>