Génération des dispositifs

La compilation PDE est fournie avec une infrastructure d'automatisation de la génération des dispositifs. La majorité des opérations de configuration nécessaires à cette génération peuvent être exécutées en faisant quelques modifications dans le modèle de fichier build.properties fourni par la compilation PDE. La section suivante porte sur la configuration d'une génération simple en supposant que tous les plug-ins et dispositifs (à générer ou prégénérés) référencés à partir du dispositif à générer sont déjà disponibles localement sur le disque.

Configuration de base

Répertoire de configuration de génération

La première étape de la configuration d'une génération consiste à créer le répertoire de configuration de cette dernière. Il s'agit du répertoire dans lequel sont conservés les fichiers qui contrôlent et personnalisent la génération sans interface graphique.

Le fichier principal de contrôle de la génération est le fichier de configuration de génération de niveau supérieur, build.properties. Lors de la configuration d'une nouvelle génération, copiez le fichier modèle depuis le regroupement org.eclipse.pde.build dans le répertoire d'installation Eclipse que vous allez utiliser pour exécuter votre génération. Le fichier modèle se trouve ici : org.eclipse.pde.build/templates/headless-build/build.properties.

Ce répertoire est référencé par les propriétés builder, qui sont normalement définies sur la ligne de commande Ant.

buildDirectory

La propriété buildDirectory spécifie le répertoire dans lequel PDE/Build générera les scripts et effectuera la génération effective. Les plug-ins et dispositifs en cours de génération doivent être placés dans les sous-répertoires ${buildDirectory}/plugins et ${buildDirectory}/features. Si des regroupements et des dispositifs sont extraits d'un référentiel (voir Extraction et référentiels), ils sont ensuite également placés dans ces sous-répertoires.

Ce répertoire peut être le même que le répertoire de configuration de génération, mais ce n'est pas indispensable. Il peut être préférable d'utiliser un répertoire séparé, surtout si la configuration de génération est conservée dans CVS et que vous ne souhaitez pas la polluer avec des artefacts de génération créés.

Propriétés initiales

Pour configurer une génération de dispositif de base, vous devez éditer le fichier de configuration de génération build.properties et définir les propriétés suivantes :

La version précédente de PDE/Build exigeait également un fichier allElements.xml ; ce fichier n'est plus requis dans la version 3.4. Il peut toujours être utilisé, mais il n'est requis que si vous souhaitez personnaliser certains aspects de votre génération. Voir Personnalisation d'une génération sans interface graphique.

Exécution de la génération

Pour exécuter la génération, vous utilisez l'application org.elipse.ant.core.antRunner. Lorsque vous appelez Eclipse avec cette application pour effectuer une génération, vous devez définir deux arguments sur la ligne de commande :

Exécutez l'application antRunner en utilisant la commande suivante :


java -jar <eclipseInstall>/plugins/org.eclipse.equinox.launcher_<version>.jar -application org.eclipse.ant.core.antRunner -buildfile <<eclipseInstall>/plugins/org.eclipse.pde.build_<version>/scripts/build.xml> -Dbuilder=<path to the build configuration folder>

Une fois la génération terminée, vous pouvez obtenir le résultat dans le répertoire de génération dans le dossier I.TestBuild (ce nom peut être défini en spécifiant la propriété buildLabel).

Scénarios avancés

Pour plus d'informations sur la personnalisation de la génération, par exemple, sur l'extraction depuis un référentiel, voir les rubriques de génération PDE avancée.