Přidání souborů do kořene sestavení

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.

Vlastnosti kořenového souboru

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:
  • root=rootfiles: Relativní cesta ke složce, obsah složky je zahrnut.
  • root=file:license.html,licenses: Relativní cesta k souboru "license.html" a relativní cesta ke složce "licenses".
  • root=absolute:/eclipse/rootfiles: Absolutní cesta ke složce, obsah složky je zahrnut.
  • root=absolute:file:/eclipse/about.html,file:lib/*.so*: Absolutní cesta pro zahrnutí "about.html" a také absolutní cesta pro zahrnutí všech souborů *.so* ve složce lib.

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.win32.win32.x86=rootfiles: Relativní cesta ke složce, obsah složky je zahrnut do konfigurace win32.win32.x86
  • root.linux.gtk.x86=absolute:file:about.html: Absolutní cesta k souboru, který má být zahrnut do konfigurace linux.gtk.x86.
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.folder.docs/html=html_files: Obsah složky funkce "html_files" se zkopíruje do složky docs/html v instalaci eclipse.
  • root.linux.gtk.x86.folder.jre=absolute:/build/jres/linux: Absolutní cesta, obsah složky /build/jres/linux se zkopíruje do složky jre instalace eclipse.
Tyto vlastnosti PDE/UI používá, když je JRE zadán v souboru .product pro export. PDE/Build v současné době nepodporuje zahrnutí JRE pomocí souboru .product a tyto vlastnosti nebude nutné zadávat pro zahrnutí JRE do sestavení produktu bez hlavičky.
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:
  • root.permissions.755=eclipse: Nastaví soubor 'eclipse' tak, aby měl spustitelná oprávnění.
  • root.linux.gtk.x86.permissions.755=lib/**: Nastaví všechny soubory v adresáři lib jako spustitelné.

Čá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:
  • root.macosx.carbon.ppc.link=Eclipse.app/Contents/MacOS/eclipse,eclipse: V konfiguraci macosx.carbon.ppc vytvořit symbolický odkaz v kořeni s názvem "eclipse", který ukazuje na soubor "Eclipse.app/Contents/MacOS/eclipse".

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

Zahrnutí kořenových souborů do sestavení produktu

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: