Skip to main content

Command: Library Repository

Symbol: _cds_icon_managed_libraries.png

Function: The command opens the Library Repository dialog. In this dialog, you define which libraries are installed on the local system and are therefore available for your application.

Call: Tools menu

Dialog: Library Repository

Table 108. Location

Display of the directory on the local system in which the library files are located

The libraries in this location are listed in the Installed Libraries area.

Edit

Opens the Edit Repository Locations dialog



Tip

  1. You can only use empty directories for new repositories.

  2. You can also use existing repositories as locations.

  3. The System repository cannot be edited. This is indicated by the italicized entry.

Table 109. Dialog: Edit Repository Locations

List of the repositories with Location and Name

Add

Creates a new repository

Opens the Repository Location dialog

The selected directory (Location input field) has to be either empty or be an existing valid repository. Name is the input field for a symbolic repository name.

Edit

Opens the Repository Location dialog (see Add)

Remove

A dialog opens, asking whether only the entry should be removed from the list of repositories, or whether the directory with the library files should be deleted from the file system. If you want to delete the directory, then you have to confirm this.



Table 110. Installed Libraries

List of the libraries in a tree structure

Display of each library with category, name, company, and version

The icon to the left of the name indicates whether the library is _cds_icon_libman_signed_lib_with_deps.png digitally signed or _cds_icon_libman_legacy_lib.png unsigned. _cds_icon_libman_source_lib.png indicates libraries in the source format which cannot be signed.

Company

List box for filtering the displayed libraries

Install

Opens the Select Library dialog

Possible filters:

  • All CODESYS libraries (*.compiled-library, *.compiled-library-v3, *.library)

  • Compiled CODESYS libraries (*.compiled-library, *.compiled-library-v3)

  • Source libraries (*.library) for uncompiled, unsignable library projects

  • All files (*.*)

Uninstall

Uninstalls the selected library

Export

Opens the default dialog for saving the library project to the local file system

The file type is Library files (*.library), Compiled library files (*.compiled-library), or Compiled library files (*.compiled-library-v3).

Find

Searches for libraries and function blocks

Opens the Find Library dialog

When you enter a string in the input field, CODESYS displays the libraries which it finds with a corresponding string.

Details

Opens the Details dialog with details from the project information of the library for the selected version of a library

You find the following information by clicking More in the Details dialog:

  • Size: Specified in bytes

  • Created: Creation date

  • Changed: Date of the last change

  • Last access: Date

  • Attributes

  • Properties

Dependencies

Opens the Dependencies dialog for the selected library, showing the dependencies on other libraries

Title, Version and Company are displayed for each library reference. References which function via placeholders are displayed according to the syntax #<placeholder name>.

Group by category

  • _cds_icon_checked.png: Grouping by library category

  • _cds_icon_option_deactivated.png: Alphabetical sorting

The categories are defined by external "*.libcat.xml" description files.



Table 111. Library Profiles

A library profile defines the library version with which a library placeholder is automatically resolved when a specific compiler version is set in the project. In version 3.5.18.0 and higher, the library profile is ignored.

Import

Imports a *.libraryprofile file

If the import already contains existing placeholder entries, then a dialog prompt opens, asking whether or not CODESYS should overwrite it.

Export

Exports an XML file with the ".libraryprofile" extension with the assignments of the selected placeholder entries

You can also select only one single entry of a Compiler version.



Tip

Placeholder resolutions can also be defined in the target device which is currently in use and even by a specific local specification in the 'Placeholders' dialog in the Library Manager.

Tip

If you want to load a project with a compiler version < 3.5.18.0, then it is advantageous to install a CODESYS with a suitable version and to start the project with it.

For more information, see: Library Manager and Library Reference Conversion

: