Kořenové soubory jsou soubory, které musejí být zabaleny spolu s instalací Eclipse, ale nejsou funkcemi ani moduly plug-in. Běžným příkladem jsou spustitelné soubory eclipse a soubory ini a také soubory licence.
Kořenové soubory jsou k sestavení přidávány funkcemi obsahujícími příslušné kořenové vlastnosti.
root |
Určuje čárkami oddělený seznam souborů nebo složek, které budou zahrnuty do všech sestavovaných konfigurací. Relativní cesty jsou cesty relativní vzhledem k obsažené funkci. Pro určení souboru použijte "file:" a pro určení absolutní cesty použijte "absolute:". Příklady:
Každé čárkami oddělené zadání se stane sadou souborů ant. Pokud zadání odkazuje na složku, pak je složka parametrem "dir" sady souborů a "**" se používá jako parametr "includes". Pokud je zadáním soubor, adresář obsahující soubor se stane parametrem "dir" a soubor je specifikován v parametru "includes". Pro všechny relativní cesty bude v adresáři použita vlastnost ${baseDir}. Tato vlastnosti ${baseDir} bude kořenovým adresářem funkce, kde bude umístěn vygenerovaný soubor build.xml. |
root.<config> |
Určuje seznam souborů nebo složek, které mají být zahrnuty pro danou konfiguraci. Zde specifikované konfigurace by měly odpovídat konfiguracím ve vlastnosti configs pro sestavení.
Relativní cesty jsou cesty relativní vzhledem k obsažené funkci. Stejné prefixy "file:" a "absolute:", které jsou použity ve vlastnosti "root", se používají i zde. Příklady:
|
root.folder.<subfolder> root.<config>.folder.<subfolder> |
Podobně jako vlastnosti "root" a "root.<config>", s tou výjimkou, že místo zkopírování do kořene instalace eclipse jsou soubory a složky zkopírovány do dané podsložky.
Relativní cesty jsou cesty relativní vzhledem k obsažené funkci. Stejné prefixy "file:" a "absolute:", které jsou použity ve vlastnosti "root", se používají i zde. Příklady:
|
root.permissions.<rights> root.<config>.permissions.<rights> |
Určuje seznam souborů, na kterých se má spustit úloha chmod nástroje ant. Hodnota této vlastnosti bude předána do úlohy chmod nástroje ant jako parametr "includes". To znamená, že lze použít šablony se zástupnými znaky ant. Příklady:
Část <rights> vlastnosti se skutečně předává do úlohy chmod nástroje ant jako parametr "perm". Pokud je konečný formát archivu pro konfiguraci antTar, potom se také formát <rights> předává do sady souborů tar nástroje ant jako parametr "filemode". Podobně platí pro antZip a sadu souborů zip. I když úloha chmod nástroje ant podporuje oprávnění jako "og-rwx" (jiný uživatel než vlastník nemůže do souboru zasahovat), sady souborů tar a zip podporují pouze oktalové řetězce se třemi číslicemi. |
root.link root.<config>.link |
Seznam dvojic souborů a složek (oddělených čárkou), které mají být symbolicky propojeny. První položka dvojice je cíl a druhá položka je název odkazu. Příklad:
Výsledkem je úloha exec nástroje ant, která provede příkaz "ln -sf". Po zadání hodnot "cílA, názevA, cílB, názevB, cílC, názevC", bude provedena sada příkazů "ln" ve složce, kde jsou shromážděny kořenové soubory platformy eclipse: ln -sf cílA názevA ln -sf cílB názevB ln -sf cílC názevC |
Při použití souboru .product založeném na funkcích lze kořenové soubory k produktu přidat jednoduše zadáním výše uvedených vlastností kořenových souborů do libovolné zahrnuté funkce.
Je možné zahrnout funkci pouze pro účely přidání kořenových souborů. Pokud tato funkce "kořenového souboru" nespecifikuje ve svém souboru build.properties vlastnost "bin.includes", pak nebude zahrnuta do konečného výsledku sestavení, ale přidané kořenové soubory ano.
Když je soubor .product založen na modulech plug-in místo na funkcích, kořenové soubory lze i tak přidat k sestavení. V sestavení produktu PDE/Build automaticky vygeneruje funkci kontejneru, která zahrnuje všechny moduly plug-in specifikované v souboru .product (Viz úloha eclipse.generateFeature). Existují dva způsoby, jak přidat kořenové soubory k tomuto sestavení produktu:
${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/*