Bestanden toevoegen aan de hoofddirectory van een build

Hoofdbestanden zijn bestanden die in een pakket moeten worden opgenomen bij een Eclipse-installatie maar geen features of plugins zijn. Veelvoorkomende voorbeelden zijn de uitvoerbare bestanden en ini-bestanden van Eclipse, en licentiebestanden.
Hoofdbestanden worden toegevoegd aan een build door features met de juiste hoofdeigenschappen.

Eigenschappen van hoofdbestanden

root
Geef een door komma's gescheiden lijst van bestanden of mappen op om op te nemen in alle configuraties die worden opgebouwd.
Relatieve paden worden opgegeven ten opzichte van het pad voor de feature. Gebruik "file:" om een bestand op te geven en "absolute:" voor een absoluut pad.
Voorbeelden:
  • root=rootfiles: een relatief pad naar een map waarvan de inhoud moet worden opgenomen
  • root=file:license.html,licenses: een relatief pad naar het bestand "license.html" en een relatief pad naar de map "licenses"
  • root=absolute:/eclipse/rootfiles: een absoluut pad naar een map waarvan de inhoud moet worden opgenomen
  • root=absolute:file:/eclipse/about.html,file:lib/*.so*: een absoluut pad voor het opnemen van "about.html", alsmede een relatief pad voor het opnemen van alle *.so* -bestanden onder de map lib.

Elk door komma's gescheiden item wordt een Ant-bestandsgroep. Als het item verwijst naar een map, is die map is de "dir"-parameter van de bestandsgroep en wordt "**" gebruikt als de "includes"-parameter. Als het item een bestand is, wordt de directory die het bestand bevat de "dir"-parameter en wordt het bestand opgegeven in de parameter "includes".

Voor alle relatieve bestanden wordt de eigenschap ${baseDir} gebruikt in de directory. Deze ${baseDir}-eigenschap wordt de hoofddirectory van de feature waar het gegenereerde bestand build.xml komt te staan.

root.<config>
Geef een lijst op van de bestanden en mappen die moeten worden opgenomen voor de aangegeven configuratie. Configuraties zoals u die hier opgeeft, moeten overeenkomen met de configuraties zoals opgegeven voor de buildeigenschap configs. Relatieve paden worden opgegeven ten opzichte van het pad voor de feature. De prefixen "file:" en "absolute:", zoals die worden gebruikt voor de eigenschap "root", zijn ook hier van toepassing.
Voorbeelden:
  • root.win32.win32.x86=rootfiles: een relatief pad naar een map waarvan de inhoud moet worden opgenomen in de configuratie win32.win32.x86
  • root.linux.gtk.x86=absolute:file:about.html: een absoluut pad naar een bestand dat moet worden opgenomen in de configuratie linux.gtk.x86.
root.folder.<submap>

root.<config>.folder.<submap>
Komt overeen met de eigenschappen "root" en "root.<config>", met dit verschil dat bestanden en mappen niet worden gekopieerd naar de hoofddirectory van de Eclipse-installatie maar naar de aangegeven submap.
Relatieve paden worden opgegeven ten opzichte van het pad voor de feature. De prefixen "file:" en "absolute:" zoals die worden gebruikt voor de eigenschap "root", zijn ook hier van toepassing.
Voorbeelden:
  • root.folder.docs/html=html_files: de inhoud van de featuremap "html_files" wordt gekopieerd naar de map docs/html in de Eclipse-installatie.
  • root.linux.gtk.x86.folder.jre=absolute:/build/jres/linux: een absoluut pad, de inhoud van de map /build/jres/linux wordt gekopieerd naar de map jre van de Eclipse-installatie.
Deze eigenschappen worden door PDE/UI gebruikt wanneer een JRE is opgegeven in een bestand .product voor exporteren. PDE/Build ondersteunt momenteel niet het opnemen van een JRE met het bestand .product; deze eigenschappen moeten worden opgegeven in een feature om een JRE op te nemen in een naamloze productbuild.
root.permissions.<machtigingen>

root.<config>.permissions.<machtigingen>
Geef een lijst van bestanden op waarvoor de Ant-taak chmod moet worden uitgevoerd. De waarde van deze eigenschap wordt aan de Ant-taak chmod doorgegeven als "includes"-parameter. Dit betekent dat u gebruik kunt maken van de Ant-jokertekens.
Voorbeelden:
  • root.permissions.755=eclipse: hiermee wordt het bestand 'eclipse' ingesteld met uitvoermachtigingen.
  • root.linux.gtk.x86.permissions.755=lib/**: hiermee worden alle bestanden onder de map lib ingesteld als uitvoerbaar.

Het gedeelte <machtigingen> van de eigenschap wordt doorgegeven aan de Ant-taak chmod als de parameter "perm". Als de indeling van het definitieve archief voor de configuratie antTar is, wordt de indeling van <machtigingen> ook doorgegeven aan een antTar-bestandsgroep als de parameter "filemode". Hetzelfde geldt voor bestandgroepen antZip en zip. De Ant-taak chmod ondersteunt machtigingen zoals "og-rwx" (verhinderen dat niet-eigenaars aan het bestand komen); de bestandsgroepen tar en zip ondersteunen alleen driecijferige octale tekenreeksen.
root.link

root.<config>.link
Geef een lijst op van paren bestanden en mappen (gescheiden door een komma) die symbolisch aan elkaar moeten worden gekoppeld. Het eerste item van een paar is de doellocatie en het tweede item is de naam van de koppeling.
Voorbeeld:
  • root.macosx.carbon.ppc.link=Eclipse.app/Contents/MacOS/eclipse,eclipse: Maak in de configuratie macosx.carbon.ppc een symbolische koppeling in de hoofddirectory met de naam "eclipse" die verwijst naar het bestand "Eclipse.app/Contents/MacOS/eclipse".

Dit resulteert in een Ant-taak exec waardoor een opdracht "ln -sf" wordt uitgevoerd. Aan de hand van de waarde "targetA, nameA, targetB, nameB, targetC, nameC" wordt een aantal "ln"-opdrachten uitgevoerd in de map waarin de Eclipse-hoofdbestanden zijn verzameld:
		ln -sf targetA nameA
ln -sf targetB nameB
ln -sf targetC nameC

Hoofdbestanden opnemen in een productbuild

Wanneer u een .product-bestand gebruikt dat is gebaseerd op features, kunt u eenvoudig hoofdbestanden toevoegen aan het product door bovengenoemde eigenschappen van hoofdbestanden op te geven in een van de opgenomen features.

Het is mogelijk een feature op te nemen met als enige doel het toevoegen van hoofdbestanden. Als voor deze hoofdbestanden-feature geen eigenschap "bin.includes" is opgegeven in zijn bestand build.properties, wordt de feature niet opgenomen in de uiteindelijke buildresultaten, maar worden zijn toegevoegde hoofdbestanden wel opgenomen.

Als een .product-bestand is gebaseerd op plugins in plaats van features is het nog steeds mogelijk hoofdbestanden toe te voegen aan de build. In een productbuild genereert PDE/Build automatisch een containerfeature die alle plugins bevat die zijn opgegeven in het .product-bestand (zie de taak eclipse.generateFeature). Er zijn twee manieren waarop u hoofdbestanden kunt toevoegen aan deze productbuild: