Layouten til funksjonsmetadata

PDE Build har alltid brukt funksjoner som en slags grupperingsmekanisme som spesifiserer nøyaktig hva som skal bygges. I p2 har denne tanken om en funksjon som en gruppe blitt utvidet, og dette har ført til at mer enn én enkelt installerbar enhet (IU) blir generert per funksjon.

Fra et byggeperspektiv, leverer en funksjon tre ting:

Når du bruker metadatageneratoren som ble introdusert i 3.4, ender vi opp med følgende funksjonsstruktur "org.example.platform":

org.example.platform.feature.group Dette er funksjonens øverste grupperings-IU, og den vil ha kravene til alle funksjonene og plugin-modulene som ble inkludert og påkrevd av feature.xml. Den inneholder også et krav om den nestede org.example.platform.feature.jar
org.example.platform.feature.jar Dette er IUen som representerer selve jar-filen med funksjoner. Den har et LDAP-filter
"(org.eclipse.update.install.features=true)"
som gjør at jar-filen med funksjoner kun kan installeres hvis profilen definerer den egenskapen. Denne IUen har også et krav om den faktiske artefakten org.example.platform_1.0.0.jar.

Hvis funksjonen ikke definerer "bin.includes" i den tilhørende build.properties-filen, blir ikke denne funksjons-jar-filen med IU ergenerert.

Merk deg at denne IU-strukturen ikke inkluderer noe for rotfilene som leveres av funksjonen. I stedet vil en bygging som bruker de genererte metadataene plassere alle rotfilene i en enkelt IU og artefakt.

p2-publisereren er ny i 3.5. Hvis vi bruker oppgaven eclipse.gatherFeature i PDE Build til å publisere funksjoen fra kilden, får vi i stedet rotfil-IUer som tilsvarer funksjonen som leverte dem. I dette tilfellet, ender vi opp med følgende metadata:

org.example.platform.feature.groupFunksjonens øverste grupperingsnivå med IUer
org.example.platform.feature.jarFunksjons-jar-filen med IU.
org.example.platform_root
org.example.platform_root.<ws>.<os>.<arch>
Dette er rotfil-IUene. Feature.group vil inkludere en rot-IU for hver plattform som funksjonen leverer filer til. Selve rot-IUen har et krav om den faktiske binærartefakten fra et p2-artefaktdatalager (f.eks. binary/org.example.platform_root.gtk.linux.x86_1.0.0) som inneholder filene.

Hvis du bruker den nye p2-publisereren i stedet for den gamle metadatageneratoren, vil du har mye større kontroll over hvordan rotfiler leveres til produkter.