Desde la versión 3.4, Eclipse se ha enviado con paquetes fuente individuales que permiten un suministro más flexible del código fuente. Consulte la página "Paquetes fuente individuales" para obtener más detalles. Los plug-ins fuente con forma de carpeta tradicionales se pueden seguir construyendo tal como se muestra a continuación.
Observe esta característica SDK:
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" />
La idea del SDK es incluir una característica junto con el código fuente de la misma. Observe la propiedad generate.feature del archivo build.properties de la característica. Esta propiedad indica a la construcción PDE que genere una característica denominada "org.foo.rcp.source" basada en el contenido de la característica "org.foo.rcp". La construcción PDE generará una característica org.foo.rcp.source, un plug-in que contendrá el código fuente y fragmentos que contendrán el código fuente de los paquetes compuestos específicos de plataforma incluidos en la característica:
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 propiedad generate.feature tiene el formato siguiente:
generate.feature@<id característica fuente > = <id característica> [, feature@<id característica>[;attribute=value]*]* [, plugin@<id plug-in>[;attribute=value]*]*
Utilice plugin@ para añadir plug-ins adicionales que no formaban parte de la característica original de la característica de código fuente generada. Esto resulta de utilidad para plug-ins de documentación. Puede utilizarse feature@ junto con una plantilla de fuente para anidar características de código fuente (consulte la información que figura más adelante).
La característica desde la que se genera la característica de código fuente puede suministrar archivos de plantilla que se incluirán en la característica de código fuente generada:
features/
org.foo.rcp/
sourceTemplateFeature/<archivos que deben incluirse en la característica de código fuente generada>
sourceTemplatePlugin/<archivos que deben incluirse en el plugin de código fuente generado>
sourceTemplateFragment/<archivos que deben incluirse en los fragmentos específicos de plataforma generados>
Los archivos ubicados en estas carpetas sourceTemplate se incluirán en la característica, plug-in o fragmento adecuado que se genere. Específicamente, los archivos de estos directorios sustituirán a los archivos generados por la construcción PDE. Esto puede utilizarse para suministrar un archivo feature.xml personalizado si existen requisitos para la característica de código fuente a los que la construcción PDE no da soporte.
Puede anidar características de código fuente suministrando un archivo
sourceTemplateFeature/build.properties para la característica de código fuente generada
que contenga una propiedad generate.feature para la característica de código fuente
anidada. También deberá asegurarse de que el archivo feature.xml de código
fuente de alto nivel contenga la característica de código fuente anidada, mediante la
utilización de feature@ o suministrando un archivo de plantilla 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/...
También es posible generar un sólo plug-in fuente basado en una característica en lugar de generar toda una característica fuente. La propiedad que debe utilizar para ello es la siguiente:
generate.plugin@<id de plug-in fuente>=<id de característica>
Tenga en cuenta que estos plug-ins fuente de estilo antiguo (un plug-in que contiene el código fuente para todos los plug-ins de la característica) se deben instalar en formato de carpeta. Por lo tanto, debe establecer el atributo unpack="true" en el archivo feature.xml.
Ejemplo: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