Bibliotheken identifizieren und referenzieren
Jede Bibliothek wird über eine eindeutige Bibliotheks-ID identifiziert. Die Bibliotheks-ID folgt dem Muster <Title>, <Version> (<Company>), wobei der Titel den lesbaren Namen enthält, die Version im Format SemVerQuattro angegeben wird und optional der Firmenname des Herstellers genannt wird. In <Title> und <Company> sind die Trennzeichen ,, ( und ) nicht erlaubt.
Tipp
Verwenden Sie kurze, prägnante Namen und möglichst druckbare ASCII-Zeichen.
Eine Referenz muss keine feste Versionsnummer enthalten. Stattdessen kann auch ein Versionsmuster angegeben werden. Wenn dieses Muster auf mehrere verfügbare Bibliotheksversionen zutrifft, wird automatisch die neueste passende Version ausgewählt. Die vollständige Beschreibung der Syntax und Bedeutung von Versionsmustern ist in der Dokumentation zur Libraries.json beschrieben.
Referenzarten
Eine Applikation nennt ihre Bibliotheken in der Referenzliste Libraries.json im Abschnitt references. Der Schlüssel jedes Eintrags ist der Namensraum, über den die Applikation auf die Bibliothek zugreift. Die Art der Referenz wird über das Feld $type festgelegt.
| Referenzart | Benennung der Bibliothek |
|---|---|---|
| Verwaltete Bibliothek | Über eine Bibliotheks-ID mit fester Version oder Versionsmuster |
| Relativer Pfad | Über einen Pfad zu einem Projekt |
| Platzhalter | Über einen symbolischen Namen, der erst bei der Auflösung ersetzt wird |
Bibliothekskategorien
Eine Bibliothek wird einer oder mehreren Kategorien zugeordnet, Kategorien sind hierarchisch. Sie dienen nur der Anzeige und haben keine Bedeutung für die Auflösung. Die Kategorien werden in der Datei ProjectInfo.json deklariert. Das Zeichen | trennt die Ebenen der Hierarchie.
"categories": ["System|SysLibs", "Docs|Fieldbus|Sercos", "Use Cases"]