Une spécification de génération contient les instructions qui indiquent au moteur de génération comment créer et modifier les objets se trouvant dans un
projet. Elle contient quatre sections : Références de projet, Variables, Jeux de commandes
et Générateurs ; les jeux de commandes et les générateurs étant les principales. Les jeux de commandes décrivent comment des objets sont générés sur le système d'exploitation IBM® i, les générateurs décrivent
quoi construire. En voici une présentation rapide.
- Références du projet
- Les références sont utilisées pour se référer à d'autres spécifications
de génération d'autres projets.
Les jeux de commandes de ces spécifications peuvent être
utilisés dans cette spécification. Cela permet aux définitions communes d'être partagées entre un certain nombre de projets. Les références de projet peuvent
également être utilisées pour spécifier des projets prérequis. Il s'agit de
projets desquels ce projet dépend qui doivent donc être construits avant que ce
projet soit construit.
- Variables
- Les variables sont des valeurs de chaîne qui peuvent être utilisées selon leur nom dans les attributs
des jeux de commandes et des générateurs. Elles sont utilisées pour contrôler divers aspects
d'une version et pour fournir un espace pratique pour la définition des options de génération.
- Générateurs
- Les générateurs définissent les objets à créer, les entrées qui sont utilisées
pour créer ces sorties et quelles sont les dépendances parmi les générateurs du
projet. Ces dépendances définissent l'ordre dans lequel les générateurs du projet
sont exécutés. Les générateurs décrivent également les autres ressources pouvant être des dépendances d'un projet et qui ne sont pas directement contenues dans le projet.
- Jeux de commandes
- Il s'agit de listes de commandes IBM i
standard que peuvent utiliser les générateurs. Un jeu de commandes peut être utilisé par
plusieurs générateurs. Les jeux de commandes peuvent être paramétrés à l'aide de
variables de substitution dont les valeurs sont alors fournies par le générateur.
Fichier .ibuild
La spécification de génération est conservée dans
le fichier .ibuild situé dans le répertoire .ibmi du projet. Il s'agit d'un fichier XML. Le fichier peut être édité à l'aide de l'éditeur de spécifications IBM i, éditeur basé sur des formulaires permettant facilement
de s'assurer que le marquage XML généré est correct. N'éditez pas ce fichier directement. Utilisez
toujours l'éditeur de spécification de génération.