Skip to main content

Repositorio de la biblioteca

Cuando CODESYS 4 Cuando se instala, también se instalan varias extensiones. Cada extensión puede contener un repositorio de biblioteca. Estos repositorios de biblioteca se activan y están disponibles automáticamente. No es necesario introducirlos en el LibraryRepositories.prefs.json archivo.

Creación de repositorios de bibliotecas propios

En CODESYS 4 Puedes crear tantos repositorios de bibliotecas propios como desees. 

Los repositorios personalizados se configuran en el LibraryRepositories.prefs.json archivo. En Linux, este archivo se encuentra en ~/.config/CODESYS-4/LibraryRepositories.prefs.json En Windows, este archivo se encuentra en %APPDATA%\CODESYS-4\LibraryRepositories.prefs.json El formato de la configuración del repositorio lo define el servidor de despliegue.

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


Para obtener más información, consulte lo siguiente: Libraries.json y Resolver bibliotecas, Resolver todas las bibliotecas

Bibliotecas: formato de almacenamiento en disco duro

Los repositorios de la biblioteca se gestionan mediante la infraestructura del servidor de despliegue, donde se utiliza el módulo de almacenamiento local para los repositorios locales. Por lo tanto, el formato en el disco duro está definido de forma estándar por el servidor de despliegue, pero es sencillo y se reproduce aquí para mayor claridad.

La jerarquía de carpetas dentro del repositorio está estructurada de la siguiente manera: Company/Title/Version/FileName.Suffix

Company

El Company Entrada de la información del proyecto

  • Se eliminan los espacios iniciales y finales.

  • Los separadores , (, y ) No están permitidos.

  • Algunos caracteres especiales, incluidos los caracteres de control, se codifican mediante la codificación del modelo de objetos.

    Ciertos caracteres especiales, en particular los caracteres de control no imprimibles, no se almacenan directamente, sino que se representan mediante una cadena especial del modelo de objeto.

Title

El Title Entrada de la información del proyecto

  • Se eliminan los espacios iniciales y finales.

  • Los separadores , (, y ) No están permitidos.

  • Algunos caracteres especiales, incluidos los caracteres de control, se codifican mediante la codificación del modelo de objetos.

Version

El Version Entrada de la información del proyecto

  • Debe tratarse de una versión semántica válida de 4 partes.

  • Las designaciones de prelanzamiento forman parte de la versión. Esto no son metadatos de compilación porque no forman parte de la identidad.

  • La cuarta parte numérica de la versión solo se escribe si no es 0.

FileName

Idéntico a Title

Suffix

Uno de los 4 sufijos permitidos:

  • .compiled-library

  • .compiled-library-ge33

  • .compiled-library-v3

  • .fbslibpack

Este formato permite localizar fácilmente una biblioteca específica, así como explorar todas las versiones disponibles de una biblioteca sin necesidad de archivos de índice.

Configuración sencilla

Introduzca un repositorio local en la sección localRepositories en pareja "Name": "Pfad" . Al iniciar por primera vez, un repositorio con el nombre Default presentado.

ejemplo 9. Ejemplo de la localRepositories sección
{  
    "localRepositories": {
        "AllLibs": "D:\\C4LibRepo",
        "Default": "C:\\Users\\h.mustermann\\AppData\\Local\\CODESYS-4\\managed-libraries"
    }
}
...


Superposición y supresión

El nivel específico del usuario hereda las definiciones de la capa del sistema y las extensiones. Este servicio de opciones se utiliza para superponer dichas definiciones.

  • Heredar A menos que se especifique lo contrario, las definiciones heredadas permanecen sin cambios.

  • Extender: un nombre de sección precedido por + amplía la lista heredada en lugar de reemplazarla, por ejemplo "+storages".

  • Reprimir: El valor null Sin comillas suprime una definición heredada. Así es como se desactiva un repositorio heredado o el Default repositorio.

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

En el ejemplo, el AllLibs El repositorio está definido y las bibliotecas proporcionadas por el ExampleExtension Las extensiones en la versión 1.2.3.4 están suprimidas.



Para obtener más información, consulte lo siguiente: Restaurar y caché de la biblioteca y Resolución de dependencias de bibliotecas