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