Uma agrupamento de origem é identificado pela presença do cabeçalho Eclipse-SourceBundle no seu manifest. O formato deste cabeçalho é:
Eclipse-SourceBundle: <id-agrupamento>;versão=<versão>;roots:="root1, root2"
O ID de agrupamento e a versão indicam o agrupamento ao qual o código de origem incluído corresponde. A directiva raiz indica as pastas no agrupamento de origem que contêm código de origem. Se não for especificada nenhuma directiva raiz, assume-se o valor de ".".
As bibliotecas de ficheiros de classe são correlacionadas para localizações de origem de uma forma previsível. A raiz dos plug-ins correlaciona para a raiz do agrupamento de origem. É o caso mais frequente para a maioria dos plug-ins sujeitos a jar. Se o plug-in contiver bibliotecas adicionais para "foo/lib.jar", espera-se que a origem se encontre nas pastas "foo/libsrc/" correspondentes nos agrupamentos de origem.
org.eclipse.pde.core.jar org.eclipse.pde.core.source.jar - org/**/*.class - org/**/*.java - ant_tasks/pde-ant.jar - ant_tasks/pde-antsrc/org/**/*.java
Eclipse-SourceBundle: org.eclipse.pde.core;version="3.4.0.N20071128-0010";roots:="ant_tasks/pde-antsrc,."
org.eclipse.pde.build/ org.eclipse.pde.build.source.jar - pdebuild.jar - pdebuildsrc/org/**/*.java - lib/pdebuild-ant.jar - lib/pdebuild-antsrc/org/**/*.java
Eclipse-SourceBundle: org.eclipse.pde.build;version="3.4.0.N20071128-0010";roots:="pdebuildsrc,lib/pdebuild-antsrc"
PDE/Build pode gerar automaticamente agrupamentos de origem individuais, mas somente numa compilação sem cabeçalho. A geração de agrupamentos de origem individuais poderá ser activada ao especificar:
individualSourceBundles=true
Esta opção terá de ser especificada no ficheiro build.properties de nível superior da configuração da compilação e controla todas as gerações de origem para essa compilação. Consulte o tópico Gerar Plug-ins e Funções de Origem para mais detalhes sobre a criação de plug-ins e funções de origem tradicionais, no que resta desta página assume-se a familiaridade com a geração de origem tradicional.
generate.feature@<id função origem> = <id função> [, feature@<id função>]* [, plugin@<id plugin>]* [, exclude@<id plugin>]*
Ao gerar agrupamentos de origem individuais, esta propriedade permanece como anteriormente e suporta os mesmos atributos (por exemplo, versão, descompactar, opcional, etc), a diferença será visível na função de origem resultante. Anteriormente, a função de origem teria incluído um plug-in de origem + um fragmento de origem para cada plataforma a ser construída. No novo formato, a função de origem irá incluir um agrupamento de origem para cada plug-in/fragmento listado na função original.
Os plug-ins incluídos na função de origem através de sintaxe de plugin@ não obterão agrupamentos de origem correspondentes. Este facto é útil para adicionar plug-ins de doc â função de origem.
A entrada exclude@ é nova para a criação de origem individual. Alguns plug-ins que foram incluídos na função que origina ( ou seja, plug-ins de doc ou fragmentos que contêm unicamente código nativo) poderão não possuir origem e devem ser excluídos da função de origem gerada. A entrada exclude@ suporta um novo atributo de versão.
Exemplo:generate.feature@org.eclipse.jdt.source=org.eclipse.jdt, plugin@org.eclipse.jdt.doc.isv;unpack="false",exclude@org.eclipse.jdt.doc.user
No formato antigo, a propriedade generate.plugin gera um plug-in de origem baseado nos conteúdos de uma determinada função. Ao gerar agrupamentos de origem individuais, estas alterações serão baseadas num dado plug-in:
generate.plugin@<id plug-in origem>=<id plug-in>
A propriedade generate.plugin era usada por funções de modo a incluir a origem sem ter uma função de origem (embora nos bastidores tivesse sido gerada uma função completa de origem). Ao gerar agrupamento de origem individual, as funções necessitarão de incluir um agrupamento *.source para cada plug-in bem como uma propriedade generate.plugin correspondente para cada um.
Exemplo: A função sdk.examples usada para ter este aspecto:
<feature id="org.eclipse.sdk.examples" ... > .... <plugin id="org.eclipse.sdk.examples.source" version="0.0.0"/> <plugin id="org.eclipse.sdk.examples.source.win32.win32.x86" version="0.0.0"/> </feature>
generate.plugin@org.eclipse.sdk.examples.source=org.eclipse.sdk.examples
É alterado para:
<feature id="org.eclipse.sdk.examples" ...> ... <plugin id="org.eclipse.compare.examples.source" version="0.0.0"/> <plugin id="org.eclipse.debug.examples.core.source" version="0.0.0"/> <plugin id="org.eclipse.swt.examples.source" version="0.0.0"/> </feature>
generate.plugin@org.eclipse.compare.examples.source=org.eclipse.compare.examples generate.plugin@org.eclipse.debug.examples.core.source=org.eclipse.debug.examples.core generate.plugin@org.eclipse.swt.examples.source=org.eclipse.swt.examples
Os plug-ins específicos podem não necessitar de agrupamentos de origem pois não contém origem. Esta situação poderá ocorrer com fragmentos específicos à plataforma que só contêm uma biblioteca nativa. Nesta caso, os agrupamentos poderão ser excluídos pela função tal como é referido acima em generate.feature.
Ou os agrupamentos poderão especificar explicitamente nos próprios ficheiros build.properties que não deve ser gerado qualquer agrupamento de origem para os mesmos:
generateSourceBundle=false
O conteúdo personalizado pode sempre ser adicionado para gerar agrupamentos de origem com a chamada de retorno personalizada post.gather.source no agrupamento que dá origem. (Consulte o tópico Passos de construção personalizada de funções e plug-ins).
Ao fazê-lo, defina a propriedade "src.additionalRoots" no ficheiro build.properties do plugin para que o agrupamento de origem de criação disponha da directiva raiz correcta no cabeçalho Eclipse-SourceBundle.
Exemplo:
org.junit4 :
build.properties
src.includes = about.html,junitsrc.zip
src.additionalRoots=junitsrc
customBuildCallbacks=customBuildCallbacks.xml
customBuildCallbacks.xml
<target name="post.gather.sources" >
<mkdir dir="${target.folder}/junitsrc"/>
<unzip src="${target.folder}/junitsrc.zip" dest="${target.folder}/junitsrc" overwrite="false"/>
<delete file="${destination.temp.folder}/junitsrc.zip" />
</target>
Anteriormente, o plug-in de origem gerado servia como um plug-in cunhado para a função de origem gerada. Os ficheiros cunhados (about.properties, eclipse32.gif, etc) eram fornecidos com o directório sourceTemplatePlugin na função original.
Ao gerar agrupamentos de origem individual, o plug-in de cunhagem para a função de origem será o agrupamento de origem correspondente ao plug-in de cunhagem original. Significa isto que a cunhagem de ficheiros para o plug-in de cunhagem da função de origem pode receber contribuições usando a propriedade src.includes no plug-in de cunhagem original.
A pasta sourceTemplatePlugin da função para a qual estamos a gerar origem também contribui com ficheiros para o plug-in de cunhagem.
Anteriormente, os conteúdos do directório sourceTemplatePlugin da função original era copiado para o plug-in de origem. Ao gerar agrupamentos de origem individuais, esta situação mantém-se unicamente para o agrupamento de origem de cunhagem (ver acima).
Para todos os outros agrupamentos de origem, os conteúdos de um directório sourceTemplateBundle serão sobrepostos.