Personnalisation du processus de package

Les utilisateurs avancés peuvent personnaliser le processus de génération à l'aide du langage de script Apache Ant.

Pourquoi et quand exécuter cette tâche

scm fait référence à un identificateur qui représente votre système de gestion de contrôle de source (SCM).

Conseil : WCB_installdir/wcbd-build-common.xml fournit des cibles Ant d'aide réutilisables et sert d'exemples de personnalisation. Pour plus d'informations, lisez les sections commentées dans le fichier wcbd-build-common.xml.

Procédure

Facultatif : Développez des scripts personnalisés pour les intégrer à votre SCM. Cette étape est nécessaire si le SCM utilisé dans votre projet de personnalisation n'est pas celui pour lequel des exemples de scripts sont fournis. Pour plus d'informations, voir Configurer le script Ant d'extraction source.
1. Copier WCB_installdir/extract/wcbd-extract.private.properties.template comme WCB_installdir/extract-scm.private.properties.
2. Copier WCB_installdir/extract/wcbd-extract.properties.template comme WCB_installdir/extract-scm.properties.
3. Copier WCB_installdir/extract/wcbd-extract.xml.template comme WCB_installdir/extract-scm.xml.
4. Modifiez l'autorisation de fichier avec les commandes suivantes :
```
chmod 755 WCB_installdir/extract-scm.*
```
5. Ouvrez WCB_installdir/extract-scm.xml avec un éditeur de texte et remplacez l'attribut de nom de l'élément de projet racine de wcbd-extract vers extract-scm. Ensuite, écrivez la logique personnalisée pour extraire le code source de votre SCM. Pour plus d'informations, consultez les commentaires inclus dans le fichier.
6. Ouvrez WCB_installdir/extract-scm.private.properties avec un éditeur de texte et ajoutez toutes les propriétés sensibles à la sécurité dont WCB_installdir/extract-scm.xml a besoin.
7. Ouvrez WCB_installdir/extract-scm.properties avec un éditeur de texte et ajoutez toutes les propriétés requises par WCB_installdir/extract-scm.xml
Facultatif : Ajoutez des fonctions à la génération Ant :
1. Créer un fichier de génération Ant d'aide appelé WCB_installdir/project-build-common.xml.
2. Ouvrez le fichier avec un éditeur de texte et ajoutez la ligne suivante après l'ouverture de l'élément de projet racine :
```
<import file="${basedir}/wcbd-build-common.xml"/>
```
3. Ajoutez de nouvelles cibles au fichier si besoin.
  La cible d'aide existante et toute cible qui pourrait en dépendre peuvent être remplacées en fonction de la spécification de la tâche import Ant.
Facultatif : Ajoutez des propriétés sensibles à la sécurité, telles que des noms d'utilisateur et des mots de passe :
1. Copier WCB_installdir/wcbd-build.private.properties.template comme WCB_installdir/project-build.private.properties.template.
2. Ajoutez les nouvelles propriétés suivantes à la fin du fichier : Pour plus d'informations, consultez les commentaires inclus dans le fichier.
Ce fichier devient le nouveau fichier de modèle de propriétés pour la configuration.
Facultatif : Ajoutez des propriétés :
1. Copier WCB_installdir/wcbd-build.properties.template comme WCB_installdir/project-build.properties.template.
2. Ajoutez les nouvelles propriétés suivantes à la fin du fichier : Pour plus d'informations, consultez les commentaires inclus dans le fichier.
Ce fichier devient le nouveau fichier de modèle de propriétés pour la configuration.
Facultatif : Ajouter des bibliothèques :
1. Copier WCB_installdir/wcbd-setenv*.template comme WCB_installdir/project-setenv*.template.
2. Mettre à jour la variable CLASSPATH dans WCB_installdir/project-setenv.bat.template.
Ces fichiers deviennent les nouveaux fichiers de modèle setenv pour la configuration.
Inclure des fonctions nouvelles ou modifiées dans le processus de génération global :
1. Copier WCB_installdir/wcbd-build.xml comme WCB_installdir/project-build.xml.
2. Si le nouveau fichier de génération WCB_installdir/project-build-common.xml Ant d'aide a été créé avec les étapes précédentes, modifiez la ligne suivante dans WCB_installdir/project-build.xml :
```
<import file="${basedir}/wcbd-build-common.xml" />
```
  à :
```
<import file="${basedir}/project-build-common.xml" />
```
3. Modifiez la logique du processus de génération pour incorporer les nouvelles modifications. Pour plus d'informations, consultez les commentaires inclus dans le fichier.
Personnalisation des fichiers utilisés pour Configuration des paramètres d'emballage et Génération de packages réalisés de la même manière que les actifs par défaut, sauf que les fichiers project-* sont utilisés au lieu des fichiers wcbd-*.