Kompatibilitätsmodus¶
Der Kompatibilitätsmodus ermöglicht, einzelne Artefakte oder auch einen ganzen Workspace in einer ecu.test-Version zu erstellen und sie gleichzeitig für eine andere ecu.test-Version nutzbar zu halten. So kann beispielsweise ein Package mit der aktuellsten Version von ecu.test erstellt werden, und gleichzeitig ist sichergestellt, dass es mit einer älteren ecu.test-Version ausgeführt werden kann. Das erleichtert die Zusammenarbeit in Teams, die unterschiedliche ecu.test-Versionen einsetzen.
Warnung
Auch im Kompatibilitätsmodus kann nicht garantiert werden, dass sich zwei unterschiedliche ecu.test-Versionen zu 100% identisch verhalten. Durch Änderungen an der API, im Toolverhalten, neuen Python-Versionen etc. kann es weiterhin zu Abweichungen kommen.
Aktivieren und konfigurieren¶
Die Kompatibilitäts-Einstellungen lassen sich in den Workspace-Einstellungen über finden. Im Bereich Workspace-Kompatibilität aktiviert die Option Aktiviert den Kompatibilitätsmodus. Anschließend kann die ecu.test-Version ausgewählt werden, mit der der Workspace kompatibel sein soll.
Die Einstellung wirkt sich auf neu angelegte oder geänderte Artefakte aus. Bereits vorhandene Artefakte werden nicht automatisch angepasst.
Bei neu erstellten Workspaces wird die Workspace-Kompatibilität automatisch für die aktuell verwendete ecu.test-Version aktiviert. Bereits bestehende Workspaces werden dagegen nicht automatisch angepasst. Soll für sie eine Workspace-Kompatibilität verwendet werden, muss ein Anwender diese manuell in den Workspace-Einstellungen aktivieren.
Ist der Kompatibilitätsmodus für den Workspace aktiviert, ist das in der Statusleiste sichtbar: Hinter dem Workspace-Pfad werden „Kompatibilitätsmodus“ und die eingestellte Kompatibilitätsversion angezeigt.
Der Kompatibilitätsmodus kann auch in Bibliotheksworkspaces aktiviert werden. Dazu muss der Bibliotheksworkspace selbst geöffnet werden - eine Einstellung aus dem Hauptworkspace heraus ist nicht möglich.
Artefakte kompatibel machen¶
Beim Speichern prüft ecu.test, ob ein Artefakt mit der gewählten ecu.test-Version kompatibel ist. Gibt es Elemente, die nicht in die gewählte Version konvertiert werden können, werden diese genannt. Wenn möglich, wird auch der Grund angegeben, der das Element inkompatibel macht. Gleichzeitig wird automatisch die minimale ecu.test-Version bestimmt, in der das Artefakt kompatibel gespeichert werden könnte. Der Nutzer hat dann die Möglichkeit, zu entscheiden: a) das Artefakt stattdessen in dieser Version zu speichern oder b) den Speichervorgang abzubrechen. Bei Abbruch können die inkompatiblen Elemente manuell geprüft und angepasst werden.
Dialog beim Speichern eines inkompatiblen Artefakts: Im Kompatibilitätsmodus ist die Version 2025.4 eingestellt, aber ein Testschritt ist minimal mit Version 2026.2 kompatibel.¶
In Packages lassen sich inkompatible Testschritte mit Package prüfen auch im Voraus ermitteln.
Eine Besonderheit sind Artefakte aus eingebundenen Bibliotheksworkspaces: Zunächst ist hier wichtig zu wissen, dass die im Bibliotheksworkspace eingestellte ecu.test-Version für die Prüfung ausschlaggebend ist - auch, wenn im Hauptworkspace eine andere ecu.test-Version eingestellt ist. Ist das zu speichernde Artefakt nicht kompatibel, kann es nicht gespeichert werden. Es wird keine Minimalversion wie für den Hauptworkspace vorgeschlagen. Für die Bearbeitung dieser Artefakte muss der Bibliotheksworkspace selbst geöffnet werden.
Info
Im Workspace-Explorer wird in der Spalte Kompatibilität die ecu.test-Version angezeigt, mit der ein Artefakt kompatibel ist. Diese ist per Rechtsklick auf die Spaltenüberschrift auswählbar.
Über den erweiterten Filter kann mit COMPATIBILITY nach der gespeicherten
ecu.test-Version gefiltert werden, beispielsweise mit COMPATIBILITY = "2026.3".
Migration vorhandener Artefakte¶
Zur Umstellung vorhandener Artefakte steht ein Migrationshelfer zur Verfügung. Diesen findet man über das Menü . Die Migration ist nur ausführbar, wenn der Kompatibilitätsmodus aktiviert ist.
Während der Migration wird der Workspace nach Artefakten durchsucht, deren ecu.test-Version von der eingestellten Kompatibilitätsversion abweicht. Kompatible Artefakte werden automatisch gespeichert. Nicht kompatible Artefakte und Fehler werden im Log aufgeführt.
Ein Abbruch beendet die Migration nach dem zuletzt bearbeiteten Artefakt.
Object API¶
Die Kompatibilitätsprüfung betrifft auch das Speichern über die Object API. Der Parameter „allowCompatibilityFallback“ legt fest, ob in der niedrigsten unterstützten Version gespeichert werden darf, wenn das Speichern für die ausgewählte Version nicht möglich ist. Das ist analog zum oben beschriebenen Verhalten beim Speichern von Artefakten in der GUI.
Einschränkungen¶
Testbenchkonfigurationen¶
Testbenchkonfigurationen werden derzeit nicht vollständig durch den Kompatibilitätsmodus unterstützt. Sie können daher nicht gezielt für die im Workspace eingestellte Kompatibilitätsversion gespeichert werden.
Werden Testbenchkonfigurationen ohne Aktualisierung geöffnet, bearbeitet und gespeichert, bleiben ihre bestehenden Tool- und Portdefinitionen erhalten. Dabei sollten keine Funktionen verwendet werden, die in der älteren ecu.test-Version nicht verfügbar sind.
Beim Aktualisieren eines Hosts, Tools, Ports oder der gesamten Testbenchkonfiguration werden die betroffenen Definitionen anhand der aktuell verwendeten ecu.test-Version neu eingelesen. Dabei können neue Felder oder Tooljobs hinzukommen; Eigenschaften, die in dieser Version nicht mehr vorhanden sind, können entfallen. Nach dem Speichern ist die Testbenchkonfiguration deshalb möglicherweise nicht mehr mit der zuvor verwendeten älteren Version kompatibel.
Ist im Hauptworkspace der Kompatibilitätsmodus für eine andere als die aktuelle ecu.test-Version aktiviert, erscheint vor der Aktualisierung eine Warnung über mögliche Verluste inkompatibler Eigenschaften. Wird der Dialog bestätigt (Ja), wird die Aktualisierung ausgeführt. Bei Ablehnung (Nein, vorausgewählt) oder Abbrechen findet keine Aktualisierung statt.
In referenzierten Bibliotheksworkspaces mit aktiviertem Kompatibilitätsmodus ist die Aktualisierung gesperrt; dazu muss der Bibliotheksworkspace selbst geöffnet werden.
Einstellungen für den ecu.test agent¶
Bestimmte Einstellungen für den ecu.test agent sind zwischen den ecu.test-Versionen 2025.4 und 2026.3 nur teilweise rückwärtskompatibel. Diese Einschränkung betrifft die Multimedia-Einstellungen, die man unter findet sowie das Verzeichnis für ecu.test agent Anpassungen, welches man über einstellen kann. Wird eine dieser Einstellungen verwendet, sollte in der Zielversion überprüft werden, ob die korrekten Werte übernommen wurden.