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 :
où args est une liste séparée par une virgule des paires de clés/valeurs décrites ci-dessous :
- tag, balise CVS à extraire ;
- cvsRoot, une chaîne de connexion CVS ;
- path, un module CVS et un chemin d'accès optionnels pour accéder au dossier contenant l'élément. Par défaut, le nom de l'élément est utilisé comme nom de module ;
- prebuilt, un critère booléen indiquant si l'élément téléchargé est prégénéré. Par défaut cela est false;
- cvsPassFile, un chemin d'accès en option vers un fichier de passe cvs ;
- password, un mot de passe optionnel à utiliser pour se connecter à CVS ;
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 :
- unpack, définissez sur true pour indiquer que l'élément de téléchargement doit être décompressé ;
- verbose, définissez sur true pour afficher les informations de progression prolixes pendant le téléchargement. La valeur par défaut est false;
- ignoreerrors, définissez sur true pour journaliser les erreurs pendant le transport. La valeur par défaut est false;
- usetimestamp, téléchargez sous condition un fichier basé sur l'horodatage de la copie locale (uniquement pour les URL http) lorsque défini sur true. La valeur par défaut est false;
- username, le nom d'utilisateur pour l'authentification http "BASIC" ;
- password, le mot de passe pour effectuer le téléchargement.
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
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>
- id, identificateur de l'unité installable ;
- version, version de l'unité installable (facultatif). Si elle n'est pas spécifiée, la version la plus récente disponible est extraite.
- repository, emplacement (URI) du référentiel où se trouve l'IU.
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 :
- Vérifiez qu'un fichier cvs.exe figure dans le chemin de recherche système.
(Téléchargez CVS depuis ici).
- Créez le dossier maps dans le répertoire de génération.
- Créez un fichier avec l'extension .map dans le dossier maps.
- Complétez ce fichier de mappe avec tous les éléments à extraire du référentiel.
- Modifiez le fichier build.properties du dossier de configuration et
mettez en commentaire la ligne skipFetch=true. Si vous définissez cette propriété, la compilation PDE ignore l'ensemble de la phase d'extraction. Si vous voulez ignorer la balise définie dans les fichiers de mappe, affectez une valeur spécifique à la propriété fetchTag. Ceci est utile lorsque vous exécutez une génération la nuit depuis HEAD et non pas des version balisées.
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 :
- skipMaps: mettez en commentaire cette propriété. Si vous définissez la propriété, l'environnement PDE ne peut pas extraire les fichiers de mappe.
- mapsRepo = :pserver:anonymous@example.com/path/to/repo. référentiel CVS d'extraction des fichiers de mappe.
- mapsRoot =
/path/to/maps chemin dans le référentiel CVS qui permet d'accéder au répertoire contenant les fichiers de mappe.
- mapsCheckoutTag =
HEAD Balise CVS à utiliser pour extraire les fichiers de mappe.
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.