Exemple - Mises à jour de logiciels

Introduction

Cet exemple montre comment installer des composants additionnels pour compléter la plateforme Eclipse. Il est contenu dans le plug-in org.eclipse.update.examples .
 

Exécution de l'exemple

Pour exécuter l'exemple, vous devez disposer d'un serveur HTTP (par exemple, Apache Server). Copiez l'intégralité du répertoire install du plug-in org.eclipse.update.examples dans l'arborescence des documents du serveur HTTP (par exemple, le répertoire htdocs dans le cas d'Apache Server). Assurez-vous que le serveur est en cours d'exécution.

Démarrez le plan de travail Eclipse. Sélectionnez Aide, puis Mises à jour de logiciels, puis Ajouter...
Sur la page Emplacement, entrez l'URL de votre serveur (par exemple, http://mon.serveur/... ; indiquez l'URL réelle de votre serveur). Cette URL doit refléter tout élément de chemin supplémentaire conduisant au répertoire install que vous avez copié. Par exemple, si vous avez copié le répertoire install dans htdocs/examples (de sorte que le chemin est htdocs/examples/install), vous devez entrer l'URL sous la forme http://mon.serveur/examples.
Cliquez sur Ajouter, puis sur Suivant>. Vous devez obtenir une liste de composants installables. L'exemple fourni contient un seul composant appelé Mise à jour. Sélectionnez-le et terminez l'installation. Vous devez ensuite redémarrer le plan de travail pour que les modifications soient prises en compte.

Une fois le plan de travail redémarré, vous pouvez voir la nouvelle fonction exemple en l'ajoutant à vos perspectives. Sélectionnez Perspective, Personnaliser..., puis développez la branche Autre. Sélectionnez Sample Action Set (il s'agit d'un jeu d'actions implémenté par le plug-in des exemples que vous venez de télécharger et d'installer). Un nouveau menu intitulé Sample Menu doit apparaître dans le plan de travail avec une nouvelle action. En cliquant sur cette action, vous obtenez une boîte d'information (confirmant que l'installation s'est bien déroulée).
 

Détails

L'exemple illustre la structure requise sur un serveur HTTP pour permettre le téléchargement de composants Eclipse. Il consiste en un simple plug-in qui ajoute un menu et une action au plan de travail. Ce plug-in a été conditionné sous forme de fichier JAR de composant à l'aide des outils de l'environnement de développement de plug-ins (PDE) du plan de travail Eclipse. Notez que le répertoire du plug-in de base org.eclipse.update.examples ne contient pas le fichier plugin.xml. Par conséquent, le plug-in de base n'apporte rien au plan de travail. Il contient simplement un répertoire install qui est utilisé dans les étapes précédentes.

Le répertoire install que vous avez copié sur votre serveur HTTP est l'endroit où sont placés les fichiers JAR de composant que vous générez à l'aide de l'outil de définition de projet de composant du PDE (avec un fichier "côté serveur" supplémentaire). Sa structure est la suivante :

install/
    components/
        install.index
        org.eclipse.update.examples.component_1.0.0/
            install.xml
            install.properties
            install_en.properties
            orq.eclipse.update.examples.component_1.0.0.jar

Cette arborescence de répertoires est indispensable sur le serveur. Elle comporte une racine install commune. Il y a également un sous-répertoire components commun, qui contient lui-même un sous-répertoire pour chaque composant téléchargeable (dans l'exemple de structure présenté ci-dessus, il n'y en a qu'un, org.eclipse.update.examples.component_1.0.0). Le fichier install.index a été créé manuellement (il n'a pas été généré par le PDE). Il s'agit d'un simple index des répertoires de composant (une ligne par répertoire). Cela permet au client de mise à jour de déterminer quels répertoires de composant existent réellement sur le serveur.

Le composant proprement dit, créé par le PDE, est contenu dans le fichier orq.eclipse.update.examples.component_1.0.0.jar. Le fichier install.xml, qui décrit le composant, est également exposé pour permettre au client de mise à jour d'identifier le composant sans avoir besoin de télécharger son fichier JAR. Les fichiers install[_environnement_local].properties contient des chaînes séparées.

Pour plus de détails sur la création de fichiers JAR de composant, reportez-vous à la documentation du PDE. Sélectionnez Aide, puis Contenu de l'aide. Dans la liste déroulante, sélectionnez le guide du PDE pour ISV. Pour des détails supplémentaires sur les conventions d'installation, reportez-vous à la documentation de la plateforme Eclipse. Sélectionnez Aide, puis Contenu de l'aide. Dans la liste déroulante, choisissez Plug-in de plateforme - Guide du développeur. Les informations d'installation se trouvent dans la section Référence, Autres articles de référence, Installation et mise à jour de la plateforme.
 

Copyright IBM Corp. 2000, 2001.  All Rights Reserved.