Ajout de fichiers à la racine d'une génération

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.

Propriétés des fichiers racine

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 :
  • root=rootfiles : Un chemin relatif d'accès à un dossier ; le contenu du dossier est inclus.
  • root=file:license.html,licenses : Un chemin relatif d'accès à un fichier "license.html" et un chemin relatif d'accès à un dossier "licenses".
  • root=absolute:/eclipse/rootfiles : Un chemin absolu d'un dossier ; le contenu du dossier est inclus.
  • root=absolute:file:/eclipse/about.html,file:lib/*.so* : Un chemin absolu pour inclure "about.html" et un chemin relatif pour inclure tous les fichiers *.so* sous le dossier lib.

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.win32.win32.x86=rootfiles : Un chemin relatif d'accès à un dossier ; le contenu du dossier est inclus dans la configuration win32.win32.x86.
  • root.linux.gtk.x86=absolute:file:about.html : Un chemin absolu d'un fichier à inclure dans la configuration linux.gtk.x86.
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.folder.docs/html=html_files : Le contenu du dossier "html_files" du dispositif est copié dans le dossier docs/html de l'installation Eclipse.
  • root.linux.gtk.x86.folder.jre=absolute:/build/jres/linux : Un chemin absolu ; le contenu du dossier /build/jres/linux est copié dans le dossier jre de l'installation Eclise.
Ces propriétés sont utilisées par PDE/UI lorsqu'un environnement d'exécution Java (JRE) est spécifié dans un fichier .product pour être exporté. Actuellement, PDE/Build ne prend pas en charge l'inclusion d'un environnement JRE dans le fichier .product ; ces propriétés doivent être spécifiées dans un dispositif afin d'inclure un environnement JRE dans une génération de produit sans interface graphique.
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 :
  • root.permissions.755=eclipse : Définissez le fichier 'eclipse' de façon qu'il dispose d'autorisations d'exécution.
  • root.linux.gtk.x86.permissions.755=lib/** : Définissez tous les fichiers du répertoire lib de façon qu'ils soient exécutables.

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 :
  • root.macosx.carbon.ppc.link=Eclipse.app/Contents/MacOS/eclipse,eclipse : Dans la configuration macosx.carbon.ppc, créez un lien lointain dans la racine nommé "eclipse", qui pointe vers le fichier "Eclipse.app/Contents/MacOS/eclipse".

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

Inclusion des fichiers racine dans une génération de produit

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 :