Depuis la version 3.4, Eclipse est livré avec des regroupements source qui permettent une souplesse de distribution de source plus grande. Consultez la page "Regroupements source individuels" pour des détails. Les plug-ins source qui se présentent sous la forme de dossiers traditionnels peuvent toujours être générés comme indiqué ci-dessous.
Considérons le dispositif SDK suivant :
features/
org.foo.sdk/
feature.xml: <includes id="org.foo.rcp" />
<includes id="org.foo.rcp.source" />
build.properties: generate.feature@org.foo.rcp.source = org.foo.rcp
org.foo.rcp/
feature.xml: <plugin id="org.foo.BundleA" />
<plugin id="org.foo.BundleB" />
<plugin id="org.foo.BundleB.win32" fragment="true" os="win32" />
L'idée sous-jacente du SDK, c'est qu'il inclut un dispositif ainsi que son code source. Notez la présence de la propriété generate.feature dans le fichier build.properties du dispositif. Cette propriété indique à la compilation PDE de générer le dispositif "org.foo.rcp.source" en fonction du contenu du dispositif "org.foo.rcp". La compilation PDE génère un dispositif org.foo.rcp.source, un plug-in qui contiendra le code source et les fragments contenant le code source des regroupements de plateforme inclus dans le dispositif :
features/
org.foo.rcp.source/
feature.xml: <plugin id="org.foo.rcp.source"/>
<plugin id="org.foo.rcp.source.win32" fragment="true" os="win32" />
plugins/
org.foo.rcp.source/src/
org.foo.BundleA/src.zip
org.foo.BundleB/src.zip
org.foo.rcp.source.win32/src/
org.foo.BundleB.win32/src.zip
La propriété generate.feature a le format suivant :
generate.feature@<ID dispositif source> = <ID dispositif> [, feature@<ID dispositif>[;attribute=value]*]* [, plugin@<ID plug-in>[;attribute=value]*]*
Utilisez plugin@ pour ajouter au dispositif source généré des plug-ins qui ne faisaient pas parti du dispositif d'origine. Ceci s'avère utile pour les plug-ins de documentation. feature@ et un modèle de source peuvent être utilisés pour imbriquer des dispositifs source (voir ci-dessous).
Le dispositif à partir duquel le dispositif source est généré peut fournir des modèles de fichiers à inclure dans le dispositif source généré :
features/
org.foo.rcp/
sourceTemplateFeature/<fichiers à inclure dans le dispositif source généré>
sourceTemplatePlugin/<fichiers à inclure dans le plug-in source généré>
sourceTemplateFragment/<fichiers à inclure dans les fragments générés spécifique à la plateforme>
Les fichiers situés dans ces dossiers sourceTemplate seront inclus dans le dispositif, le plug-in, le fragment généré approprié. Plus particulièrement, les fichiers de ces répertoires remplaceront les fichiers générés par la compilation PDE. Ceci peut être utilisé pour fournir un fichier feature.xml personnalisé s'il existe des conditions pour le dispositif source que la compilation PDE ne prend pas en charge.
Vous pouvez imbriquer des dispositifs en fournissant un fichier sourceTemplateFeature/build.properties pour le dispositif source généré qui contient une propriété generate.feature pour le dispositif source imbriqué. Vous devez également vous assurer que le code source principal feature.xml inclut le dispositif source imbriqué. Pour ce faire, utilisez feature@ ou fournissez un modèle feature.xml:
features/
org.foo.sdk/
sourceTemplateFeature/
build.properties: generate.feature@org.foo.nested.source = org.foo.nested
feature.xml: <includes id="org.foo.rcp" />
<includes id="org.foo.rcp.source" />
build.properties: generate.feature@org.foo.rcp.source = org.foo.rcp, feature@org.foo.nested.source
org.foo.rcp/...
org.foo.nested/...
Vous pouvez également générer un seul plug-in source en fonction d'un seul plug-in au lieu de baser le source sur un dispositif. La propriété permettant d'effectuer cette opération est :
generate.plugin@<source plug-in id>=<feature-in id>
Sachez que ces plug-ins source de style ancien (un plug-in contenant la source de tous les plug-ins du dispositif) doivent être installés sous la forme de dossiers. Par conséquent, vous devez définir l'attribut unpack="true" dans le fichier feature.xml.
Exemple :features/
org.foo.sdk/
feature.xml: <plugin id="org.foo.rcp" />
<plugin id="org.foo.sdk.source" unpack="true" />
build.properties: generate.plugin@org.foo.sdk.source = org.foo.sdk