Instructions d'installation du produit
La plate-forme fournit des outils standard de mise à jour et
d'extension des produits. Afin de participer à ces mécanismes,
votre produit doit respecter les instructions ci-après. Il
pourra ainsi cohabiter sans problème, voire améliorer d'autres
produits basé sur Eclipse.
Prenons à nouveau l'exemple de structure de répertoires pour le
produit acmeweb :
acmeweb/
acmeweb.exe
eclipse/
.eclipseproduct
eclipse.exe
startup.jar
install.ini
.config/
platform.cfg
jre/
features/
com.example.acme.acmefeature_1.0.0/
feature.xml
...
plugins/
com.example.acme.acmefeature_1.0.0/
plugin.xml
about.ini
about.html
about.mappings
about.properties
acme.png
plugin_customization.ini
splash.jpg
welcome.xml
com.example.acme.acmewebsupport_1.0.0/
...
links/
...
D'où viennent ces fichiers ? Observez le contenu du produit
du point de vue de l'équipe de développement. Les fichiers
installés peuvent être classés en cinq catégories principales :
- des fichiers de niveau supérieur (tels que acmeweb.exe)
- des dispositifs et plug-in
- la plate-forme Eclipse
- le JRE (Java runtime environment)
- des fichiers générés par le processus d'installation
Un script d'installation adéquat créera la structure de
répertoires appropriée en procédant comme suit :
- permettre à l'utilisateur d'indiquer le répertoire supérieur
d'installation (tel que c:\acmeweb). Il sera simplement
dénommé acmeweb dans les lignes qui suivent.
- vérifier qu'un produit n'est pas déjà installé à cet emplacement.
- copier les fichiers comme suit :
- Les fichiers de niveau supérieur sont copiés dans acmeweb.
- Les fichiers Eclipse sont copiés dans
acmeweb/eclipse avec les structures de répertoires de
dispositifs et de plug-in attendues.
- Les fichiers JRE sont copiés dans
acmeweb/eclipse/jre. S'il existe un JRE à un autre
endroit, le raccourci de l'application doit être configuré pour
appeler Eclipse avec l'argument de ligne de commande -vm afin
que la plate-forme soit informée de cet emplacement.
- Les dispositifs et les plug-ins sont copiés respectivement dans
acmeweb/eclipse/features et acmeweb/eclipse/plugins.
- créer un fichier de marqueur .eclipseproduct dans
acmeweb/eclipse. Ce fichier est un fichier de format
java.io.Properties indiquant le nom, l'ID et la version du
produit.
- stocker toutes les informations d'installation nécessaires
(utilisateur, licence, date) devant figurer dans la boîte de dialogue
A propos de dans
acmeweb/eclipse/plugins/com.example.acmefeature_1.0.0/about.mappings.
- Si le dispositif principal (avant la version 3.0) est utilisé pour définir le produit, remplacez
acmeweb/eclipse/install.ini par un élément définissant la propriété feature.default.id
pour le dispositif principal du produit
- appeler l'exécutable du produit avec l'option
-initialize. La plate-forme effectue alors en silence tous
les traitements longs et place les résultats dans le cache ;
ainsi, à son démarrage, le produit apparaît rapidement et est
immédiatement opérationnel.
Problèmes entraînés par des utilisateurs multiples
Lorsqu'un produit est installé dans le but d'avoir des
utilisateurs multiples, il faut penser à retirer les données
individuelles (telles que le répertoire workspace) du
répertoire d'installation partagé du produit.
Problèmes de désinstallation
Lors de la désinstallation d'un produit, les concepts suivants
sont à prendre en compte :
- Tous les fichiers des répertoires eclipse/features
et eclipse/plugins doivent être supprimés, même s'ils n'ont
pas été copiés par le programme d'installation. De cette façon,
les fichiers ajoutés par le gestionnaire de mise à jour de la
plate-forme sont supprimés lors de la désinstallation du produit.
- Sauf pour le cas précédent, seuls les fichiers copiés
par le programme d'installation dans d'autres répertoires doivent
être supprimés. Il est important de conserver des données
essentielles, telles que le répertoire workspace, afin
d'obtenir les résultats attendus une fois le produit réinstallé.
Réinstallation du produit
Lorsque le produit est déjà installé, le programme doit permettre
l'exécution d'une mise à jour ou à niveau. La présence du
produit peut être confirmée en observant le répertoire
acmeweb/eclipse/.eclipseproduct. Les informations de ce
fichier de marqueur peuvent assurer que le produit approprié est mis
à jour. Pour savoir si des mises à jour sont disponibles,
comparez les noms de dispositifs. Par exemple,
acmeweb/eclipse/plugins/com.example.acmefeature_1.0.1 indique
que la mise à jour de la version 1.0.1 a déjà été appliquée au produit.
Une fois le besoin de réinstallation établi, le programme
d'installation doit copier ou remplacer les fichiers requis. Si
la version de la plate-forme Eclipse sous-jacente n'a pas changé, il
est fort probable que des répertoires entiers peuvent être
ignorés. Les numéros de versions ajoutés aux dispositifs et
plug-in de la plate-forme permettent de savoir dans quelle mesure des
changements dans un répertoire donné s'imposent.
Vous trouverez des informations supplémentaire sur l'installation
de produits dans
Comment écrire un
programme d'installation Eclipse.