Ce point d'extension doit être utilisé pour enregistrer des exemples de code Eclipse. Un exemple est constitué par un ou plusieurs projets Eclipse intégrés de manière à pouvoir être importés ultérieurement dans l'espace de travail.
Chaque exemple a un nom, un ou plusieurs éléments de projet et une perspective finale. L'exemple d'assistant crée un projet pour chaque élément de projet
, importe le contenu du fichier d'archive et ouvre la perspective finale, si indiqué. Les projets doivent être complets, c'est-à-dire qu'ils doivent posséder une nature et un chemin d'accès aux classes corrects (dans le cas des projets Java ou des projets de plug-in).
Si la vue cible est spécifiée et contient des éléments de ressource, il sera possible de sélectionner et de révéler ses ressources, une fois que l'exemple aura été créé.
Ce point d'extension est actuellement réservé à l'usage exclusif du SDK interne d'Eclipse. Son utilisation est donc limitée aux exemples du SDK d'Eclipse.
<!ELEMENT extension (sample+)>
<!ATTLIST extension
point CDATA #REQUIRED
id CDATA #IMPLIED
name CDATA #IMPLIED>
org.eclipse.pde.ui.samples
, dans le cas présent.<!ELEMENT sample (description , project+ , activity*)>
<!ATTLIST sample
id CDATA #REQUIRED
name CDATA #REQUIRED
perspectiveId CDATA #IMPLIED
launcher CDATA #IMPLIED
targetViewId CDATA #IMPLIED>
élément représentant un exemple unique devant être importé dans l'espace de travail.
org.eclipse.debug.ui.ILaunchShortcut
.org.eclipse.ui.part.ISetSelectionTarget
. Les ressources répertoriées dans les éléments du projet
seront sélectionnées et révélées dans la vue cible.<!ELEMENT project EMPTY>
<!ATTLIST project
name CDATA #REQUIRED
archive CDATA #REQUIRED
shared CDATA #IMPLIED
selectReveal CDATA #IMPLIED>
pour chaque élément du projet, un projet d'espace de travail est créé avec le contenu importé à partir du fichier d'archive associé.
true
et qu'un projet du même nom existe déjà dans l'espace de travail, il est ignoré automatiquement. Sinon, les utilisateurs seront invités à accepter ou non le remplacement.<!ELEMENT description EMPTY>
<!ATTLIST description
helpHref CDATA #IMPLIED>
le texte du corps de cet élément doit contenir une description de l'exemple.
<!ELEMENT activity EMPTY>
<!ATTLIST activity
id CDATA #REQUIRED>
spécifie l'activité devant être activée pour cet exemple
Voici un exemple illustrant le point d'extension :
<extension point=
"org.eclipse.pde.ui.samples"
>
<sample id=
"com.example.xyz.sample"
name=
"My Sample"
>
<description helpHref=
"/com.example.xyz.doc/samples/com.example.xyz.sample1/doc-html/doc.html"
>
Brève description de l'exemple.</description>
<project name=
"com.example.xyz.sample1"
archive=
"samples/sample1.zip"
/>
</sample>
</extension>
Si indiquée, la valeur de l'attribut launcher
doit représenter le nom complet de la classe Java qui implémente l'interface org.eclipse.debug.ui.ILaunchShortcut
.
L'interface utilisateur de PDE fournit le programme de lancement du plan de travail d'exécution pour le lancement d'une autre instanced'Eclipse.
Copyright (c) 2004 IBM Corporation and others.
All rights reserved. Ce programme et les produits qui l'accompagnent sont
distribués sous licence Eclipse v1.0 et disponibles à
l'adresse suivante :
http://www.eclipse.org/legal/epl-v10.html