Skip to main content

Archivio della biblioteca

Quando CODESYS 4 una volta installato, vengono installate anche diverse estensioni. Ogni estensione può contenere un repository di librerie. Questi repository di librerie sono automaticamente attivi e disponibili. Non è necessario inserirli nel LibraryRepositories.prefs.json file.

Creazione di repository di libreria personalizzati

In CODESYS 4 è possibile creare un numero illimitato di repository di librerie personalizzati.

I repository personalizzati sono configurati nel LibraryRepositories.prefs.json file. Su Linux, questo file si trova in ~/.config/CODESYS-4/LibraryRepositories.prefs.json Su Windows, questo file si trova in %APPDATA%\CODESYS-4\LibraryRepositories.prefs.json Il formato della configurazione del repository è definito dal server di distribuzione.

Esempio 8. Esempio di LibraryRepositories.prefs.json
{
  "storages": [
    {
      "name": "LocalStorage",
      "kind": "FileSystem",
      "rootDirectory": "D:\\GoLibRepo"
    }
  ],
  "c4LibraryRepositories": [
    { "name": "LocalRepository",
      "isPublic": true,
      "kind": "Local",
      "storage": "LocalStorage"
    }
  ]
}


Per ulteriori informazioni, consultare quanto segue: Libraries.json E Risolvi le librerie, Risolvi tutte le librerie

Librerie – Formato di archiviazione su disco rigido

I repository delle librerie vengono gestiti tramite l'infrastruttura del server di distribuzione, utilizzando il modulo di archiviazione locale per i repository locali. Il formato sul disco rigido è quindi definito canonicamente dal server di distribuzione, ma è semplice e viene riprodotto qui per completezza.

La gerarchia delle cartelle all'interno del repository è strutturata come segue: Company/Title/Version/FileName.Suffix

Company

IL Company voce dalle informazioni del progetto

  • Gli spazi iniziali e finali vengono eliminati.

  • I separatori , (, E ) non sono consentiti.

  • Alcuni caratteri speciali, inclusi i caratteri di controllo, vengono codificati utilizzando la codifica a modello oggetto.

    Alcuni caratteri speciali, in particolare i caratteri di controllo non stampabili, non vengono memorizzati direttamente, ma sono rappresentati da una stringa speciale del modello a oggetti.

Title

IL Title voce dalle informazioni del progetto

  • Gli spazi iniziali e finali vengono eliminati.

  • I separatori , (, E ) non sono consentiti.

  • Alcuni caratteri speciali, inclusi i caratteri di controllo, vengono codificati utilizzando la codifica a modello oggetto.

Version

IL Version voce dalle informazioni del progetto

  • Deve trattarsi di una versione semantica (semver) valida a 4 parti.

  • Le designazioni di pre-release fanno parte della versione. Non si tratta di metadati di build perché non fanno parte dell'identità.

  • La quarta parte numerica della versione viene scritta solo se diversa da 0.

FileName

Identico a Title

Suffix

Uno dei 4 suffissi consentiti:

  • .compiled-library

  • .compiled-library-ge33

  • .compiled-library-v3

  • .fbslibpack

Questo formato consente di individuare facilmente una libreria specifica, nonché di sfogliare tutte le versioni disponibili di una libreria senza bisogno di file di indice.

Configurazione semplice

Nel localRepositories sezione, si specifica un repository locale come "Name": "Path" coppia. Al primo avvio, un repository denominato Default verrà creato.

Esempio 9. Esempio di localRepositories sezione
{  
    "localRepositories": {
        "AllLibs": "D:\\C4LibRepo",
        "Default": "C:\\Users\\h.mustermann\\AppData\\Local\\CODESYS-4\\managed-libraries"
    }
}
...


Sovrapposizione e soppressione

Il livello specifico dell'utente eredita le definizioni del livello di sistema e le estensioni. Questo servizio di opzioni viene utilizzato per sovrapporre tali definizioni.

  • Ereditare Salvo diversa indicazione, le definizioni ereditate rimangono invariate.

  • Estendere: un nome di sezione preceduto da + estende l'elenco ereditato invece di sostituirlo, ad esempio "+storages".

  • Sopprimere: Il valore null senza virgolette sopprime una definizione ereditata. Ecco come disabilitare un repository ereditato o il Default repository.

Esempio 10. Esempio
{  
    "localRepositories": {
        "AllLibs": "/home/mustermann/allLibs",    
        "_Extension_ExampleExtension_1.2.3.4": null  
    }
}
...

Nell'esempio, il AllLibs il repository è definito e le librerie fornite dal ExampleExtension Le estensioni nella versione 1.2.3.4 sono soppresse.



Per ulteriori informazioni, consultare quanto segue: Ripristino e cache della libreria E Risoluzione delle dipendenze di libreria

In questa sezione: