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.
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:
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.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.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:
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:
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 |
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:
${buildDirectory}/features/org.foo.rootfile.feature/rootfiles/*
/build.properties : root = rootfiles
${buildDirectory}/build.properties: featureList = org.foo.rootfile.feature
${buildDirectory}/build.properties: generatedBuildProperties = ${buildDirectory}/root.properties
${buildDirectory/root.properties: root = absolute:${buildDirectory}/rootfiles
${buildDirectory}/rootfiles/*