Layout dos Metadados do Recurso

O PDE Build sempre utilizou recurso como um tipo de mecanismo de agrupamento que especifica o que exatamente deve ser construído. Com o p2, essa ideia de um recurso como um grupo foi estendida, resultando em mais do que uma única unidade instalável (IU) sendo gerada por recurso.

Da perspectiva de construção, um recurso contribui com três coisas:

Ao utilizar o gerador de metadados introduzido no release 3.4, terminamos com a seguinte estrutura para o recurso "org.example.platform":

org.example.platform.feature.group Esta é uma UI de agrupamento de nível superior; terá requisitos sobre todos os recursos e plug-ins incluídos e exigidos por feature.xml. Também incluirá um requisito sobre o org.example.platform.feature.jar aninhado
org.example.platform.feature.jar Esta é a IU que representa o jar do recurso em si. Possui um filtro LDAP
"(org.eclipse.update.install.features=true)"
que faz com que o jar do recurso seja instalado apenas se o perfil definir essa propriedade. Essa IU também possui um requisito sobre o artefato real org.example.platform_1.0.0.jar real.

Se o recurso não definir "bin.includes" em seu arquivo build.properties, então essa IU do jar de recurso não será gerada.

Observe que a estrutura dessa IU não inclui nada dos arquivos raiz contribuídos pelo recurso. Ao invés disso, uma construção usando a geração de metadados colocou todos os arquivos raiz juntos em uma única IU e artefato.

Novo no 3.5, é o publicador do p2. Se utilizarmos a tarefa eclipse.gatherFeature do PDE Build para publicar o recurso a partir da origem, ao invés disso teremos as IUs do arquivo raiz que correspondem ao recurso que as forneceu. Nesse caso, acabamos com os metadados da seguinte forma:

org.example.platform.feature.groupA IU de agrupamento de nível superior para o recurso
org.example.platform.feature.jarA IU do jar do recurso.
org.example.platform_root
org.example.platform_root.<ws>.<os>.<arch>
Essas são as IUs do arquivo raiz. O feature.group incluirá uma IU raiz por plataforma para a qual o recurso fornece os arquivos. A IU raiz em si possui um requisito sobre o artefato binário real a partir do repositório de artefatos do p2 (por exemplo, binary/org.example.platform_root.gtk.linux.x86_1.0.0) que contém os arquivos.

O uso do novo publicador do p2 ao invés do antigo gerador de metadados permite um controle de granularidade muito mais sensível sobre como os arquivos raiz são entregues para produtos.