Les fichiers racine sont des fichiers qui doivent être mis en forme via une installation Eclipse, mais il ne s'agit ni de dispositifs ni de plug-in. Des exemples courants sont les fichiers exécutables et ini, ainsi que les fichiers de licence d'Eclipse.
Les fichiers racine sont ajoutés à une génération par des dispositifs contenant les propriétés racine appropriées.
root |
Spécifiez une liste de fichiers ou de dossiers séparés par des virgules à inclure dans toutes les configurations en cours de génération. Les chemins relatifs se rapportent au dispositif conteneur. Utilisez "file:" pour spécifier un fichier et "absolute:" pour utiliser un chemin absolu. Exemples :
Chaque entrée séparée par une virgule devient un jeu de fichiers Ant. Si l'entrée fait référence à un dossier, alors ce dossier est le paramètre "dir" du jeu de fichiers et un signe "**" est utilisé en guise de paramètre "includes". Si l'entrée est un fichier, alors le répertoire conteneur du fichier devient le paramètre "dir" et le fichier est spécifié dans le paramètre "includes". Pour tous les fichiers relatifs, la propriété ${baseDir} sera utilisée dans le répertoire. Cette propriété ${baseDir} sera le répertoire racine du dispositif dans lequel se trouvera le fichier build.xml généré. |
root.<config> |
Spécifiez une liste de fichiers ou de dossiers à inclure pour la configuration donnée. Les configurations spécifiées ici doivent correspondre à celles qu'inclut la propriété configs de la génération.
Les chemins relatifs se rapportent au dispositif conteneur. Les préfixes "file:" et "absolute:" utilisés dans la propriété "root" s'appliquent également ici. Exemples :
|
root.folder.<sous-dossier> root.<config>.folder.<sous-dossier> |
Similaire aux propriétés "root" et "root.<config>", excepté le fait qu'au lieu d'être copiés dans la racine de l'installation Eclipse, les fichiers et les dossiers sont copiés dans le sous-dossier spécifié.
Les chemins relatifs se rapportent au dispositif conteneur. Les préfixes "file:" et "absolute:" utilisés dans la propriété "root" s'appliquent également ici. Exemples :
|
root.permissions.<droits> root.<config>.permissions.<droits> |
Spécifiez une liste de fichiers sur lesquels exécuter la tâche chmod Ant. La valeur de cette propriété sera transmise à la tâche chmod Ant en tant que paramètre "includes". Cela signifie que des masques génériques Ant peuvent être utilisés. Exemples :
En fait, la partie <droits> de la propriété est transmise à la tâche chmod Ant en tant que paramètre "perm". Si le format de l'archive finale de la configuration est antTar, le format <droits> est également transmis à un objet Ant tarfileset en tant que paramètre "filemode". Il en va de même pour antZip et zipfileset. Bien que la tâche chmod Ant prenne en charge les autorisations telles que "og-rwx" (empêche les utilisateurs qui ne sont pas propriétaires de toucher au fichier), les jeux de fichiers tar et zip ne prennent en charge que les chaînes octales à 3 chiffres. |
root.link root.<config>.link |
Répertorie par paires (séparées par une virgule) les fichiers et les dossiers devant être liés de manière symbolique. La première entrée de la paire est la cible et la deuxième, le nom du lien. Exemples :
Cela se traduit par une tâche exec Ant qui exécute une commande "ln -sf". Pour une valeur "targetA, nameA, targetB, nameB, targetC, nameC", un ensemble de commandes "ln" seront exécutées dans le dossier où les fichiers racine Eclipse sont collectés : ln -sf targetA nameA ln -sf targetB nameB ln -sf targetC nameC |
Lors de l'utilisation d'un fichier .product basé sur des dispositifs, vous pouvez ajouter les fichiers racine au produit en spécifiant les propriétés de fichier racine ci-dessus dans l'un des dispositifs inclus.
Il est possible d'inclure un dispositif uniquement dans le but d'ajouter des fichiers racine. Si ce dispositif "rootfile" ne spécifie pas de propriété "bin.includes" dans son fichier build.properties, il ne sera pas inclus dans les résultats finaux de la génération, mais ses fichiers racine ajoutés le seront.
Lorsqu'un fichier .product est basé sur des plug-in et non sur des dispositifs, les fichiers racine peuvent néanmoins être ajoutés à la génération. Dans une génération de produit, PDE/Build génère automatiquement un dispositif conteneur qui contient tous les plug-ins spécifiés dans le fichier .product (consultez la tâche eclipse.generateFeature). Il existe deux façons d'ajouter des fichiers racine à cette génération de produit :
${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/*