Extraction et référentiels

L'infrastructure fournie par la génération de l'environnement PDE fournit des étapes pour extraire le code source et les plug-ins pré-générés depuis un référentiel dans le cadre du processus de génération (consultez la tâche eclipse.fetch et les propriétés pour contrôler l'extraction). Il existe deux possibilités : laisser la compilation PDE extraire automatiquement le code source, ou extraire le code source manuellement.

Première étape de l'automatisation, le fichier de mappe

Selon l'identificateur du dispositif ou du plug in à générer, l'infrastructure de génération peut extraire tous les dispositifs et plug-ins inclus depuis un référentiel.

Pour connaître l'emplacement des éléments à extraire, la compilation PDE utilise des fichiers de mappe. Un fichier de mappe est un fichier de propriétés Java qui associe les ID de dispositif et de plug-in à un emplacement et une balise dans un référentiel. Le format des fichiers de mappe est ouvert mais la partie key est corrigée par la génération d'environnement PDE :

<elementType>@<elementID>[,<elementVersion>] = <repo specific content>

lorsque elementType est une des bundle, feature, plugin ou fragment, et elementId et que elementVersion donne les spécificités de l'élément.

Entrée de fichier de mappe pour CVS

Le format d'une entrée de fichier de mappe pour extraire le contenu de CVS est le suivant :
<key> = CVS, [,args]
où args est une liste séparée par une virgule des paires de clés/valeurs décrites ci-dessous : Exemple :
plugin@com.ibm.icu,3.6.1=CVS,tag=v200704191630,cvsRoot=:pserver:anonymous@dev.eclipse.org:/cvsroot/tools,path=org.eclipse.orbit/com.ibm.icu/bin,prebuilt=true

Anciennes entrées de mappe
Dans Eclipse 3.2 et les versions antérieures, le format de fichier de mappe pour CVS était :
<elementType>@<elementID> = CVS, <TAG>, <CVSROOT>[,<PASSWORD>[,<PATH>[,<CVSPASSFILE>]]]
Si les arguments facultatifs ne sont pas spécifiés, les virgules sont toujours nécessaires pour délimiter les arguments suivants. Ce format doit être considéré comme obsolète et il est préférable d'utiliser le format clé/valeur.

L'entrée de fichier de mappe pour Ant GET

Le format d'une entrée de fichier de mappe pour extraire le contenu d'une URL prise en charge par Ant GET est le suivant :

<key> = GET, <url> [,args]
où l'url est l'url pour extraire les données et args est une liste de paires de clés/valeurs optionnelles séparée par une virgule décrite ci-dessous : Exemple :
plugin@com.ibm.icu,3.4.5=GET,http://download.eclipse.org/tools/orbit/downloads/drops/S200705301823/bundles/com.ibm.icu_3.4.5.jar, unpack=true

Entrée de fichier de mappe pour d'autres référentiels p2

Une nouvelle extension a été ajoutée à PDE/la génération qui permet à l'utilisateur d'extraire les artefacts des référentiels p2. Désormais, vous pouvez ajouter une entrée au fichier de mappe pour l'entrée de génération et PDE/la génération extrait l'artefact et l'inclut dans la génération. L'entrée de fichier de mappe doit inclure l'ID et la version de l'unité installable et l'URI du référentiel ou se trouve l'unité installable. Les référentiels des métadonnées et des artefacts sont supposés se trouver dans le même emplacement.

Le format d'une entrée de fichier de mappe pour extraire le contenu via p2 est le suivant :

<elementType>@<elementID> = p2IU, id=<id>, version=<version>, repository=<repository>
Extraction des dispositifs avec p2

Dans l'édition Helios, vous pouvez extraire des dispositifs avec p2 en spécifiant l'unité installable représentant le fichier Jar des dispositifs. Consultez la page relative aux métadonnées des dispositifs pour des détails sur la structure des métadonnées p2 pour les dispositifs.

Exemples :
plugin@my.bundle.id,1.0.0=p2IU,id=my.bundle.id,version=1.0.0,repository=http://example.eclipse.org/repo
feature@my.feature.id = p2IU,id=my.feature.id.feature.jar, version=1.0.0,repository=http://example.eclipse.org/repo

Entrée de fichier de mappe pour d'autres référentiels

La génération d'environnement PDE fournit un point d'extension auquel les générateurs de script d'extraction pour différents référentiels peuvent être connectés. Si votre installation Eclipse contient un regroupement qui fournit une extension de générateur de script pour un type de référentiel différent, vous pouvez utiliser ce référentiel en le spécifiant dans vos entrées de fichier de mappe en respectant le format spécifié par le fournisseur d'extensions.

Définition de l'extraction du code source de CVS

Pour configurer l'extraction du code source depuis CVS, procédez comme suit :

Obtention des fichiers de mappe depuis CVS

Les fichiers de mappe se trouvent généralement dans un référentiel. La compilation PDE fournit une infrastructure par défaut pour obtenir les fichiers de mappe depuis un référentiel CVS. Pour activer cette fonction, changez les propriétés suivantes dans le fichier build.properties du répertoire de configuration : L'extraction des fichiers de mappe depuis CVS a lieu au cours de la prégénération.  Les scripts pour extraire tous les dispositifs et plug-ins inclus dans le dispositif que vous élaborez sont générés et exécutés lors de la phase d'extraction de la génération. 

Extraction automatique depuis d'autres référentiels

Si  vous extrayez automatiquement les fichiers de mappe depuis le référentiel, vous devez copier le fichier customTarget.xml depuis org.eclipse.pde.build/templates/headless-build vers le répertoire de configuration.  La cible   getMapFiles est utilisée pour extraire les fichiers de mappe ; ceci doit être modifié pour effectuer l'extraction depuis le référentiel.

Obtention du code source manuellement

Vous pouvez écrire des cibles d'extraction personnalisées pour extraire les plug-ins et les dispositifs qui peuvent être appelés depuis les cibles preSetup ou postSetup dans le fichier customTargets.xml.  Les dispositifs et les plug-ins doivent être recherchés dans ${buildDirectory}/features et ${buildDirectory}/plugins.