Personnalisation de HCL Commerce Build tool

Bien que HCL Commerce Build tool prenne en charge un large éventail de configurations par défaut à travers des exemples et des configurations, un projet de personnalisation HCL Commerce peut avoir des besoins très spécifiques qui ne sont pas facilement pris en charge. Pour s'adapter à ces besoins, HCL Commerce Build tool fournit des points d'extension qui peuvent être exploités pour développer des processus de construction personnalisés. Cette section fournit des instructions et directives de personnalisation.

Remarque : Des compétences avancées sur Apache Ant sont nécessaires pour personnaliser l'outil de génération. Apache Ant Manual est une référence utile pour les tâches Ant disponibles.
Figure 1. Instructions de personnalisation générales

Les lignes directrices de personnalisation suivantes s'appliquent pour une meilleure réutilisation et une meilleure capacité de service :

  • Vérifiez toujours la documentation et les fichiers de configuration dans HCL Commerce Build tool premier pour voir en premier lieu si la personnalisation peut être effectuée avec la fonctionnalité par défaut. Les fichiers de configuration sont conçus pour gérer la plupart des configurations ou des personnalisations telles que la modification des répertoires et la modification des paramètres de divers outils. Cela permettra d'éviter le travail dupliqué.
  • HCL Commerce Build tool fournit des actifs d'assistance qui sont réutilisables et servent d'exemples de personnalisation. Ces actifs sont généralement marqués à l'aide de -common dans le nom du fichier et sont très bien documentés dans le fichier. Examinez toujours ces fichiers avant la personnalisation pour comprendre ce qui peut être réutilisé.
  • Les fichiers de modèle ont des sections identifiées par la chaîne CUSTOMIZATION qui fournit des détails et des conseils sur la personnalisation des fichiers créés à partir d'eux.
  • Utilisez un préfixe project-, où project est un identificateur du projet, pour tous les nouveaux fichiers créés dans le cadre de la personnalisation. Par exemple, si le projet de personnalisation est appelé abc et qu'une version personnalisée de wcbd-build.xml est requise, le nom recommandé du nouveau fichier est abc-build.xml.
  • Lorsque de nouveaux fichiers et propriétés Ant d'aide sont introduits, assurez-vous qu'ils sont chargés dans le fichier principal de génération fourmi à l'aide des tâches Ant import et property respectivement. Pour les fichiers de génération Ant d'aide, n'ajoutez pas de cible par défaut au projet.
  • Assurez-vous que les nouvelles cibles et propriétés ne partagent pas le même nom que celles existantes dans les fichiers de configuration et propriétés Ant d'aide prêts à l'emploi.
  • Si des tâches Ant facultatives sont utilisées, assurez-vous que toutes les bibliothèques dépendantes sont ajoutées au répertoire WCB_installdir/lib et incluses dans le chemin de classe dans les fichiers setenv.
Figure 2. Fichiers non personnalisables

Tous les fichiers commençant par le préfixe wcbd- sont jugés non personnalisables pour des raisons de capacité de service. Ces fichiers ne doivent en aucun cas être modifiés ou supprimés par les utilisateurs de HCL Commerce Build tool.