Creating library configuration

The library configuration defines the layout for the library to be created (e.g. folder of the library) and the elements to be integrated (e.g. the user blocks).

How to create a library configuration:

Select a folder within the →project in which you want to create the library configuration.
In menu File or from the context menu of the folder, select New and the command Library Configuration.
Result: The project explorer displays the library configuration (with icon ). The editor for the library configuration is opened for this library configuration.
Adjust the already existing settings for the library configuration according to your requirements.

Example for library configuration

The following example results in a created library:

being of type LOGICAD (see "Creating and deploying a custom library" for the possible library types)
being a snapshot library (see "Arbeitsabläufe: Snapshot-Bibliotheken und/oder finalisierte Bibliotheken erstellen/verwenden" for details)
containing the following:
- 2 folders – see the statements FOLDER ...
- 4 blocks in total – see the statements IEC := ...
- files for the external block help – see the statements FILE := ... directly following the statements for the blocks
- binaries, include and source files – see the statements beginning with BINARY_LIBRARIES

LIBRARY com.CompanyA.Controller   (* The library is created with the name 'com.CompanyA.Controller__1.1.0-SNAPSHOT.zip'. *)

  VERSION := 1.1.0-SNAPSHOT;

  PACKAGETYPE := zip;

  FOLDER "Motors"   (* The library contains the folder 'Motors' and the sub-folder 'Testing'. Hence, the ZIP-file contains: FOLDER\Motors\Testing *)

    IEC := com.CompanyA.Controller.Motor1;  (* 'Motors" will contain the files 'com.CompanyA.Controller.Motor1' and 'com.CompanyA.Controller.Motor2'. *)

    IEC := com.CompanyA.Controller.Motor2;

    FILE := ".olh\com.CompanyA.Controller.Motor1.EN.html", SOURCEPATH := "src/";     (* The files for the external block help for 'Motor1' and 'Motor2' - in English. *)

    FILE := ".olh\Motor1.png", SOURCEPATH := "src/";

    FILE := ".olh\com.CompanyA.Controller.Motor2.EN.html", SOURCEPATH := "src/";

    FILE := ".olh\Motor2.png", SOURCEPATH := "src/";

    FILE := ".olh\style.css", SOURCEPATH := "src/";

    FOLDER "Testing"                        (* 'Testing" will contain the files 'com.CompanyA.Controller.Test1' and 'com.CompanyA.Controller.Testr2'. *)

      IEC := com.CompanyA.Controller.Test1;

      IEC := com.CompanyA.Controller.Test2;

      FILE := ".olh\com.CompanyA.Controller.Test1.EN.html", SOURCEPATH := "src/";     (* The files for the external block help for 'Test1' and 'Test2' - in English. *)

      FILE := ".olh\Test1.png", SOURCEPATH := "src/";

      FILE := ".olh\com.CompanyA.Controller.Test2.EN.html", SOURCEPATH := "src/";

      FILE := ".olh\Test2.png", SOURCEPATH := "src/";

      FILE := ".olh\style.css", SOURCEPATH := "src/";

    END_FOLDER

  END_FOLDER

  BINARY_LIBRARIES FOR BuiltInPlc    (* Moreover, the library will contain some binaries, include and source files as well. *)

    FILE := "libs\mathlib.lib";

  END_BINARY_LIBRARIES

  BINARY_OBJECTS FOR BuiltInPlc

    FILE := "libs\mathlib.o";

  END_BINARY_OBJECTS

  INCLUDES

    FILE := "h\mathlib.h";

  END_INCLUDES

  SOURCES

    FILE := "code.c" , SOURCEPATH := "c";

  END_SOURCES

END_LIBRARY

See under "Syntax for library configuration" and "Example: Creating library with blocks incl. help files" for explanations of the statements.

Save the library configuration: e.g. menu File, Save

Representation/actions within editor for a library configuration

The contents of a library configuration is displayed within an editor similar to the ST-editor. Subsequently, you are able to use the features of the ST-editor (e.g. Inhaltshilfe (Code-Assistent oder "Content Assist")) within the editor for a library configuration as well.
You are able to apply the actions within ST-editor to a large part within the editor for a library configuration. Just select a command within the editor for a library configuration. If the result is not to your liking, undo the action (menu Edit, Undo).
However, the editor for a library configuration supports a different syntax than the ST-editor. See "Syntax for library configuration" for the correct syntax within the editor for a library configuration.