Umbenennen von TwinCAT-C++ Projekten

Das Umbenennen von TwinCAT-C++ Projekten ist nicht automatisiert möglich.

An dieser Stelle wird eine Anleitung gegeben, wie ein Projekt manuell umbenannt werden kann.

Zusammenfassend kann gesagt werden, dass das C++ Projekt zusammen mit den entsprechenden Dateien umbenannt wird.

Ein Projekt „OldProject“ existiert und soll in das Projekt „NewProject“ umbenannt werden.
1. Sollten TcCOM Instanzen im Projekt existieren und diese sollen inkl. ihrer Verknüpfung erhalten bleiben, verschieben Sie diese zuerst durch Drag&Drop aus dem Projekt in System->TcCOM Objects.
2. Entfernen Sie das alte Projekt aus der TwinCAT Solution per Remove. Umbenennen von TwinCAT-C++ Projekten 1:
3. Kompilate des „OldProjekt“ können gelöscht werden. Löschen Sie hierzu im „_Deployment“ die entsprechenden .sys/.pdb Dateien.
Eine evtl. vorhandene .aps Datei können Sie ebenfalls löschen.
4. Benennen Sie das C++ Projektverzeichnis und die Projektdateien (.vcxproj, .vcxproj.filters) um.
Sollte eine Versionsverwaltung eingesetzt werden, müssen Sie dieses Umbenennen über das Versionsverwaltungssystem durchführen.
5. Sollte eine .vcvproj.user Datei existieren, kontrollieren Sie den Inhalt, hier werden Einstellungen des Nutzers abgelegt. Ggf. benennen Sie die Datei ebenfalls um.
6. Öffnen Sie die TwinCAT Solution. Binden Sie das umbenannte Projekt neu ein per Add existing Item auf dem C++ Knoten: navigieren Sie in das umbenannte Unterverzeichnis und wählen Sie dort die .vcxproj Datei aus.
7. Benennen Sie die ClassFactory, Services und Interfaces sowie Header-/Quellcode- Dateien um in den neuen Projektnamen. Benennen Sie zusätzlich die TMC-Datei und entsprechende Dateien in den Projekt-Ordnern „TwinCAT RT Files“ und „TwinCAT UM Files“ um.
Diese Umbenennung soll auch im Versionsverwaltungssystem abgebildet werden – falls das Versionsverwaltungssystem nicht in Visual Studio integriert ist, führen Sie diesen Schritt also wieder im Versionsverwaltungssystem aus. Ersetzen Sie alle Vorkommen im Quellcode (case-sensitive):
Aus „OLDPROJECT“ wird „NEWPROJECT“ und aus „OldProject“ wird „NewProject".
Nutzen Sie hierfür den Find and Replace-Dialog des Visual Studios, wobei das „NewProject Project“ im Solution Explorer ausgewählt sein muss.
Umbenennen von TwinCAT-C++ Projekten 2:

Hinweis

Inkorrekter Quellcode

Durch die einfache Umbenennung aller Vorkommen der Zeichenfolge kann es zu inkorrektem Quellcode kommen. Beispielsweise, wenn der Projektname innerhalb eines Methodennamens verwendet wird.

  • Sollten solche Vorkommen möglich sein, führen Sie die Umbenennung einzeln aus (Replace statt Replace All).

So bauen Sie das Projekt:

1. A) Sollten Instanzen aus dem Projekt existieren, aktualisieren Sie diese. Dazu machen Sie einen Rechts-Klick auf die Instanz, wählen Sie TMI/TMC File->Reload TMI/TMC File… und das umbenannte, neue TMC File aus.
Umbenennen von TwinCAT-C++ Projekten 3:
B) Alternativ führen Sie dies über System->TcCOM Objects und den Tab Project Objects durch Rechts-Klick auf die OTCID aus.
2. Verschieben Sie System->TcCOM in das Projekt.
3. Bereinigen Sie das / die Zielsystem(e).
Für TwinCAT C++ Treiber: Löschen Sie die Dateien „OldProject.sys/.pdb“ im C:\TwinCAT\3.x\Driver\AutoInstall.
Für TwinCAT Versioned C++ Projekte: Das Repository kann aufgeräumt werden unterhalb von C:\TwinCAT\3.1\Repository
4. Testen Sie das Projekt.