Bibliothek ins Standard-Repository installieren

Kompilierte PLC-Bibliotheken lassen sich per Automation Interface in das Standard-Repository installieren. Das ermöglicht automatisierte Build-Prozesse, die Bibliotheken vor dem Kompilieren bereitstellen müssen.

Der Aufruf erfolgt über InstallLibrary auf dem References-Knoten des PLC-Projekts. Die Methode erwartet den Repository-Namen, den Dateipfad zur Bibliothek und einen booleschen overwrite-Parameter. Mit overwrite = false bricht der Aufruf ab, wenn die Bibliothek bereits installiert ist. Mit overwrite = true wird eine vorhandene Version überschrieben. Der Repository-Name "System" verweist auf das Standard-Repository von TwinCAT.

Voraussetzungen

TwinCAT XAE ist installiert und gestartet.
Eine DTE-Verbindung zur Zielinstanz ist aktiv.
ITcSysManager ist in einem STA-Thread initialisiert.
Eine kompilierte Bibliothek liegt als .compiled-library- oder .library-Datei vor.
Ein PLC-Projekt mit einem References-Knoten ist in der Solution vorhanden.

C# Beispiel

ITcSmTreeItem references = sysManager.LookupTreeItem(@"TIPC^PLC1^PLC1 Project^References");

// Install into the default repository
references.InstallLibrary(
    "System",                                 // repository name
    @"C:\Libraries\MyLib_A.compiled.library", // library file path
    false);                                   // do not overwrite

PowerShell Beispiel

# Look up the References node of the PLC project
$references = $sysManager.LookupTreeItem("TIPC^Untitled1^Untitled1 Projekt^References")

# Install library into the default repository ("System")
# Parameters: repository name, file path, overwrite (bool)
$references.InstallLibrary("System",
    "C:\Libraries\MyLib_A.compiled.library",
    $false)   # $false = do not overwrite if already installed