Objeto "Gestor de bibliotecasPermalink

Símbolo: _cds_icon_library_manager

El Gestor de bibliotecas enumera todas las bibliotecas integradas en el proyecto para crear aplicaciones. Proporciona información sobre el tipo de biblioteca, sus propiedades y su contenido.

Puede ampliar o contraer la lista de bibliotecas integradas, así como editar las propiedades de las bibliotecas no dependientes.

El Gestor de bibliotecas consta de tres vistas:

  • Vista superior: Lista de bibliotecas integradas

  • Vista inferior izquierda: Estructura de árbol con todos los módulos de la biblioteca seleccionados en la vista superior

  • Vista inferior derecha: Documentación del módulo seleccionado en el árbol

Lista de bibliotecas integradas

Lista de todas las bibliotecas integradas en el proyecto. Si una biblioteca depende de otras, éstas se integran automáticamente.

Se muestra en fuentes grises

La biblioteca se añadió automáticamente al proyecto mediante un plug-in.

Se muestra en fuentes negras

La biblioteca se añadió automáticamente al proyecto mediante el comando «Add Library».

«Nombre»

Visualización de la biblioteca integrada con la siguiente sintaxis:

«<nombre del marcador de posición> = <nombre de la biblioteca>, <versión> (<empresa>)»:

«<nombre del marcador de posición>»: Si se trata de una biblioteca de marcador de posición para una biblioteca, entonces el nombre del marcador de posición está antes de un « = ».

«<nombre de la biblioteca>»: Nombre de la biblioteca que se utiliza para la gestión en el repositorio de bibliotecas.

«<versión>»: Versión a la que se hizo referencia la primera vez que se integró.

«(<empresa>)»: Proveedor (opcional)

«Espacio de nombres»

Espacio de nombres para un acceso único a los contenidos de la biblioteca.

Para ello, se antepone a un identificador de módulo:

<namespace>.<identificador de módulo de biblioteca>.

El espacio de nombres suele coincidir con el nombre de la biblioteca.

Nota: Si la biblioteca tiene la propiedad ‎LanguageModelAttribute "qualified-access-only"‎, entonces usted debe acceder al módulo de la biblioteca en el código de la aplicación mediante el espacio de nombres. Se impone el acceso cualificado (único).

Puede modificar el espacio de nombres estándar para uso local (dentro del proyecto) en el cuadro de diálogo «Properties».

«Versión efectiva»

Versión de la biblioteca tras la resolución. Esta versión se utiliza en el proyecto.

Requisito: El gestor de bibliotecas existe en la vista «Devices» y se selecciona una biblioteca de marcadores de posición.

Por ejemplo: ‎3.5.10.0‎

Una biblioteca de marcadores de posición integrada debajo de una aplicación se resuelve asignando una resolución especial a la biblioteca de marcadores de posición en el cuadro de diálogo «Marcadores de posición». A continuación, se carga la biblioteca seleccionada. Las demás resoluciones se ignoran. Si no se indica una resolución especial, se comprueba si se ha especificado una resolución en la descripción del dispositivo y en el perfil de biblioteca de la aplicación. Se aplica el primer resultado de búsqueda.

_cds_icon_info

Símbolo con información sobre herramientas para notificar la resolución actual de la biblioteca seleccionada en función del dispositivo.

Ejemplo cuando el Gestor de Bibliotecas está en la vista «Dispositivos»: «Este marcador de posición se redirige explícitamente a esta versión (véase el cuadro de diálogo Marcadores de posición)»

Ejemplo cuando el Administrador de bibliotecas está en la vista «POUs»: «En el dispositivo 'Device_1', el marcador de posición se resuelve en 'VisuElemsAlarms, 1.0.0.0 (System)»

Una biblioteca de marcadores de posición integrada en la vista «POUs» se resuelve comprobando, en función de la aplicación, si se ha especificado o no una resolución en la descripción del dispositivo. A continuación, se comprueba el perfil de la biblioteca. Se utiliza la primera resolución detectada. Si ha asignado una resolución especial a la biblioteca de marcadores de posición en el cuadro de diálogo «Marcadores de posición», ésta se ignorará siempre . El resultado se muestra en el tooltip del símbolo _cds_icon_info.

_cds_icon_libman_signed_lib

Biblioteca firmada con un certificado de confianza (compatible con CODESYS >= V3 SP15)

_cds_icon_libman_signed_lib_with_deps

Biblioteca firmada con un certificado de confianza, pero que hace referencia al menos a una biblioteca no firmada.

_cds_icon_libman_signed_legacy_lib

Biblioteca firmada con una clave privada y un token (compatible con CODESYS < V3 SP15)

_cds_icon_libman_legacy_lib

Biblioteca no firmada o firmada con un certificado no fiable o caducado. En el caso de un certificado no fiable, el comando «Trust Certificate» se proporciona en el menú contextual.

_cds_icon_libman_unavailable_opt_lib

