Liste des tâches Gradle du build Adélia

adelAppInit

Cette tâche initialise le projet de build en créant la structure nécessaire à la fabrication des artéfacts en fonction de la liste des noms de domaines Adélia déclarée dans la clé adelLstAppArea du fichier gradle.properties.

La figure suivante montre le résultat de la tâche avec les clés adelAppName=sampleApp et adelLstAppArea=APP_AREA_1 APP_AREA_2.

Les sous-répertoires, ayant des noms de domaines, vont contenir les artéfacts des objets Adélia de visibilité privée.

De même, le sous-répertoire _Commons va contenir les artéfacts des objets Adélia de visibilité publique.

La figure suivante présente le détail structurel d'un répertoire "nom de domaine" (pour cet exemple APP_AREA_1).

Le répertoire _Commons associé aux objets de visibilité publique a une structure identique.

Chaque sous-répertoire "nom de domaine" contient un emplacement pour la construction des artéfacts des différents types possibles.

Il se peut qu'un emplacement soit vide s'il n'existe pas dans le domaine Adélia d'objet correspondant à un type d'artéfact particulier.

adelAppCreateAS400Lib

Cette tâche crée sur l'AS400 déclaré, dans les attributs d'environnement, les bibliothèques nécessaires à la génération des objets Adélia pour la construction des artéfacts de type As400Adelia et As400Server.

Les bibliothèques créées sont celles définies via les clés adelGenAS400.as400Adelia.genLib et adelGenAS400.as400Server.genLib du fichier gradle.properties.

adelAppClean

Cette tâche supprime le répertoire du nom de l'application à builder ainsi que les bibliothèques AS400 spécifiées pour la construction des artéfacts de type As400Adelia et As400Server (les noms de bibliothèques sont définies via les clés adelGenAS400.as400Adelia.genLib et adelGenAS400.as400Server.genLib du fichier gradle.properties).

Le projet de build est vidé et il est nécessaire de réexécuter la tâche adelAppInit pour l'initialiser.

adelAppGenerate

Cette tâche lance la génération Adélia des objets appartenant aux domaines définis par la clé adelLstAppArea de l'environnement défini par la clé adelEnvName.

Le nombre d'objets à générer dépend du mode de génération (valeur de la clé adelGenIncremental) :

• Tous les objets si le mode est global,

• Uniquement les objets modifiés depuis le dernier build exécuté si le mode est incrémental.

Dans les deux modes, si la génération Adélia d'un objet est en erreur, cela ne bloque pas les générations des autres objets, mais le build est stoppé sur la tâche adelAppGenerate.

Attention : si un objet Adélia généré lors d'un précédent build a été supprimé du référentiel, la tâche adelAppGenerate ne supprimera pas les objets binaires issus de la précédente génération, et ces binaires feront partie de l'artéfact qui sera construit.

A l'issue du traitement de cette tâche, les fichiers produits par la génération sont placés dans les répertoires suivants :

adelAppBuild

Cette tâche est la tâche principale d'un build Adélia. Elle se scinde en deux phases :

1. Appel de la tâche adelAppGenerate pour exécuter la génération Adélia,

2. Traitement des fichiers produits par la phase 1 pour construire les artéfacts associés.

A l'issue de la phase 2, les artéfacts produits sont placés dans les répertoires suivants :

Pour les artéfacts de nature Java, la compilation des fichiers sources .java (effectuée par la tâche adelAppBuild) s'appuie sur les options de compilation définies dans le fichier adeliws.ini.

En outre, si le paramètre de build adelCreateSourceFilesArtifacts a pour valeur Y, des artéfacts de sources L3G sont produits en plus des artéfacts principaux décrits plus haut :

 En outre, si le paramètre de build adelGenDebugMode a pour valeur Y, des artéfacts de debug sont produits en plus des artéfacts principaux décrits plus haut :

uploadArchives

Cette tâche permet de transférer les artéfacts construits dans le référentiel d'upload.

Il est nécessaire de renseigner la clé uploadArchivesReleaseRepo ou uploadArchivesSnapshotRepo en fonction du type de version des artéfacts.

Cette tâche doit être appelée après la tâche adelAppBuild.

↑ Haut de page

Dépendance des tâches Gradle du build Adélia

Le tableau ci-après détaille pour chaque tâche du build, les informations en entrée ainsi que les tâches dépendantes.

Lancement d'un build en ligne de commande

Le lancement s'effectue en plusieurs étapes décrites ci-après :

1. Ouvrez une fenêtre de commande DOS exécutée en tant qu'administrateur,

2. Placez-vous dans le répertoire du projet de build,

3. Suivant le mode de génération choisi et la volonté de stocker les artéfacts dans un référentiel, lancez la commande suivante :

(1)  : adelGenIncremental=N

(2)  : adelGenIncremental=Y

Remarques :

• • L'appel à la tâche adelAppClean en mode global permet d'assurer une cohérence entre le contenu d'un artéfact et les objets Adélia générés (cas d'un objet Adélia supprimé entre deux build),

• • Si le mode incrémental est activé et que la tâche adelAppClean a été exécuté, le prochain build en mode incrémental verra son mode forcé à global,

• • Puisque Gradle offre les mécanismes de dépendance de tâche et de cache d'entrées de tâch, l'appel à la tâche adelAppBuild déclenchera l'exécution de la tâche adelAppInit (initialisation du projet) dans les cas suivants :

• • • Lors du premier lancement du build Adélia,

• • • Si entre deux exécutions de build, le nom de l'application à builder (paramètre adelAppName) ou la liste des domaines Adélia à générer (paramètre adelLstAppArea) ont été modifiées.

↑ Haut de page

Lancement d'un build via Jenkins

L'aide se base sur Jenkins version 2.66 et sur le plugin Gradle pour Jenkins version 1.27.1.

Dans une démarche d'intégration continue, l'outil Jenkins permet de lancer et d'ordonner des travaux (jobs) de manière automatique.

Il est possible de définir un job comme étant un build Adélia pour que celui-ci soit exécuté par Jenkins.

Cela peut se faire de deux manières différentes , décrites ci-après.

Build Adélia en ligne de commande

Lors du paramétrage du job, dans la section Build, ajoutez une étape au build via l'option "Exécuter une ligne de commande batch Windows": il est possible de saisir un ensemble de commandes au format Batch DOS, qui seront exécutées séquentiellement comme par exemple :

cd /d "D:\build"

call gradlew adelAppClean adelAppBuild uploadArchives

Build Adélia via le plugin Gradle

Lors du paramétrage du job, dans la section Build, ajoutez une étape au build via l'option "Invoke Gradle script" : choisissez le bouton radio "Use Gradle Wrapper" puis renseignez les champs "Wrapper location" (saisissez le chemin du projet ou se trouve le fichier gradlew.bat - dans notre exemple D:\build) et "Task" (saisissez la liste des tâches Gradle à exécuter - dans notre exemple adelAppClean adelAppBuild uploadArchives).

De plus, il faut préciser le répertoire racine du projet de build. Pour cela, cliquez sur le bouton Avancé de l'étape et renseignez le champ "Root Build script" (dans notre exemple D:\build).

↑ Haut de page