Il existe plusieurs méthodes de personnalisation d'une génération sans interface graphique :
Le format exact du contenu de ces fichiers dépend de chaque fichier. Par conséquent, lors de l'utilisation de personnalisations customTargets, allElements ou customAssembly, il est recommandé de vérifier que les modèles utilisés pour ces fichiers proviennent tous de la même version de PDE/Build. Les nouvelles versions de PDE/Build sont compatibles avec les anciennes versions de ces scripts de personnalisation.
Les versions de modèle de ces scripts sont disponibles dans le plug-in org.eclipse.pde.build, sous le dossier templates/headless-build. Pour utiliser la personnalisation, copiez simplement le modèle dans votre répertoire de configuration de génération et éditez les cibles appropriées.
Le script customTargets.xml est destiné à la personnalisation de niveau supérieur du processus de génération. Il fournit des cibles Ant qui sont appelées entre les principales phases de génération. Il existe des cibles disponibles pour chacune des étapes de génération suivantes :
Pour utiliser le script customTargets.xml, copiez-le depuis le répertoire des modèles PDE/Build dans votre répertoire de configuration de génération et éditez les cibles Ant appropriées. Le script sera détecté automatiquement et utilisé par la génération en mode sans interface graphique.
Le script customTargets.xml fournit également une délégation au script allElements.xml pour chacune des phases de génération.
Le script allElements.xml est un type de script de délégation qui permet d'exécuter les différentes étapes de génération sur un élément donné (généralement un dispositif). Comme avec customTargets.xml, pour utiliser ces étapes de personnalisation, copiez le modèle à partir du répertoire PDE/Build dans votre répertoire de configuration de génération. Dans Eclipse 3.4, l'élément cible qui sera généré peut être spécifié dans le fichier de configuration de génération de niveau supérieur build.properties via les propriétés topLevelElementType et topLevelElementId. La propriété elementType doit avoir pour valeur feature et la propriété elementId, l'identificateur du dispositif que vous souhaitez générer.
<target name="allElementsDelegator">
<ant antfile="${genericTargets}" target="${target}">
<property name="type" value="${topLevelElementType}" />
<property name="id" value="${topLevelElementId}" />
</ant>
</target>
Le script allElements.xml fournit également des cibles utilisées au cours de la phase d'assemblage et de mise en forme de la génération. La cible defaultAssemble sera appelée pour assembler les archives pour toutes les plateformes. Si vous le souhaitez, des cibles personnalisées peuvent être définies pour des plateformes individuelles.
Pour utiliser une cible personnalisée pour une plateforme donnée, définissez une propriété "assemble.<ID-élément>[.<config>] et une cible correspondante. La propriété indique à PDE/Build d'utiliser cette cible personnalisée à la place de la cible par défaut. Cette cible personnalisée peut ensuite être utilisée pour donner à l'archive un nom personnalisé ou pour exécuter une opération de pré/post-traitement sur l'archive.
Exemple :
<property name="assemble.org.foo.feature.id.linux.gtk.x86" value="true" />
<target name="assemble.org.foo.feature.id.linux.gtk.x86">
<property name="archiveName" value="acme-RCP-${buildId}-linux.gtk.x86.tar.gz" />
<-- custom pre assemble steps for linux.gtk.x86-->
<ant antfile="${assembleScriptName}" dir="${buildDirectory}"/>
<-- custom post assemble steps for linux.gtk.x86-->
</target>
Le script customAssembly.xml est une nouveauté de la version 3.4. Il fournit des points de personnalisation qui seront appelés au cours des phases d'assemblage et de mise en forme de la génération. Comme avec les fichiers customTargets.xml et allElements.xml, pour utiliser ces étapes de personnalisation, copiez le modèle à partir du répertoire PDE/Build dans votre répertoire de configuration de génération.
Les scripts d'assemblage et de mise en forme générés par PDE/Build exécutent les actions suivantes :
Les scripts d'assemblage s'occupent de la collecte des dispositifs et des plug-ins qui ont été compilés au cours de la génération ; les scripts de mise en forme traitent de la collecte des dispositifs et plug-ins binaires pré-compilés. Le script customAssembly.xml fournit les cibles suivantes, avant ou après chacune des étapes ci-dessus :