Identification et référencement des bibliothèques
Chaque bibliothèque est identifiée par un identifiant unique. Cet identifiant suit le modèle suivant : <title>, <version> (<company>), où le titre contient le nom lisible, la version est spécifiée au format semver en 4 parties et le nom de l'entreprise du fournisseur est facultatif. Les séparateurs ,, (, et ) ne sont pas autorisés à <title> et <company>.
Astuce
Utilisez autant que possible des noms courts et concis et des caractères ASCII imprimables.
Une référence ne doit pas nécessairement contenir un numéro de version fixe. Il est également possible de spécifier un modèle de version. Si ce modèle correspond à plusieurs versions de bibliothèque disponibles, la version la plus récente sera sélectionnée automatiquement. La description complète de la syntaxe et de la signification des modèles de version est disponible dans la documentation. Libraries.json.
Types de référence
Une application désigne ses bibliothèques dans le references section de la Libraries.json liste de références. La clé de chaque entrée est l'espace de noms par lequel l'application accède à la bibliothèque. Le type de référence est déterminé par le $type champ.
| Type de référence | Désignation de la bibliothèque |
|---|---|---|
| Bibliothèque gérée | Via un identifiant de bibliothèque avec une version fixe ou un modèle de version |
| Chemin relatif | Par le biais d'un chemin vers un projet |
| Espace réservé | Par le biais d'un nom symbolique qui n'est remplacé que lors de la résolution |
Catégories de bibliothèque
Une bibliothèque est associée à une ou plusieurs catégories, ces catégories étant hiérarchisées. Elles servent uniquement à l'affichage et n'ont aucune incidence sur la résolution. Les catégories sont déclarées dans le fichier de configuration. ProjectInfo.json fichier. Le caractère pipe (| ) sépare les niveaux de la hiérarchie.
"categories": ["System|SysLibs", "Docs|Fieldbus|Sercos", "Use Cases"]