Principes fondamentaux de la gestion des bibliothèques
Dans CODESYS 4 Les bibliothèques sont référencées, et non intégrées de manière permanente à l'application.
Les références proviennent de différentes sources : des données saisies par le développeur, des descriptions de périphériques et du système de programmation lui-même. Nombre d’entre elles sont vagues. Elles désignent un espace réservé ou un modèle de version, sans pour autant nommer une bibliothèque spécifique.
Le compilateur, cependant, exige une version unique pour chaque bibliothèque. De ce fait, deux éléments sont séparés dans CODESYS 4: les références souhaitées et les bibliothèques uniques identifiées à partir de celles-ci.
Principe de base : Liste de référence et fichier de verrouillage
La gestion de la bibliothèque repose sur deux fichiers.
Le Libraries.json Il s'agit de la liste de références. C'est ici que vous saisissez les références directes aux bibliothèques. Ce fichier décrit les bibliothèques requises par l'application. Il peut être mis à jour manuellement ou via l'interface utilisateur.
Le graphe de dépendances complet est établi à partir de la liste de références lors de la résolution des bibliothèques. Chaque référence est résolue récursivement. Les bibliothèques elles-mêmes requises par les bibliothèques référencées sont également déterminées.
Le résultat est inscrit dans le Libraries.lock.json fichier de verrouillage.
Déposer | Rôle | |
|---|---|---|
| Liste de référence avec les bibliothèques souhaitées | Le fichier est géré et maintenu par le développeur. |
| Fichier de verrouillage contenant le graphe de dépendances résolu | Le fichier est automatiquement créé et mis à jour lors de la résolution de la bibliothèque. |
Avantages pour le contrôle des versions et la reproductibilité
Le fichier de verrouillage est conçu pour garantir la reproductibilité. Ses clés sont triées, son format reste stable et une somme de contrôle SHA384 est stockée pour les bibliothèques compilées.
Ce fichier de verrouillage est compatible avec les systèmes de contrôle de version tels que Git ou SVN. Il est au format JSON, ce qui le rend lisible. Les modifications apportées à l'état de la bibliothèque peuvent être suivies dans le diff et vérifiées lors de la revue de code.
Lorsque le fichier de verrouillage est intégré au projet, chaque développeur obtient le même état de la bibliothèque.
Astuce
Toute personne familière avec npm ou NuGet reconnaîtra le principe du fichier de verrouillage. Ces connaissances préalables ne sont pas nécessaires pour travailler avec CODESYS 4.