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 manifeste n'est possible que dans un environnement PDE
    2.11 L'environnement PDE ne conserve pas la présentation d'origine du fichier manifeste
    2.12 L'option Aller à la ligne dans l'éditeur du fichier manifeste 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 source PDE n'entrent en vigueur qu'après la sélection du bouton Appliquer
   2.18 Le dossier Icons n'est pas inclus dans bin.includes pour certains modèles PDE
   2.19 Les associations de touches Emacs ne fonctionnent pas dans les zones de l'éditeur de fichiers manifeste

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 document 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 manifeste 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 manifeste 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 manifeste

Lorsqu'une page non source d'un éditeur de fichier manifeste 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 manifeste 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 manifeste 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 manifeste 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 plateforme 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 manifeste 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 source PDE n'entrent en vigueur qu'après la sélection du bouton Appliquer

Les modifications apportées aux couleurs utilisées par PDE pour les pages source de ses éditeurs multi-pages ne sont pas immédiatement visibles dans les éditeurs ouvertes une fois que vous avez cliqué sur le bouton Appliquer  de la page Développement de plug-in > Préférences de l'éditeur. Pour éviter ce problème, fermez l'éditeur et ouvrez-le à nouveau.

2.18 Le dossier Icons n'est pas inclus dans bin.includes pour certains modèles PDE

PDE fournit un certain nombre de modèles qui peuvent être utilisés pour créer des projets et/ou des extensions de plug-in opérationnels. Lorsque des projets sont créés, le fichier build.properties est créé avec le contenu initial, qui inclut la propriété 'bin.includes' contenant le fichier manifeste du plug-in et les fichiers JAR de code. Toutefois, elle n'inclut pas les autres fichiers créés par le modèle, tels que le dossier icons/. Ces fichiers supplémentaires ne se trouvent donc pas dans le plug-in lors de la compilation effectuée à l'aide du fichier de compilation Ant ou de l'exportation effectuée à l'aide de l'assistant d'exportation de fragments et de plug-in déployables. Pour éviter ce problème, ajoutez ces fichiers et ces répertoires manuellement dans le fichier build.properties.

2.19 Les associations de touches Emacs ne fonctionnent pas dans les zones de l'éditeur de fichiers manifeste

Les associations de touches autres que celles par défaut ne fonctionnent pas dans les zones des pages non sources des éditeurs de fichiers manifeste PDE.

Retour au fichier Readme principal

>