Biblioteca definida como opcional y no disponible actualmente

_cds_icon_libman_try_to_reload

Biblioteca cuyo estatus se está determinando

_cds_icon_libman_unlicensed_lib

Biblioteca con licencia para la que no se dispone actualmente de una licencia válida

_cds_icon_tampered_library

Símbolo de biblioteca para una biblioteca que no se puede cargar porque no se ha podido verificar su firma (cifrado).

Tab. 585: Comandos en el Gestor de bibliotecas

_cds_icon_libman_add_library «Añadir biblioteca»

Abre el cuadro de diálogo para seleccionar una biblioteca. Se ofrecen todas las bibliotecas instaladas en el repositorio de bibliotecas.

_icon_delete_library «Borrar biblioteca»

Elimina del proyecto la biblioteca seleccionada en ese momento.

_cds_icon_properties_library «Propiedades»

Abre el cuadro de diálogo para la visualización y edición de las propiedades de la biblioteca actualmente seleccionada.

_cds_icon_details «Detalles»

Abre un cuadro de diálogo con los detalles de la biblioteca actualmente seleccionada (información general, contenido, propiedades, información sobre la licencia).

_cds_icon_libman_try_to_reload «Intentar recargar la biblioteca»

Si selecciona una biblioteca marcada como no encontrada, puede intentar cargarla de nuevo en el proyecto utilizando este comando.

_cds_icon_libman_download «Descargar Bibliotecas desaparecidas»

CODESYS busca las bibliotecas que faltan en los servidores de descarga especificados en las opciones del proyecto.

A continuación, puede descargar e instalar la biblioteca.

_cds_icon_placeholders «Marcadores de posición»

Se abre el cuadro de diálogo «Marcadores de posición». Allí se muestra la resolución actual y puedes editarla.

_icon_library_repository «Depósito de la Biblioteca»

Abre el diálogo «Library Repository» para instalar y desinstalar bibliotecas y para definir las ubicaciones de las bibliotecas.

_cds_icon_libman_icon_legend «Leyenda del icono»

Abre el cuadro de diálogo «Information» con una leyenda de los iconos que muestran el estado actual de una biblioteca en la lista de bibliotecas integradas (véase más arriba).

_cds_icon_summary «Resumen»

Abre el cuadro de diálogo «Library Summary». Todas las bibliotecas referenciadas en el proyecto se muestran en una estructura de árbol en el cuadro de diálogo, así como las bibliotecas que hacen referencia a estas bibliotecas.

  • Comando «Mostrar todas las apariciones en la jerarquía de bibliotecas y cerrar el diálogo»: En el editor del Gestor de bibliotecas, se marcan las bibliotecas de la estructura de árbol abierta que hacen referencia o utilizan esta biblioteca. Requisito: Se selecciona una biblioteca. A continuación, se cierra el cuadro de diálogo «Information».

    Este comando también se ejecuta al hacer doble clic en una biblioteca.

Visualización de las bibliotecas

  • «Biblioteca gestionada»: Nombre y versión de la biblioteca

  • «Número de ocurrencias»: Número de lugares donde esta biblioteca es referenciada por otras bibliotecas.

Al hacer clic en «+» para una biblioteca, las bibliotecas que hacen referencia a esta biblioteca se muestran en el siguiente nivel inferior.

_cds_icon_libman_trust_cert «Certificado de confianza»

Sólo en el menú contextual de una biblioteca seleccionada en el Gestor de bibliotecas, en la que la biblioteca se ha firmado con un certificado no fiable. El comando convierte el certificado que no es de confianza en un certificado de confianza y el icono del precinto cambia de _cds_icon_libman_legacy_lib a _cds_icon_libman_signed_lib.

«Biblioteca de exportación»

Sólo en el menú contextual de una biblioteca seleccionada en el Gestor de bibliotecas: Abre el diálogo por defecto para guardar el archivo de la biblioteca en el sistema de archivos

Estructura en árbol de todos los módulos de una biblioteca seleccionada

En la estructura de árbol se enumeran todos los módulos de la biblioteca que se han integrado en ella.

Requisito: Se selecciona una biblioteca en la vista superior.

Las funciones habituales de clasificación y búsqueda están disponibles en la barra de menús.

Documentación del módulo de biblioteca seleccionado en la vista inferior izquierda

Pestaña «Entradas/Salidas»

Interfaz (entradas/salidas) del módulo de biblioteca

Pestaña «Gráfico»

Visualización gráfica del módulo

Pestaña «Documentación»

Documentación del módulo de biblioteca.

Nota: Como desarrollador de bibliotecas, debe seguir las normas de inclusión de documentación de las "Directrices para el desarrollo de bibliotecas".

Pestaña «Lista de parámetros»

Requisito: El proyecto de biblioteca contiene una lista de parámetros.

Puede modificar los valores de estos parámetros en la columna «Valor (editable)».