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.
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:
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.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.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:
<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:
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 |
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:
${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/*