Skip to main content

Projekte von CODESYS 3 für CODESYS 4 konvertieren

In diesem Abschnitt übernehmen Sie eine Bibliothek aus CODESYS 3 nach CODESYS 4.

Kompilierte Bibliothek übernehmen

Voraussetzung: Die kompilierte Bibliothek liegt als Datei vor.

  1. Legen Sie die kompilierte Bibliothek in einem Ordner ab, den Sie aus dem Projekt heraus über einen relativen Pfad erreichen. Legen Sie die Datei alternativ in einem Bibliotheksrepository ab.

  2. Öffnen Sie die Datei Libraries.json des Projekts oder der Applikation.

  3. Ergänzen Sie einen Eintrag mit der Eigenschaft path, und geben Sie den Pfad in URI-Notation an. Die Endung der Datei bestimmt, wie die Bibliothek behandelt wird.

  4. Wählen Sie den Befehl Bibliotheken auflösen.

    Die Bibliothek wird eingebunden. und in der Datei Libraries.lock.json werden die aufgelöste Version und die SHA384-Prüfsumme eingetragen.

Quellbibliothek übernehmen

Voraussetzung:

  • Die Bibliothek kann entweder als dateibasierte FBSLIB-Datei oder als binäre LIBRARY-Datei vorliegen. Wenn die Datei als LIBRARY-Datei vorliegt, konvertieren Sie sie in CODESYS 3 zunächst mit dem Befehl Projekt konvertieren in das dateibasierte Format (FBSLIB).

  • Alle Objekte, die übernommen werden sollen, sind in Strukturiertem Text geschrieben.

  1. Prüfen Sie in CODESYS 3, ob die Bibliothek Objekte in anderen Programmiersprachen als Strukturiertem Text enthält. Übertragen Sie diese Objekte bei Bedarf nach Strukturiertem Text.

  2. Prüfen Sie, ob die Bibliothek Objekte im XML.V3-Fallback-Format enthält. Konvertieren Sie diese gegebenenfalls mit den Befehl Objekte migrieren in das native Textformat, um die Objekte in das native Textformat zu überführen. Der Vorgang ist nicht umkehrbar. Sichern Sie die Bibliothek vor dem Ausführen des Befehls.

  3. Speichern Sie die Bibliothek in CODESYS 3 mit dem Befehl Projekt speichern, und schließen Sie das Projekt.

  4. Laden Sie die FBSLIB-Datei über den Workspace in CODESYS 4 und öffnen Sie das Bibliotheksprojekt.

  5. Wählen Sie den Befehl Bibliotheken auflösen, und prüfen Sie die Meldungen.

    Die Ordner .sidecars, .auxiliaries und .FBS_Project_Related sind für das Add-on reserviert. Sie werden in CODESYS 4 nicht verwendet. Die Ordner bleiben im Bibliotheksordner liegen und gehören weiterhin nicht unter Versionsverwaltung.

Die Bibliothek wird als Bibliotheksprojekt im Workspace-Navigator angezeigt und ist editierbar. Objekte eines von CODESYS 4 nicht unterstützten Typs stehen nicht zur Verfügung. Für jedes Objekt wird eine neue Objekt-GUID erzeugt.

Häufige Probleme

Problem

Behebung

Ein Objekt wird in CODESYS 4 nicht angezeigt

Der Objekttyp wird von CODESYS 4 noch nicht unterstützt oder das Objekt ist nicht in Strukturiertem Text geschrieben.

Ein Objekt wird in einem schreibgeschützten Editor geöffnet.

Der Inhalt der Datei lässt sich nicht interpretieren. Prüfen Sie die Datei in einem Texteditor.

Eine Bibliotheksreferenz wird nicht aufgelöst.

Die Referenz stammt aus dem Bibliotheksverwalter von CODESYS 3. Tragen Sie die Referenz in der Datei Libraries.json ein.

Ein Objektname wird abgelehnt.

Der Name verstößt gegen die Namensregeln der dateibasierten Speicherung. Benennen Sie das Objekt in CODESYS 3 um und wiederholen Sie den Vorgang.

In diesem Abschnitt: