Le dépôt de code source Adélia est un service permettant d'intégrer directement dans l'éditeur L4G et dans le gestionnaire d'objet d'Adélia les fonctions de l'outil d'import et d'export de sources.
Il fournit également une interface vers les outils de gestion de version Git et SVN, ce qui permet d'accéder directement depuis l'éditeur à l'historique d'un programme.
Attention, comme l'outil d'import et d'export de sources, le dépôt n'est pas compatible avec le gestionnaire de base de données Microsoft Access®.
De façon générale, le terme "gestionnaire de version" dans la documentation du dépôt désigne un gestionnaire de version de code source de type Git ou SVN (historique de versions de fichiers), et non le gestionnaire de version Adélia.
Les fonctionnalités fournies sont :
- Import / export des données directement depuis le gestionnaire d'objets ou l'Editeur L4G.
- Export automatique du code source à la sauvegarde d'un document.
- Comparaison des versions disque et référentiel.
Synchronisation automatique (optionnelle) des données de l'environnement et du dépôt. Dans ce cas, toute modification d'un objet dans l'environnement (renommage, suppression) sera reportée automatiquement dans le dépôt.
De plus, si l'intégration à un gestionnaire de version est configurée, il est également possible :
- d'afficher l'historique d'un objet ou de l'ensemble du référentiel,
- de comparer le source d'un objet avec une version issue de l'historique,
- d'importer une version d'un programme depuis l'historique,
- de livrer (création d'une version dans le gestionnaire de version) ou de revenir en arrière sur les modifications en cours,
- dans le cas d'un environnement d'exploitation d'un gestionnaire de version Adélia, de livrer automatiquement les modifications reçues suite à une validation de correction.
Dans ce cas, le commentaire généré pour la livraison peut également indiquer les tickets Jira si un gestionnaire de bogues est configuré sur l'environnement de correction.
Limitations de la synchronisation automatique
La synchronisation automatique exporte automatiquement les objets modifiés et gère de façon transparente les suppressions (git rm ou svn rm) ou les renommages (git mv ou svn mv) d'objets avec le gestionnaire de versions. Toutefois, vous pouvez rencontrer les limitations suivantes à l'utilisation :
- Un objet est considéré comme renommé si son nom ou sa visibilité (passage de public à privé, ou inversement) sont modifiés. Toutefois, le changement de domaine d'un objet privé n'est pas pris en compte : dans Adélia cela nécessite deux opérations distinctes (détachement de l'ancien domaine puis attachement au nouveau).
- Si un objet est renommé en dehors du référentiel Adélia (utilisation directe de git mv), le dépôt de source n'est pas capable de suivre la modification. Dans ce cas deux enregistrement apparaissent pour l'objet dans les boîtes de livraison ou de retour en arrière : l'ancien nom de l'objet apparaît avec la mention "Supprimé", le nouveau avec la mention "Renommé". Les deux enregistrement doivent impérativement être livrés ou annulés en même temps sinon vous risquez de générer des incohérences.
- Si un objet est supprimé du gestionnaire de version (parce qu'il a été supprimé ou renommé dans l'environnement), et que vous créez un nouvel objet de même nom et de même type, le dépôt de sources refusera d'exporter ce nouvel objet tant que la suppression n'aura pas été livrée. De plus, des erreurs peuvent être renvoyées si vous tentez d'annuler la suppression ou le renommage alors qu'il existe dans le référentiel un objet de même nom que celui qui doit être restauré.
- La synchronisation automatique est transparente et fonctionne en arrière-plan dans toutes les applications Adélia (à l'exception du gestionnaire de versions Adélia et des échanges qui gèrent explicitement la synchronisation). De ce fait, en cas d'erreur de synchronisation, aucune boîte de message n'est affichée. Vous pouvez consulter les logs si vous rencontrez des problèmes (logger "com.hardis.adelia.sync" dans log4c, fichier ".adelia\server.log" coté serveur du dépôt de sources).
Remarque : Adélia ne fournit que des fonctions de base pour l'interface du gestionnaire de version. Les fonctionnalité avancées (gestion de branches, de fusions de versions, etc.) doivent être gérées directement à l'aide des outils dédiés du gestionnaire de version utilisé.