Identificazione e riferimento delle biblioteche
Ogni biblioteca è identificata da un ID univoco. L'ID della biblioteca segue il modello <title>, <version><company>), dove il titolo contiene il nome leggibile, la versione è specificata nel formato semver a 4 parti e il nome dell'azienda del fornitore è facoltativo. I separatori ,, (, E ) non sono ammessi <title> E <company>.
Suggerimento
Utilizza, ove possibile, nomi brevi e concisi e caratteri ASCII stampabili.
Un riferimento non deve necessariamente contenere un numero di versione fisso. Invece, è possibile specificare anche un modello di versione. Se questo modello corrisponde a più versioni di libreria disponibili, verrà selezionata automaticamente la versione più recente corrispondente. La descrizione completa della sintassi e del significato dei modelli di versione è descritta nella documentazione per Libraries.json.
Tipi di riferimento
Un'applicazione designa le sue librerie nel references sezione del Libraries.json elenco di riferimenti. La chiave di ogni voce è lo spazio dei nomi tramite il quale l'applicazione accede alla libreria. Il tipo di riferimento è determinato da $type campo.
| Tipo di riferimento | Designazione della biblioteca |
|---|---|---|
| Biblioteca gestita | Tramite un ID di libreria con versione fissa o modello di versione |
| Percorso relativo | Attraverso un percorso verso un progetto |
| Titolare | Tramite un nome simbolico che viene sostituito solo durante la risoluzione |
Categorie della biblioteca
Una libreria è assegnata a una o più categorie, dove le categorie sono gerarchiche. Sono solo a scopo di visualizzazione e non hanno alcuna influenza sulla risoluzione. Le categorie sono dichiarate nel ProjectInfo.json file. Il carattere pipe (| ) separa i livelli della gerarchia.
"categories": ["System|SysLibs", "Docs|Fieldbus|Sercos", "Use Cases"]