A partir da versão 3.4, o Eclipse é enviado com pacotes configuráveis de origens individuais que permitem uma entrega de origem mais flexível. Consulte a página "Pacotes Configuráveis de Origens Individuais" para obter detalhes. Os plug-ins de origem com formato de pastas tradicionais ainda podem ser criados conforme a estrutura de tópicos abaixo.
Considere o seguinte recurso do 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" />
O conceito do SDK é incluir um recurso, bem como a origem desse recurso. Observe a propriedade generate.feature no arquivo build.properties do recurso. Essa propriedade indica ao Build PDE para gerar um recurso nomeado "org.foo.rcp.source" com base no conteúdo do recurso "org.foo.rcp". O build PDE gerará um recurso org.foo.rcp.source, um plug-in que conterá o código de origem e fragmentos contendo a origem de qualquer pacote configurável específico da platarfoma incluídos no recurso:
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
A propriedade generate.feature possui o seguinte formato:
generate.feature@<source feature id> = <feature id> [, feature@<feature id>[;attribute=value]*]* [, plugin@<plugin id>[;attribute=value]*]*
Utilize plugin@ para incluir plug-ins adicionais que não fizeram parte do recurso original no recurso de origem gerado. Isso é útil para plug-ins de documentação. O feature@ junto com um modelo de origem pode ser utilizado para aninhar recursos de origem (consulte a seguir).
O recurso a partir do qual o recurso de origem está sendo gerado pode fornecer arquivos de modelo para serem incluídos no recurso de origem gerado:
features/
org.foo.rcp/
sourceTemplateFeature/<arquivos a serem incluídos no recurso de origem gerado>
sourceTemplatePlugin/<arquivos a serem incluídos no plugin de origem gerado>
sourceTemplateFragment/<arquivos a serem incluídos no fragmento gerado específico da plataforma>
Quaisquer arquivos localizados nessa pasta sourceTemplate serão incluídos no recurso/plug-in/fragmento gerado apropriado. Especificamente, os arquivos desses diretórios substituirão os arquivos gerados pelo build PDE. Isso poderá ser utilizado para fornecer um feature.xml customizado se houver requisitos relativos a seu recurso de origem que o build PDE não suporta.
Você pode aninhar recursos de origem fornecendo um
arquivo sourceTemplateFeature/build.properties para seu recurso de origem
gerado que contenha uma propriedade generate.feature para o recurso de origem
aninhado. Também é necessário assegurar que o principal
feature.xml de origem inclua o recurso de origem aninhado e isso deve ser feito utilizando
feature@ ou fornecendo um feature.xml do modelo:
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/...
Também é possível gerar um único plug-in de origem baseado em um recurso, em vez de gerar um recurso de origem inteiro. A propriedade para fazer isso é:
generate.plugin@<source plug-in id>=<feature-in id>
Esteja ciente de que esses plug-ins de origem com estilo antigo (um plug-in que contém origem para todos os plug-ins do recurso) devem ser instalados no formato de pasta. Portanto, é necessário configurar o atributo unpack="true" no arquivo feature.xml.
Exemplo: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