Rotfiler er filer som må pakkes med en Eclipse-installering, men er ikke funksjoner eller plugin-moduler. Vanlige eksempler er Eclipses utførbare filer og INI-filer samt lisensfilene.
Rotfilene bidras til et bygg av funksjoner som inneholder relevante rotegenskaper.
root |
Angir en kommadelt liste over filer eller mapper som skal inkluderes i alle konfigurasjoner som bygges. Relative baner er relative i forhold til innholdsfunksjonen. Bruk "file:" til å spesifisere fil og "absolute:" for å bruke absolutt bane. Eksempler:
Hver kommaatskilte oppføring blir et Ant-filsett. Hvis oppføringen refererer til en mappe, er mappen "dir"-parameteren til filsettet, og en "**" brukes som "includes"-parameter. Hvis oppføringen er en fil, blir innholdskatalogen til filen "-dir"-parameter, og filen spesifiseres i "includes"-parameteren. For alle relative filer brukes egenskapen ${baseDir} i katalogen. Denne ${baseDir}-egenskapen blir funksjonens rotkatalog der den genererte build.xml-filen blir plassert. |
root.<config> |
Angir en liste over filer eller mapper som skal inkluderes for den gitte konfigurasjonen. Konfigurasjoner som spesifiseres her, tilsvarer konfigurasjoner i byggets configs-egenskap.
Relative baner er relative i forhold til innholdsfunksjonen. Samme "file:"- og "absolute:"-prefikser som brukes i "root"-egenskapen, gjelder også her. Eksempler:
|
root.folder.<subfolder> root.<config>.folder.<subfolder> |
Likner på egenskapene "root" og "root.<config>", bortsett fra at filer og mapper i stedet for å bli kopiert til roten for Eclipse-installeringen blir kopiert til den gitte undermappen.
Relative baner er relative i forhold til innholdsfunksjonen. Samme "file:"- og "absolute:"-prefikser som brukes i egenskapen "root", gjelder også her. Eksempler:
|
root.permissions.<rights> root.<config>.permissions.<rights> |
Spesifiserer en liste over filer som Ant-oppgaven chmod skal utføres på. Verdien til denne egenskapen blir sendt til Ant-oppgaven chmod som "includes"-parameteren. Det betyr at Ant-jokertegnmønstre kan brukes. Eksempler:
<rights>-delen av egenskapen sendes faktisk til Ant-oppgaven chmod som "perm"-parameteren. Hvis det endelige arkivformatet for konfigurasjonen er antTar, sendes også <rights>-formatet til et Ant-tarfilsett som parameteren "filemode". Likeledes for antZip og zipfileset. Mens Ant-oppgaven chmod støtter tillatelser som "og-rwx" (gjør ikke-eiere ute av stand til å røre filen), støtter tar- og zip-filsettene bare 3-sifrede oktalstrenger. |
root.link root.<config>.link |
Vis parvis (atskilt med komma) de filene og mappene som må linkes symbolsk. Første oppføring av paret er målet, og andre oppføring er linknavnet. Eksempel:
Dette resulterer i en Ant-exec-oppgave som utfører en "ln -sf"-kommando. Gitt verdien "targetA, nameA, targetB, nameB, targetC, nameC" utføres et sett med "ln"-kommandoer i mappen der Eclipse-rotfilene samles inn: ln -sf targetA nameA ln -sf targetB nameB ln -sf targetC nameC |
Når en .product-fil som bygger på funksjoner, brukes, kan rotfilene legges til i produktet ved ganske enkelt å spesifisere nevnte rotfilegenskaper i en hvilken som helst av de inkluderte funksjonene.
Det er mulig å inkludere en funksjon utelukkende for å bidra med rotfiler. Hvis denne "rootfile"-funksjonen ikke spesifiserer en "bin.includes"-egenskap i sin build.properties-fil, vil den ikke bli inkludert i de endelige byggeresultatene, men de bidratte rotfilene blir det.
Når en .product-fil bygger på plugin-moduler i stedet for funksjoner, kan rotfilene fortsatt legges til i bygget. I et produktbygg genererer PDE/Build automatisk en containerfunksjon som inkluderer alle plugin-moduler spesifisert i .product-filen (se oppgaven eclipse.generateFeature). Det er to måter å legge til rotfiler i dette produktbygget på:
${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/*