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.
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.
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.
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.
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 :
-buildfile=</path/to/build.xml> : il s'agit du chemin d'accès au fichier build.xml fourni par la compilation PDE. Il se trouve dans le répertoire org.eclipse.pde.build/scripts. Il s'agit du script de génération qui régit l'ensemble de la génération.-Dbuilder=</path/to/configuration folder>:
Il s'agit du chemin d'accès au dossier de configuration de la génération.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).
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.