Pacotes Configuráveis de Origem Individuais

O formato tradicional de pacotes configuráveis de origem no Eclipse era uma pasta contendo src.zips para todos os plug-ins incluídos em um determinado recurso. A partir da 3.4, o Eclipse é enviado com pacotes configuráveis de origem individuais. Para cada pacote configurável há um pacote configurável de origem correspondente que é um jar que contém a origem desse pacote configurável. Isso permite entrega de origem mais flexível e também minimiza os problemas de comprimento de caminho que podem surgir em algumas plataformas.

Eclipse-SourceBundle

Um pacote configurável é identificado pelo presença do cabeçalho do Eclipse-SourceBundle em seu manifesto. O formato desse cabeçalho é:

Eclipse-SourceBundle: <bundle-id>;version=<version>;roots:="root1, root2"

O id e a versão do pacote configurável indicam o pacote configurável ao qual o código-fonte incluído corresponde. A diretiva de raízes indica as pastas dentro do pacote configurável de origem que realmente contêm o código-fonte. Se nenhuma diretiva de raízes for especificada, o valor "." será assumido.

As bibliotecas do arquivo de classe são mapeadas para locais de origem de maneira previsível. A raiz do plug-in mapeia para a raiz do pacote configurável de origem. Esse é o caso principal da maioria dos plug-ins em formato .jar. Se o plug-in contiver bibliotecas adicionais "foo/lib.jar", a origem esperada estará nas pastas "foo/libsrc/" correspondentes nos pacotes configuráveis da origem.

Gerando Pacotes Configuráveis de Origem Individuais

O PDE/Build pode gerar automaticamente os pacotes configuráveis de origem individuais, mas apenas em um build sem periféricos. A geração de pacote configurável de origem individual pode ser ativada ao especificar:

individualSourceBundles=true

Isso deve ser especificado no arquivo build.properties do nível superior de configuração do build e controla toda a geração da origem para esse build. Consulte Gerando Recursos e Plug-ins de Origem para obter detalhes sobre a geração de plug-ins e recursos de origem tradicionais, o restante dessa página assume a familiaridade com a geração de origem tradicional.

generate.feature

em um arquivo build.properties do recurso, a propriedade generate.feature informa ao pde.build que gere um recurso de origem.
generate.feature@<source feature id> = <feature id> [, feature@<feature id>]* [, plugin@<plugin id>]* [, exclude@<plugin id>]*

Ao gerar pacotes configuráveis de origem individuais, essa propriedade permanece como antes e suporta os mesmos atributos (por exemplo, version, unpack, optional, etc.); a diferença será notada no recurso de origem resultante. Antes, o recurso de origem teria incluído 1 plug-in + um fragmento de origem para cada plataforma sendo construída. No novo formato, o recurso de origem incluirá um pacote configurável para cada plug-in/fragmento listado no recurso original.

Os plug-ins incluídos no recurso de origem por meio da sintaxe plugin@ não obterá pacotes configuráveis de origem correspondentes. Isso é útil para incluir plug-ins doc no recurso de origem.

A entrada exclude@ é nova para a geração de origem individual. Alguns plug-ins que foram incluídos no recurso de origem (isto é, plug-ins doc ou fragmentos que contêm apenas o código nativo) podem não ter origem e devem ser excluídos do recurso de origem gerado. A entrada exclude@ suporta um atributo version.

Exemplo:
generate.feature@org.eclipse.jdt.source=org.eclipse.jdt, plugin@org.eclipse.jdt.doc.isv;unpack="false",exclude@org.eclipse.jdt.doc.user

generate.plugin

No formato antigo, a propriedade generate.plugin gera um plug-in de origem com base no conteúdo de um determinado recurso. Ao gerar pacotes configuráveis de origem individuais, essas alterações devem ser baseadas em um determinado plug-in:

generate.plugin@<source plug-in id>=<plug-in id>

A propriedade generate.plugin foi utilizada por recursos para incluir a origem sem ter um recurso de origem (ainda que, nos bastidores, um recurso de origem inteiro tenha sido gerado). Ao gerar um pacote configurável de origem individual, os recursos precisarão incluir um pacote configurável *.source para cada plug-in juntamente com uma propriedade generate.plugin correspondente para cada um.

Exemplo: O recurso sdk.examples utilizado para procura como este:

   	<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

Muda 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

generateSourceBundle

Os plug-ins específicos podem não requerer pacotes configuráveis de origem porque eles não contêm de fato a origem. Isso pode ocorrer com fragmentos específicos da plataforma que só contém uma biblioteca nativa. Nesse caso, os pacotes configuráveis podem ser excluídos pelo recurso conforme explicado acima em generate.feature.

Ou os pacotes configuráveis podem especificar explicitamente em seu próprio arquivo build.properties que nenhum pacote configurável de origem deve ser gerado para eles:

generateSourceBundle=false

Conteúdo Customizado

O conteúdo customizado pode ser sempre incluído em pacotes configuráveis de origem gerados utilizando o retorno de chamada customizado post.gather.source no pacote configurável de origem. (Consulte Etapas de Construção Customizada de Recurso e Plug-in).

Ao fazer isso, defina a propriedade "src.additionalRoots" no arquivo build.properties do plug-in para que o pacote configurável de origem de geração tenha a diretiva de raízes correta 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>

Marcando o Recurso de Origem

Anteriormente, o plug-in de origem gerado atendido como um plug-in de marcação para o recurso de origem gerado. Os arquivos de marcação (about.properties, eclipse32.gif, etc) foram fornecidos utilizando o diretório sourceTemplatePlugin no recurso original.

Ao gerar pacotes configuráveis de origem individuais, o plug-in de marcação para o recurso de origem será o pacote configurável de origem correspondente ao plug-in de marcação original. Isso significa que os arquivos de marcação para o plug-in de marcação do recurso de origem pode ser fornecido utilizando a propriedade src.includes no plug-in de marcação original.

A pasta sourceTemplatePlugin do recurso para o qual estamos gerando origem também fornece arquivos para o plug-in de marcação.

sourceTemplatePlugin vs sourceTemplateBundle

Anteriormente, o conteúdo do diretório sourceTemplatePlugin do recurso original foi copiado para o plug-in de origem. Ao gerar pacotes configuráveis de origem individuais, isso permanece como verdadeiro apenas para o pacote configurável de origem de marcação (consulte acima).

Para todos os outros pacotes configuráveis de origem, o conteúdo de um diretóriosourceTemplateBundle será copiado por cima.