Per evitare problemi di coerenza e supportare adeguatamente l'utente, è necessario attenersi a determinate regole per la creazione, la referenziazione, la codifica, la protezione e la documentazione delle librerie.
La seguente descrizione fornisce solo una panoramica delle possibilità di sviluppo della biblioteca. Per una descrizione più dettagliata di questi argomenti, consultare le linee guida "LibDevSummary" per lo sviluppo delle librerie.
Per ulteriori informazioni, vedere: ⮫ «Utilizzo delle biblioteche », ⮫ «Repository della biblioteca », ⮫ «Responsabile della biblioteca »
Generale
-
È possibile definire categorie per le biblioteche. Le biblioteche vengono quindi visualizzate nel repository delle biblioteche sotto queste categorie.
-
È possibile definire uno spazio dei nomi per una libreria, per consentire un accesso univoco agli oggetti integrati. L'accesso diventa univoco aggiungendo lo spazio dei nomi davanti al nome della POU:
<spazio dei nomi>.<nome della variabile>
Esempio:
AC.Module -
È possibile aprire i POU delle librerie non cifrate (
*.library) facendo doppio clic sulla rispettiva voce nel Library Manager. -
È possibile creare i seguenti tipi di libreria:
-
*.library: Libreria di implementazione (codice sorgente della libreria) -
*
.compiled-library,*.compiled-library-v3: Biblioteca protettaIl codice sorgente non è più accessibile.
-
*_Itfs.library: Libreria di interfacciaContiene solo oggetti utilizzati per la definizione dell'interfaccia di un componente (ad esempio, costanti, strutture o interfacce) e che non generano codice.
-
*_Cnt.library: Libreria di contenitoriNon contiene POU, ma solo altre biblioteche
Pertanto, utilizzato per integrare comodamente un intero insieme di librerie i cui POU sono pubblicati al livello superiore della libreria contenitore
-
-
È possibile integrare librerie esterne nell'applicazione. Le librerie esterne sono programmate al di fuori di CODESYS in un linguaggio di programmazione diverso (ad esempio: C).
Protezione delle biblioteche
-
Protezione del codice sorgente
Quando una libreria è preparata in formato "libreria compilata", il codice sorgente dei POU della libreria non è più visibile dopo che la libreria è stata integrata in un progetto.
-
Firma
In CODESYS V3 SP15 e successivi, viene sempre utilizzato un certificato per la firma dei progetti di libreria (
*.compiled-library-v3). La firma può essere applicata tramite un'impostazione nella schermata di sicurezza. Quindi, per generare una libreria compilata, è necessario un certificato adatto alla firma del codice nel proprio profilo utente.Per i progetti di libreria che devono essere compatibili con CODESYS < V3 SP15 (
*.compiled-library), è possibile solo la firma meno sicura con una chiave privata e un token corrispondente. Questi metodi deprecati devono essere utilizzati solo per motivi di compatibilità. Le impostazioni vengono configurate in «Informazioni sul progetto» nella scheda «Firma».Nota: Per la firma delle librerie, si dovrebbe usare la versione del compilatore 3.5.15.0 o superiore, perché viene usato un formato di memorizzazione migliore.
-
Licenze
È possibile proteggere le librerie mediante una licenza (dongle o soft container). Le librerie protette da licenza possono essere installate nel repository delle librerie. Tuttavia, per poter essere utilizzata nel progetto, la licenza valida deve essere presente sul computer. Le licenze sono gestite in License Manager.
Versioni della biblioteca
-
È possibile avere più versioni di una libreria installate contemporaneamente sul sistema.
-
È possibile integrare nel progetto più versioni di una libreria contemporaneamente. Tuttavia, non consigliamo di farlo. In questo caso, a ciascuna delle librerie deve essere assegnato uno spazio dei nomi unico e l'accesso ai simboli deve essere qualificato.
Esempi:
V1.SendBlob,V2.SendBlob
Librerie di riferimento
-
È possibile integrare una libreria in altre librerie (librerie di riferimento). L'annidamento può essere di qualsiasi profondità.
-
È possibile definire se le librerie di riferimento devono essere visibili nel Gestore delle librerie.
-
È possibile integrare librerie di riferimento tramite segnaposto di libreria. In questo modo si evitano i problemi che potrebbero verificarsi a causa delle dipendenze di versione o della necessità di utilizzare librerie specifiche del fornitore.