Tilføj filer til roden af et byg

Rodfiler er filer, der skal pakkes i en Eclipse-installation, men som ikke er funktioner eller plugins. Typiske eksempler er Eclipse-programfiler og ini-filer samt licensfiler.
Rodfiler leveres til et byg af funktioner, der indeholder de relevante rodegenskaber.

Egenskaber for rodfiler

root
Angiv en kommasepareret liste med filer eller foldere, der skal inkluderes i alle konfigurationer, der bygges.
Relative stier er relative i forhold til den funktion, der indeholder elementerne. Brug "file:" til at angive en fil og "absolute:" for at bruge en absolut sti.
Eksempler:
  • root=rootfiles: En relativ sti til en folder inklusive indholdet af folderen
  • root=file:license.html,licenses: En relativ sti til filen "license.html" og en relativ sti til folderen "licenses"
  • root=absolute:/eclipse/rootfiles: En absolut sti til en folder inklusive indholdet af folderen
  • root=absolute:file:/eclipse/about.html,file:lib/*.so*: En absolut sti, der skal inkludere "about.html" samt en relativ sti, der skal inkludere alle *.so*-filerne under lib-folderen.

Hver kommasepareret indgang bliver et ant-filsæt. Hvis indgangen refererer til en folder, er folderen "dir"-parameter for filsættet, og "**" bruges som "includes"-parameteren. Hvis indgangen er en fil, bliver det bibliotek, der indeholder filen, "dir"-parameteren, og filen angives i "includes"-parameteren.

For alle relative filer bruges egenskaben ${baseDir} i biblioteket. Denne ${baseDir}-egenskab vil blive funktionens rodbibliotek, hvor den genererede build.xml-fil placeres.

root.<konfig>
Angiv en liste med filer eller foldere, der skal inkluderes i den givne konfiguration. Konfigurationer, der angives her, skal svare til konfigurationer i egenskaben configs for bygningen. Relative stier er relative i forhold til den funktion, der indeholder elementerne. Her gælder samme "file:"- og "absolute:"-præfikser, som bruges i "root"-egenskaben.
Eksempler:
  • root.win32.win32.x86=rootfiles: En relativ sti til en folder, indholdet af folderen inkluderes i win32.win32.x86-konfigurationen
  • root.linux.gtk.x86=absolute:file:about.html: En absolut sti til en fil, der skal inkluderes i linux.gtk.x86-konfigurationen.
root.folder.<underfolder>

root.<konfig>.folder.<underfolder>
Ligner egenskaberne "root" og "root.<konfig>", men i stedet for at blive kopieret til roden af Eclipse-installationen kopieres filer og foldere til den angivne underfolder.
Relative stier er relative i forhold til den funktion, der indeholder elementerne. Her gælder samme "file:"- og "absolute:"-præfikser, som bruges i "root"-egenskaben.
Eksempler:
  • root.folder.docs/html=html_files: Indholdet af funktionens "html_files"-folder kopieres til docs/html-folderen i Eclipse-installationen.
  • root.linux.gtk.x86.folder.jre=absolute:/build/jres/linux: En absolut sti, indholdet af /build/jres/linux-folderen kopieres til jre-folderen i Eclipse-installationen.
Disse egenskaber bruges af PDE/UI, når en JRE angives i en .product-fil til eksport. PDE/Build understøtter ikke i øjeblikket, at en JRE inkluderes ved hjælp af .product-filen, og det ville være nødvendigt at angive disse egenskaber i en funktion for at inkludere en JRE i en hovedløst produktbygning.
root.permissions.<rettigheder>

root.<konfig>.permissions.<rettigheder>
Angiv en liste med filer, som ant chmod-opgaven skal udføres på. Værdien af denne egenskab overføres til ant chmod-opgaven som parameteren "includes". Det betyder, at der kan bruges ant-mønstre med jokertegn.
Eksempler:
  • root.permissions.755=eclipse: Angiv, at filen 'eclipse' skal have tilladelserne Eksekvérbar.
  • root.linux.gtk.x86.permissions.755=lib/**: Angiv, at alle filer i biblioteket lib skal være eksekvérbare.

<rettigheder>-delen af egenskaben overføres i virkeligheden til ant chmod-opgaven som parameteren "perm". Hvis det endelige arkivformat for konfigurationen er antTar, overføres <rettigheder>-formatet også til en ant tarfileset-angivelse som parameteren "filemode". Det samme gælder for antZip og zipfileset. Ant chmod-opgaven understøtter tilladelser som f.eks. "og-rwx" (andre end ejeren må ikke røre filen), hvorimod tarfileset og zipfileset kun understøtter oktale strenge på 3 cifre.
root.link

root.<konfig>.link
Opstil parvist (adskilt med komma) de filer og foldere, der skal oprettes en symbolsk henvisning til. Den første indgang i parret er målet, og den anden indgang er navnet på henvisningen.
Eksempel:
  • root.macosx.carbon.ppc.link=Eclipse.app/Contents/MacOS/eclipse,eclipse: Opret en symbolsk henvisning ved navn "eclipse" i roden af macosx.carbon.ppc-konfigurationen, som peger på filen "Eclipse.app/Contents/MacOS/eclipse".

Det resulterer i en ant exec-opgave, som udfører kommandoen "ln -sf". Med værdierne "målA, navnA, målB, navnB, målC, navnC" udføres et sæt "ln"-kommandoer i den folder, hvor Eclipse-rodfilerne er samlet:
		ln -sf målA navnA
ln -sf målB navnB
ln -sf målC navnC

Inkludér rodfiler i et produktbyg

Når der bruges en .product-fil baseret på funktioner, kan rodfilerne tilføjes til produktet, blot ved at ovenstående rootfile-egenskaber angives i en af de inkluderede funktioner.

Det er muligt at inkludere en funktion udelukkende med det formål at bidrage med rodfiler. Hvis egenskaben "bin.includes" ikke angives i denne "rodfil"-funktions build.properties-fil, vil funktionen ikke blive inkluderet i det endelige byggeresultat, men dens bidragsrodfiler vil.

Det er også muligt at tilføje rodfiler til bygget, når en .product-fil er baseret på plugins i stedet for funktioner. I et produktbyg inkluderer PDE/Build automatisk en opbevaringsstedsfunktion, som inkluderer alle de plugins, der er angivet i .product-filen (se opgaven eclipse.generateFeature). Der kan tilføjes rodfiler til dette produktbyg på to måder: