I file root sono file che devono essere inclusi nel package di un'installazione Eclipse ma non sono funzioni o plug-in. Esempi comuni sono i file eseguibili ed ini di eclipse, come anche i file di licenza.
I file root vengono aggiunti ad una creazione tramite funzioni che contengono le propriet� root appropriate.
root |
Specifica un elenco separato da virgole di file o cartelle che devono essere inclusi in tutte le configurazioni in fase di creazione. I percorsi relativi sono relativi alla funzione contenuta. Utilizzare "file:" per specificare un file e "absolute:" per utilizzare un percorso assoluto. Esempi:
Ogni voce separata da virgola diventa un fileset ant. Se la voce fa riferimento ad una cartella, la cartella � il parametro "dir" del fileset e viene utilizzato un "**" come parametro "includes". Se la voce � un file, la directory che contiene il file diviene il parametro "dir" ed il file viene specificato nel parametro "includes". Per tutti i file relativi, verr� utilizzata la propriet� ${baseDir} nella directory. La propriet� ${baseDir} sar� la directory root della funzione in cui verr� collocato il file build.xml creato. |
root.<config> |
Specifica un elenco di file o cartelle che devono essere inclusi per la configurazione specificata. Le configurazioni specificate qui devono
corrispondere alle configurazioni nella propriet� configs per la creazione.
I percorsi relativi sono relativi alla funzione contenuta. Anche qui vengono applicati gli stessi prefissi "file:" e "absolute:" utilizzati nella propriet� "root". Esempi:
|
root.folder.<subfolder> root.<config>.folder.<subfolder> |
Simili alle propriet� "root" e "root.<config>", tranne che invece di essere copiati nella root dell'installazione eclipse i file e le cartelle vengono copiati nella sottocartella specificata.
I percorsi relativi sono relativi alla funzione contenuta. Anche qui vengono applicati gli stessi prefissi "file:" e "absolute:" utilizzati nella propriet� "root". Esempi:
|
root.permissions.<rights> root.<config>.permissions.<rights> |
Specifica un elenco di file su cui eseguire l'attivit� ant chmod. Il valore di questa propriet� verr� trasmesso all'attivit� ant chmod come parametro "includes". Questo significa che i modelli di caratteri jolly ant possono essere utilizzati. Esempi:
La parte <rights> della propriet� viene in realt� trasmessa all'attivit� ant chmod come parametro "perm". Se il formato finale di archivio per la configurazione � antTar, il formato <rights> viene trasmesso anche ad un'attivit� ant tarfileset come parametro "filemode". Vale lo stesso per antZip e zipfileset. Mentre l'attivit� ant chmod supporta autorizzazioni come "og-rwx" (rendendo impossibile ai non proprietari toccare il file), i fileset tar e zip supportano solo stringhe ottali a 3 cifre. |
root.link root.<config>.link |
Elenca a coppie (separate da virgola) i file e le cartelle che devono essere collegati simbolicamente. La prima voce della coppia � la destinazione e la seconda � il nome del collegamento. Esempio:
Questo comporta un'attivit� ant exec che esegue un comando "ln -sf". Con un valore "targetA, nameA, targetB, nameB, targetC, nameC", un insieme di comandi "ln" verr� eseguito nella cartella in cui sono raccolti i file root eclipse: ln -sf targetA nameA ln -sf targetB nameB ln -sf targetC nameC |
Quando si utilizza un file .product basato sulle funzioni, i file root possono essere aggiunti al prodotto semplicemente specificando le propriet� file root, descritte prima, in qualsiasi funzione inclusa.
� possibile includere una funzione unicamente allo scopo di aggiungere file root. Se la funzione "rootfile" non specifica una propriet� "bin.includes" nel relativo file build.properties, non verr� inclusa nei risultati finali della creazione ma lo saranno i file root aggiunti.
Quando un file .product � basato sui plug-in invece che sulle funzioni, i file root possono comunque essere aggiunti alla creazione. In una creazione di prodotto, PDE/Build genera automaticamente una funzione contenitore che include tutti i plug-in specificati nel file .product astratto (consultare l'attivit� eclipse.generateFeature). Esistono due modi per aggiungere file root alla creazione di questo prodotto:
${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/*