UVCS-Integration
MergeSight mit Unity Version Control verwenden
MergeSight ergänzt Unity Version Control um eine Unity-semantische Ansicht auf Changesets und Merge-Konflikte. Statt rohe YAML-Zeilen zu vergleichen, prüft das Team GameObjects, Komponenten, Hierarchie, Referenzen und Prefab-Overrides, bevor ein Ergebnis geschrieben wird.
Welchen UVCS-Workflow unterstützt MergeSight?
Für normale Reviews lädt MergeSight konkrete UVCS-Changesets oder den aktuellen Workspace und vergleicht die ausgewählten Revisionen. Bei einem Konflikt benötigt die 3-Way-Ansicht drei vollständige Eingaben: Base, Ours und Theirs. Der UVCS-Workspace bleibt dabei die Quelle der Wahrheit; MergeSight liefert die semantische Prüfung und den kontrollierten Schreibvorgang.
- Changeset-Review: Änderungen zwischen zwei Revisionen als Unity-Objekte lesen.
- Workspace-Review: lokale Änderungen vor Check-in oder Merge prüfen.
- Konfliktauflösung: Base/Ours/Theirs klassifizieren, Ergebnis vorschauen und validieren.
Unity-Changesets semantisch vergleichen
Ein Textdiff zeigt, welche YAML-Zeilen anders sind. Für eine belastbare Asset-Prüfung muss jedoch klar sein, ob ein GameObject verschoben, eine Komponente entfernt, eine Referenz ersetzt oder ein Prefab-Override verändert wurde. MergeSight ordnet diese Änderungen der Unity-Struktur zu und macht GUIDs und fileIDs als Referenzkontext sichtbar.
Wählen Sie immer konkrete Changeset-IDs. So bleibt das Review reproduzierbar und lässt sich im Team oder in CI auf denselben Stand beziehen.
Direktes Laden und External-Merge-Wrapper
Wenn der UVCS-Client vollständige Base-, Ours- und Theirs-Dateien bereitstellt, kann MergeSight die drei Versionen direkt öffnen. Falls der Client einen externen Merge-Befehl erwartet, übergibt ein Wrapper die temporären Dateien und den Zielpfad an MergeSight.
Diese Wege sind Alternativen, keine zusätzlichen Merge-Stufen. Entscheidend ist, dass alle drei Eingaben aus demselben Konflikt stammen und nicht manuell aus unterschiedlichen Workspace-Zuständen zusammengesucht wurden.
Einrichtung in fünf Schritten
- Text Serialization und sichtbare
.meta-Dateien im Unity-Projekt aktivieren. - UVCS-CLI installieren und den Workspace mit
cm statusprüfen. - In Unity Tools > MergeSight > VCS Integration Setup öffnen.
- Unity Version Control erkennen lassen und Review- beziehungsweise Merge-Workflow konfigurieren.
- Mit einem Test-Changeset und einem kontrollierten Szenenkonflikt prüfen, ob Revisionen, Preview und Validierung stimmen.
Sicherheitsgrenzen und Anforderungen
| Bereich | Anforderung | Verhalten |
|---|---|---|
| Assets | Textserialisierte .unity, .prefab, .asset, .mat | Unity-semantische Prüfung |
| UVCS | Gültiger Workspace und erreichbare cm-CLI | Changesets und Revisionen werden aus UVCS geladen |
| Merge | Vollständige Base/Ours/Theirs-Eingaben | Ambige oder unvollständige Fälle werden nicht geraten |
| Apply | Alle blockierenden Entscheidungen gelöst | Preview, Backup und Validierung vor beziehungsweise nach dem Schreiben |
MergeSight ersetzt weder UVCS noch Smart Locks. Es ergänzt beides, wenn parallele Änderungen tatsächlich zusammengeführt und fachlich geprüft werden müssen.
Häufige Fragen
Unterstützt MergeSight Unity Version Control direkt?
Ja. MergeSight erkennt Unity Version Control beziehungsweise Plastic-SCM-Workspaces, kann konkrete Changesets für Reviews laden und vollständige Base/Ours/Theirs-Eingaben in einen 3-Way-Workflow übernehmen. Die UVCS-CLI muss lokal verfügbar sein.
Ersetzt MergeSight den UVCS Merge Client?
Nein. UVCS bleibt das Versionskontrollsystem und verwaltet Workspace, Branches, Changesets und Locks. MergeSight ergänzt den Konflikt- und Review-Schritt um Unity-semantischen Kontext, Preview und Validierung.
Kann ich zwei UVCS-Changesets einer Unity-Scene vergleichen?
Ja. Verwenden Sie konkrete Changeset-IDs, damit der Vergleich reproduzierbar bleibt. MergeSight zeigt Objekt-, Komponenten-, Hierarchie-, Property- und Referenzänderungen statt nur YAML-Zeilen.
Funktioniert die Integration mit Smart Locks?
Ja. Smart Locks verhindern parallele Bearbeitung ausgewählter Assets; MergeSight hilft bei Reviews und bei den Konflikten, die trotz Locking oder außerhalb der Lock-Regeln entstehen.
Werden Konflikte automatisch gelöst?
Nur Entscheidungen, die die Engine als sicher einstuft, können automatisch übernommen werden. Ambige Zuordnungen und riskante Strukturänderungen bleiben explizit und blockieren das Schreiben, bis sie geprüft sind.
Fazit
UVCS bleibt die Quelle der Wahrheit
MergeSight liest Revisionen und ergänzt den bestehenden Changeset-, Branch- und Lock-Workflow.
Konkrete Revisionen verwenden
Changeset-IDs machen Reviews reproduzierbar und für Team sowie CI nachvollziehbar.
Vor dem Schreiben prüfen
Base/Ours/Theirs, Preview, Backup und Validierung reduzieren das Risiko eines still beschädigten Assets.