Dodawanie plików do katalogu głównego budowania

Pliki główne to pliki, które muszą zostać umieszczone w pakiecie instalacji środowiska Eclipse, ale nie są składnikami ani wtyczkami. Typowymi przykładami plików głównych są pliki wykonywalne i pliki ini środowiska Eclipse, a także pliki licencji.
Pliki główne są wnoszone do kompilacji przez składniki zawierające odpowiednie właściwości główne.

Właściwości pliku głównego

root
Określa rozdzielaną przecinkami listę plików lub folderów, które mają zostać uwzględnione we wszystkich budowanych konfiguracji.
Ścieżki względne są względne wobec zawierającego składnika. Aby określić plik, należy użyć elementu "file:", natomiast w celu użycia pełnej ścieżki należy użyć elementu "absolute:".
Przykłady:
  • root=rootfiles: Ścieżka względna do folderu (zawartość folderu jest dołączana)
  • root=file:licence.html,licenses: Ścieżka względna do pliku licence.html i folderu licenses
  • root=absolute:/eclipse/rootfiles: Pełna ścieżka do folderu (zawartość folderu jest dołączana)
  • root=absolute:file:/eclipse/about.html,file:lib/*.so*: Pełna ścieżka uwzględniająca plik "about.html", a także ścieżka względna uwzględniająca wszystkie pliki *.so* znajdujące się w folderze lib.

Każdy pozycja rozdzielona przecinkami staje się zbiorem plików Ant. Jeśli pozycja odwołuje się do folderu, folder jest parametrem dir zestawu plików, a jako parametr includes używana jest wartość **. Jeśli pozycja jest plikiem, to katalog zawierający plik staje się parametrem dir, a w parametrze includes określany jest plik.

W przypadku wszystkich plików o dostępie pośrednim w katalogu zostanie użyta właściwość ${baseDir}. Ta właściwość ${baseDir} to katalog główny składnika, w którym będzie znajdował się wygenerowany plik build.xml.

root.<konfiguracja>
Określa listę plików lub folderów, które mają zostać uwzględnione w danej konfiguracji. Konfiguracje określone w tym miejscu powinny odpowiadać konfiguracjom właściwości configs budowania. Ścieżki względne są względne wobec zawierającego składnika. Dla tej właściwości można używać tych samych przedrostków file: i absolute:, co w przypadku właściwości root.
Przykłady:
  • root.win32.win32.x86=rootfiles: Ścieżka względna do folderu. Zawartość folderu jest dołączana do konfiguracji win32.win32.x86
  • root.linux.gtk.x86=absolute:file:about.html: Pełna ścieżka do pliku, który zostanie dołączony do konfiguracji linux.gtk.x86
root.folder.<podfolder>

root.<konfiguracja>.folder.<podfolder>
Podobne do właściwości "root" i "root.<konfiguracja>". Różnica jest taka, że pliki i foldery są kopiowane do danego podfolderu zamiast do katalogu głównego instalacji środowiska Eclipse.
Ścieżki względne są względne wobec zawierającego składnika. Dla tej właściwości można używać tych samych przedrostków file: i absolute:, co w przypadku właściwości root.
Przykłady:
  • root.folder.docs/html=html_files: Zawartość folderu "html_files" składnika jest kopiowana do folderu docs/html instalacji środowiska Eclipse
  • root.linux.gtk.x86.folder.jre=absolute:/build/jres/linux: Pełna ścieżka. Zawartość folderu /build/jres/linux jest kopiowana do folderu jre instalacji środowiska Eclipse
Te właściwości są używane przez komponent PDE/UI, jeśli środowisko JRE określono w pliku .product do wyeksportowania. Komponent PDE/Build obecnie nie obsługuje włączania środowiska JRE przy użyciu pliku .product, więc w celu włączenia środowiska JRE w nienadzorowanym budowaniu produktu właściwości te należy określić w składniku.
root.permissions.<uprawnienia>

root.<konfiguracja>.permissions.<uprawnienia>
Służy do określania listy plików, w przypadku których ma zostać uruchomione zadanie ant chmod. Wartość tej właściwości zostanie przekazana do zadania ant chmod jako parametr "includes". Oznacza to, że istnieje możliwość użycia wzorców znaków wieloznacznych ant.
Przykłady:
  • root.permissions.755=eclipse: Ustawia uprawnienia do wykonywania dla pliku eclipse.
  • root.linux.gtk.x86.permissions.755=lib/**: Ustawia uprawnienia do wykonywania dla wszystkich plików z katalogu lib.

Część <uprawnienia> właściwości jest przekazywana do zadania ant chmod jako parametr "perm". Jeśli końcowym formatem archiwum dla konfiguracji jest antTar, to format <uprawnienia> jest także przekazywany do zestawu plików tarfileset ant jako parametr "filemode". Podobna sytuacja ma miejsce w przypadku formatów antZip i zipfileset. Choć zadanie ant chmod obsługuje uprawnienia takie jak "og-rwx" (uniemożliwia użytkownikom innym niż właściciel wykonanie żadnej czynności), to zestawy plików tar i zip obsługują tylko trzycyfrowe łańcuchy znaków ósemkowych.
root.link

root.<konfiguracja>.link
Służy do określania listy par (rozdzielonych przecinkami) plików i folderów, które należy połączyć dowiązaniami symbolicznymi. Pierwsza pozycja pary jest elementem docelowym, a druga nazwą dowiązania.
Przykład:
  • root.macosx.carbon.ppc.link=Eclipse.app/Contents/MacOS/eclipse,eclipse: W konfiguracji macosx.carbon.ppc tworzone jest dowiązanie miękkie w katalogu głównym o nazwie "eclipse", które wskazuje plik "Eclipse.app/Contents/MacOS/eclipse".

Wynikiem jest zadanie ant exec uruchamiające komendę "ln -sf". Po podaniu zmiennych "element_docelowy_A, nazwa_A, element_docelowy_B, nazwa_B, element_docelowy_C, nazwa_C" zostanie wykonany zestaw komend "ln" w folderze, w którym znajdują się pliki główne środowiska Eclipse:
		ln -sf element_docelowy_A nazwa_A
ln -sf element_docelowy_B nazwa_B
ln -sf element_docelowy_C nazwa_C

Dołączanie plików głównych do kompilacji produktu

W przypadku używania pliku .product opartego na składnikach pliki główne mogą zostać dodane do produktu po prostu przez określenie powyższe właściwości plików głównych w dowolnym z dołączonych składników.

Istnieje możliwość włączenia składnika wyłączenia w celu udostępnienia plików głównych. Jeśli dla tego składnika plików głównych nie określono właściwości bin.includes w pliku build.properties, nie zostanie on uwzględniony w końcowych wynikach kompilacji, w przeciwieństwie do udostępnionych plików głównych.

Jeśli plik .product jest oparty na wtyczkach, a nie na składnikach, pliki główne nadal można dodać do kompilacji. Podczas budowania produktu komponent PDE/Build automatycznie generuje składnik kontenera zawierający wszystkie wtyczki określone w pliku .product (więcej informacji można znaleźć w opisie zadania eclipse.generateFeature). Istnieją dwa sposoby dodawania plików głównych do kompilacji produktu: