Environnement PDE (Plug-in Development Environment) - Notes sur l'édition

1.0 Introduction
2.0 Problèmes et restrictions connus
    2.1 Commentaires dans les pages de code des éditeurs XML dans l'environnement PDE
    2.2 Opérations liées au presse-papiers dans la vue des propriétés
   2.3 Incident lors de l'importation des fragments
    2.4 Le système considère que la sortie est enregistrée dans le dossier bin/
    2.5 Les préférences ne sont pas actives lors d'une importation/exportation
    2.6 Les fonctions du presse-papiers ne sont pas opérationnelles dans l'éditeur Feature Manifest
    2.7 La sélection du chemin de compilation empêche la compilation du projet Java
    2.8 ECLIPSE_HOME génère des chemins d'accès aux classes fragiles à cause des numéros de version dans les chemins d'accès au répertoire de plug-in
    2.9 L'assistant d'importation des plug-in n'autorise pas l'importation de versions différentes
    2.10 La vérification de syntaxe du fichier manifest n'est possible que dans un environnement PDE
    2.11 L'environnement PDE ne conserve pas la présentation d'origine du fichier manifest
    2.12 L'option Aller à la ligne dans l'éditeur du fichier manifest efface le contenu de la vue Structure
    2.13 L'assistant Nouvelle fonction ne génère pas le fichier build.properties
   2.14 La mise à jour du chemin d'accès aux classes associe la source à partir d'une installation erronée
    2.15 Le type des bibliothèques de plug-in ne peut pas être indiqué
    2.16 Les bibliothèques d'exécution exportées par l'intermédiaire de plusieurs plug-in (au moins 3) ne sont pas définies dans le chemin d'accès aux classes
   2.17 Les couleurs de la page de code source de l'environnement PDE n'apparaissent pas lorsque vous appuyez sur Valider
   2.18 Le dossier Icons n'est pas inclus dans la propriété bin.includes de certains modèles PDE
   2.19 L'édition de liens entre touches Emacs ne fonctionne pas dans les zones de l'éditeur manifest

1.0 Introduction

Cette section contient des informations sur les incidents et les restrictions recensés dans l'environnement PDE.

2.0 Problèmes et restrictions connus

2.1 Commentaires dans les pages de code source des éditeurs XML dans l'environnement PDE

L'environnement PDE fournit un certain nombre d'éditeurs multi-pages qui contiennent une page de code source brut. Les éditeurs qui gèrent les fichiers XML (plug-in, fichiers manifest de fonction et de fragment) conservent les commentaires dans la plupart des cas. Les commentaires ajoutés avant l'élément XML racine ou après le dernier élément enfant contenu dans l'élément parent ne sont pas conservés. 

2.2 Opérations liées au presse-papiers dans la vue des propriétés

Les raccourcis clavier du presse-papiers (Ctrl+X, Ctrl+C, Ctrl+V, etc.) ne fonctionnent pas dans les éditeurs de cellules des propriétés qui appartiennent à l'éditeur PDE Plug-in Manifest. Utilisez le menu en incrustation pour activer ces opérations. 

2.3 Incident lors de l'importation des fragments

Si un espace de travail contient les projets binaires d'un plug-in et un fragment faisant référence à ce plug-in, les bibliothèques de fragments sont ajoutées au chemin d'accès aux classes du projet de plug-in référencé. Si vous tentez de remplacer le plug-in et le fragment par des versions d'un autre niveau, il arrive que la suppression de l'ancien fragment échoue. Dans ce cas, répétez l'opération pour restaurer l'espace de travail. Seul le fragment et le plug-in concernés doivent être réimportés. 

2.4 Le système considère que la sortie est enregistrée dans le dossier bin/

Dans l'environnement PDE, tous les projets de plug-in et de fragment qui contiennent du code Java sont supposés comporter un ou plusieurs dossiers source et générer la sortie dans le dossier bin/. Bien qu'il soit possible de modifier le nom du dossier de sortie dans la boîte de dialogue Propriétés, cette opération risque de perturber le fonctionnement du programme de lancement du plan de travail d'exécution de l'environnement PDE.

2.5 Les préférences ne sont pas actives lors d'une importation/exportation

Les préférences définies à la page des préférences PDE Plateforme cible ne sont pas conservées. Les opérations d'importation/exportation effectuées dans la boîte de dialogue Préférence ne les affectent donc pas. 

2.6 Les fonctions du presse-papiers ne sont pas opérationnelles dans l'éditeur Feature Manifest

Les pages de l'interface graphique de l'éditeur Feature Manifest prennent en charge des menus en incrustation offrant des fonctions de presse-papiers standard (couper, copier et coller, par exemple). Cependant, ces opérations ne sont pas applicables aux objets de contrôle structurels (arborescences et listes). Celles-ci s'appliquent uniquement aux objets de contrôle (widget) de type texte dans les pages Information et Source

2.7 La sélection du chemin de compilation empêche la compilation du projet Java

L'environnement PDE calcule le chemin d'accès aux classes de compilation à partir des mappages des dossiers source dans le fichier build.properties. Ce dernier définit le mode de compilation des dossiers source dans les bibliothèques d'exécution. Lorsque ce fichier n'existe pas, l'environnement PDE calcule le chemin d'accès aux classes qui ne contient aucun dossier source, ce qui provoque des erreurs de compilation. Le fichier build.properties requis est généré par l'environnement PDE lors de la création d'un projet de plug-in. Si la procédure de création du projet de plug-in est différente, le fichier build.properties doit être ajouté manuellement. Pour plus de détails sur le format des fichiers build.properties, reportez-vous au PDE Guide. 

2.8 ECLIPSE_HOME génère des chemins d'accès aux classes fragiles à cause des numéros de version dans les chemins d'accès au répertoire de plug-in

Les produits Eclipse sont conçus de manière à ce que tous les plug-in soient installés dans le même répertoire et que chaque plug-in se trouve dans un répertoire dont le nom comporte à la fois un ID et une version de plug-in ("org.eclipse.ui_2.0.0", par exemple). Si les plug-in externes sont utilisés dans un contexte d'auto-hébergement, les noms de répertoires de plug-in externes apparaissent dans les chemins d'accès aux classes générés par l'environnement PDE. Les modifications de version des plug-in affectent les chemins d'accès aux classes qui doivent être recalculés si la plateforme cible utilise des numéros de versions différents. 

2.9 L'assistant d'importation des plug-in n'autorise pas l'importation de versions différentes

Dans WebSphere Studio, deux plug-in dotés d'un ID identique mais d'un niveau de version différent, peuvent coexister s'ils sont utilisés uniquement par des bibliothèques d'exécution. Cependant, ces plug-in ne peuvent pas être gérés par l'environnement PDE car ce dernier créé des noms de projets utilisant des ID de plug-in lors de l'importation de projets binaires. 

2.10 La vérification de syntaxe du fichier manifest n'est possible que dans un environnement PDE

L'environnement PDE peut fournir uniquement des marqueurs de vérification de syntaxe et d'erreur/avertissement dans les fichiers manifest du plug-in si le projet de plug-in est de type plug-in PDE. Un projet de plug-in est de ce type lorsqu'il est créé par un assistant PDE. Cette situation se produit uniquement si un projet Java normal est utilisé pour héberger un plug-in. Cet incident peut être résolu en convertissant ce projet en projet PDE. 

2.11 L'environnement PDE ne conserve pas la présentation d'origine du fichier manifest

Lorsqu'une page non source d'un éditeur de fichier manifest PDE est utilisée, l'environnement PDE convertit à nouveau les modifications au format XML en régénérant le fichier. Si le contenu et les commentaires sont conservés, il n'en va pas de même pour la présentation du fichier. Cela peut provoquer des incidents liés à l'affichage de modifications erronées au cours de la comparaison de fichiers. Si la présentation du fichier est importante, effectuez toutes les modifications dans la page Source. Une autre solution consiste à éviter d'utiliser les pages Source. Dans la mesure où le mode de génération des fichiers XML respecte et conserve l'ordre des éléments principaux (extensions, points d'extension, etc.), les modifications effectuées dans une page non Source d'un éditeur de fichier manifest PDE ne provoquent pas d'erreur de modification de fichiers au cours d'une comparaison de fichiers.

2.12 L'option Aller à la ligne dans l'éditeur du fichier manifest efface le contenu de la vue Structure

Lorsque l'option Source > Aller à la ligne est sélectionnée dans la page Source de l'éditeur du fichier manifest PDE, la vue Structure est grisée. Etant donné que la page Source ne comporte pas de structure fonctionnelle, cela n'engendre aucune perte de fonction. 

