Skip to main content

Dépôt de bibliothèque

Quand CODESYS 4 est installé, diverses extensions le sont également. Chaque extension peut contenir un dépôt de bibliothèques. Ces dépôts de bibliothèques sont automatiquement actifs et disponibles. Il n'est pas nécessaire de les saisir dans le LibraryRepositories.prefs.json déposer.

Créer vos propres dépôts de bibliothèque

Dans CODESYS 4 vous pouvez créer autant de vos propres dépôts de bibliothèque que vous le souhaitez.

Les référentiels personnalisés sont configurés dans le LibraryRepositories.prefs.json fichier. Sous Linux, ce fichier se trouve à l'emplacement suivant : ~/.config/CODESYS-4/LibraryRepositories.prefs.json Sous Windows, ce fichier se trouve à l'emplacement suivant : %APPDATA%\CODESYS-4\LibraryRepositories.prefs.json Le format de la configuration du référentiel est défini par le serveur de déploiement.

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


Pour plus d'informations, veuillez consulter les documents suivants : Libraries.json et Résoudre les bibliothèques, Résoudre toutes les bibliothèques

Bibliothèques – Format de stockage sur disque dur

Les dépôts de bibliothèques sont gérés par l'infrastructure du serveur de déploiement, qui utilise le module de stockage local pour les dépôts locaux. Le format sur le disque dur est donc défini par le serveur de déploiement ; toutefois, par souci d'exhaustivité, il est reproduit ici.

La hiérarchie des dossiers au sein du dépôt est structurée comme suit : Company/Title/Version/FileName.Suffix

Company

Le Company entrée à partir des informations du projet

  • Les espaces en amont et en aval sont supprimés.

  • Les séparateurs , (, et ) ne sont pas autorisés.

  • Certains caractères spéciaux, notamment les caractères de contrôle, sont encodés à l'aide de l'encodage du modèle objet.

    Certains caractères spéciaux – notamment les caractères de contrôle non imprimables – ne sont pas stockés directement, mais sont représentés par une chaîne spéciale du modèle objet.

Title

Le Title entrée à partir des informations du projet

  • Les espaces en amont et en aval sont supprimés.

  • Les séparateurs , (, et ) ne sont pas autorisés.

  • Certains caractères spéciaux, notamment les caractères de contrôle, sont encodés à l'aide de l'encodage du modèle objet.

Version

Le Version entrée à partir des informations du projet

  • Il doit s'agir d'un semver valide en 4 parties.

  • Les désignations de préversion font partie de la version. Il ne s'agit pas de métadonnées de build car elles ne font pas partie de l'identité.

  • La quatrième partie numérique de la version n'est écrite que si elle est différente de 0.

FileName

Identique à Title

Suffix

L'un des 4 suffixes autorisés :

  • .compiled-library

  • .compiled-library-ge33

  • .compiled-library-v3

  • .fbslibpack

Ce format permet de localiser facilement une bibliothèque spécifique et de parcourir toutes les versions disponibles d'une bibliothèque sans fichiers d'index.

Configuration facile

Dans le localRepositories section, vous spécifiez un référentiel local en tant que "Name": "Path" paire. Lors du premier démarrage, un référentiel nommé Default sera créé.

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


Superposition et suppression

Le niveau spécifique à l'utilisateur hérite des définitions de la couche système et des extensions. Ce service d'options permet de superposer ces définitions.

  • Hériter Sauf indication contraire, les définitions héritées restent inchangées.

  • Étendre: un nom de section précédé de + étend la liste héritée au lieu de la remplacer, par exemple "+storages".

  • Réprimer: La valeur null L'absence de guillemets supprime une définition héritée. C'est ainsi que vous désactivez un dépôt hérité ou le Default dépôt.

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

Dans l'exemple, le AllLibs Le dépôt est défini et les bibliothèques sont fournies par le ExampleExtension Les extensions de la version 1.2.3.4 sont supprimées.



Pour plus d'informations, veuillez consulter les documents suivants : Restauration et cache de la bibliothèque et Résolution des dépendances de bibliothèque

Dans cette section​: