Informazioni per gli sviluppatori di biblioteche
Suggerimento
Per evitare problemi di coerenza e supportare adeguatamente l'utente, accertarsi di rispettare determinate regole per la creazione, il riferimento, la crittografia, la protezione e la documentazione delle biblioteche.
La seguente descrizione fornisce solo una panoramica delle possibilità di sviluppo della libreria. Per una descrizione più dettagliata di questi argomenti, vedere le linee guida "LibDevSummary" per lo sviluppo di librerie.
Per ulteriori informazioni, vedere: Utilizzo delle biblioteche
Generale
È possibile definire categorie per le librerie. Le librerie vengono quindi visualizzate nel repository delle librerie sotto queste categorie.
Per ulteriori informazioni sulla creazione di categorie di libreria, vedere: Categorie della biblioteca
È possibile definire uno spazio dei nomi per una libreria per consentire l'accesso univoco agli oggetti integrati. L'accesso diventa univoco aggiungendo lo spazio dei nomi davanti al nome della POU:
<spazio dei nomi>.<nome variabile>
Esempio:
AC.Module
È possibile aprire le POU di librerie non crittografate (
*.library
) facendo doppio clic sulla rispettiva voce in Library Manager.È possibile creare i seguenti tipi di libreria:
*.library
: Libreria di implementazione (codice sorgente della libreria)*
.compiled-library
,*.compiled-library-v3
: Libreria protettaIl codice sorgente non è più accessibile.
*_Itfs.library
: Libreria di interfacciaContiene solo oggetti che vengono utilizzati per la definizione dell'interfaccia di un componente (ad esempio costanti, strutture o interfacce) e non generano alcun codice
*_Cnt.library
: Libreria contenitoreNon contiene POU, ma solo altre librerie
Pertanto, utilizzato per integrare convenientemente un intero set di librerie le cui POU sono pubblicate 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 (esempio: C).
Protezione delle biblioteche
Protezione del codice sorgente
Quando una libreria viene preparata in formato "libreria compilata", il codice sorgente delle POU della libreria non è più visibile dopo che la libreria è stata integrata in un progetto.
Firma
In CODESYS V3 SP15 e successive, per la firma dei progetti di biblioteche viene sempre utilizzato un certificato (
*.compiled-library-v3
). La firma può essere forzata tramite un'impostazione nella schermata di sicurezza. Quindi, per generare una libreria compilata, è necessario un certificato adatto per la firma del codice nel proprio profilo utente.Per progetti di biblioteche che devono essere compatibili con CODESYS < V3 SP15 (
*.compiled-library
), solo la firma meno sicura è possibile con una chiave privata e un token corrispondente. Questi metodi deprecati devono essere utilizzati solo per motivi di compatibilità. Le impostazioni sono configurate in Informazioni di progetto sul Firma scheda.Nota: per la firma delle librerie, è necessario utilizzare la versione del compilatore 3.5.15.0 o successiva poiché viene utilizzato un formato di archiviazione migliore.
Licenza
Puoi proteggere le biblioteche per mezzo di una licenza (dongle o soft container). Le librerie protette da licenza possono essere installate nel repository delle librerie. Tuttavia, per l'utilizzo nel progetto, la licenza valida deve esistere sul computer. Le licenze sono gestite in License Manager.
Versioni della libreria
È possibile avere più versioni di una libreria installate contemporaneamente sul sistema.
Puoi avere più versioni di una libreria integrate nel tuo progetto contemporaneamente. Tuttavia, non consigliamo di farlo. In questo caso, ciascuna delle biblioteche dovere essere assegnato uno spazio dei nomi univoco e l'accesso ai simboli dovere essere qualificato.
Esempi:
V1.SendBlob
,V2.SendBlob
Biblioteche referenziate
È possibile integrare una libreria in altre librerie (biblioteche referenziate). La nidificazione può essere di qualsiasi profondità.
È possibile definire se le librerie di riferimento devono essere visibili nel Gestore librerie.
È possibile integrare le librerie di riferimento tramite i segnaposto delle librerie. In questo modo si evitano i problemi che potrebbero verificarsi a causa delle dipendenze della versione o della necessità di utilizzare librerie specifiche del fornitore.