2.13 L'assistant Nouvelle fonction ne génère pas le fichier build.properties

Lors de la création d'un projet de fonction, l'assistant PDE ne génère pas automatiquement un fichier build.properties. Ainsi, cette opération génère un fichier JAR de fonction vide. La solution consiste à créer manuellement un fichier build.properties en suivant les instructions fournies dans le guide PDE. 

2.14 La mise à jour du chemin d'accès aux classes associe la source à partir d'une installation erronée

Les bibliothèques Java sont associées au code source en fonction des emplacements du code source indiqués dans une préférence PDE. Par défaut, ces emplacements sont enregistrés par des plug-in de l'instance de phase de conception WebSphere Studio. Si la plafeforme source n'est pas la même que l'instance de conception, le code source fourni par ces plug-in n'est pas synchronisé avec les bibliothèques. La solution consiste à désélectionner les emplacements par défaut et à définir de nouveaux emplacements de code source qui désignent les plug-in prenant en charge le code source dans l'installation WebSphere Studio cible. 

2.15 Le type des bibliothèques de plug-in ne peut pas être indiqué

Les éditeurs du fichier manifest de l'environnement PDE ne fournissent pas d'objets de contrôle permettant d'indiquer si les bibliothèques d'exécution sont de type "code" ou "ressource". La seule manière d'indiquer cet attribut consiste à l'ajouter manuellement dans la page source. 

2.16 Les bibliothèques d'exécution exportées par l'intermédiaire de plusieurs plug-in (au moins 3) ne sont pas définies dans le chemin d'accès aux classes

Si la bibliothèque d'exécution d'un plug-in doit être exportée par l'intermédiaire de plusieurs plug-in (au moins 3), celle-ci n'est pas automatiquement ajoutée au chemin d'accès aux classes de compilation lors de la génération du fichier build.xml. Exemple : Le plug-in A exporte des bibliothèques, le plug-in B a besoin du plug-in A et exporte à nouveau le plug-in A, le plug-in C a besoin du plug-in B et exporte à nouveau le plug-in B. Si le plug-in D a besoin du plug-in C, les bibliothèques du plug-in  A ne seront pas ajoutées au chemin de compilation lors de la génération du fichier build.xml bien qu'elles soient disponibles lors de l'exécution. La solution est la suivante :

  1. Générez un fichier build.xml en utilisant l'environnement PDE (sélectionnez le fichier plugin.xml et cliquez sur Créer le plug-in dans les fichiers JAR)
  2. Modifiez le fichier build.properties et ajoutez la ligne suivante :
    custom = true
  3. Ajoutez les fichiers JAR manquants au chemin d'accès aux classes de la tâche javac dans build.xml.

2.17 Les couleurs de la page de code source de l'environnement PDE n'apparaissent pas lorsque vous appuyez sur Valider

La modification des couleurs utilisées par PDE pour les pages de code source de son éditeur multipages n'apparaît pas immédiatement dans les éditeurs ouverts lorsque vous appuyez sur le bouton Valider dans  la page Développement de plug-in > Préférences d'éditeur. Pour résoudre ce problème, fermez l'éditeur, puis rouvrez-le.

2.18 Le dossier Icons n'est pas inclus dans la propriété bin.includes de certains modèles PDE

L'environnement PDE fournit plusieurs modèles qui permettent de créer des projets de plug-in et/ou des extensions. Lorsque les projets sont créés, le fichier build.properties est créé avec le contenu initial, qui comprend la propriété 'bin.includes' répertoriant le fichier manifest de plug-in et ses fichiers JAR de code. Toutefois, il ne mentionne pas les autres fichiers créés par le modèle tels que le dossier icons/. Ces fichiers ne se retrouvent pas dans le plug-in créé à l'aide du fichier de compilation Ant ou exporté à l'aide de l'assistant 'Export deployable plug-ins and fragments'. Pour résoudre ce problème, ajoutez manuellement ces fichiers et ces répertoires dans le fichier build.properties.

2.19 L'édition de liens entre touches Emacs ne fonctionne pas dans les zones de l'éditeur manifest

Les éditions de liens entre touches non définies par défaut ne fonctionnent pas dans les zones de pages non-sources des éditeurs de fichier manifest PDE.

Retour au fichier Readme principal

>