Legge til filer i roten for et bygg

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.

Rotfilegenskaper

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:
  • root=rootfiles - En relativ bane til en mappe. Innholdet i mappen blir inkludert.
  • root=file:license.html,licenses - En relativ bane til en "license.html"-fil og en relativ bane til en "licenses"-mappe.
  • root=absolute:/eclipse/rootfiles: En absolutt bane til en mappe. Innholdet i mappen blir inkludert.
  • root=absolute:file:/eclipse/about.html,file:lib/*.so*: En absolutt bane for å inkludere "about.html" og en relativ bane for å inkludere alle *.so*-filer under lib-mappen.

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.win32.win32.x86=rootfiles - En relativ bane til en mappe. Innholdet i mappen blir inkludert i konfigurasjonen win32.win32.x86.
  • root.linux.gtk.x86=absolute:file:about.html - En absolutt bane til en fil som skal inkluderes i konfigurasjonen linux.gtk.x86.
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.folder.docs/html=html_files - Innholdet i funksjonens "html_files"-mappe kopieres til docs/html-mappen i Eclipse-installeringen.
  • root.linux.gtk.x86.folder.jre=absolute:/build/jres/linux - En absolutt bane. Innholdet i mappen /build/jres/linux kopieres til JRE-mappen til Eclipse-installeringen.
Disse egenskapene brukes av PDE/UI når en JRE spesifiseres i en .product-fil for eksport. PDE/Build støtter ikke inkludering av en JRE med .product filen, og disse egenskapene måtte eventuelt spesifiseres i en funksjon for å inkludere en JRE i et headless-produktbygg.
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:
  • root.permissions.755=eclipse - Definerer "eclipse"-filen til å ha utføringstillatelser.
  • root.linux.gtk.x86.permissions.755=lib/** - Definerer alle filer under lib-katalogen til å kunne utføres.

<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:
  • root.macosx.carbon.ppc.link=Eclipse.app/Contents/MacOS/eclipse,eclipse: I konfigurasjonen macosx.carbon.ppc opprettes en softlink i roten kalt "eclipse" som peker på filen "Eclipse.app/Contents/MacOS/eclipse".

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

Inkludere rotfiler i et produktbygg

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å: