Quellcodeverwaltung

Locus funktioniert ohne Quellcodeverwaltung. Wenn Unreal einen aktiven Anbieter hat, wendet Locus entsprechend dem Besitz jedes Inhaltstyps anbieterbewusste Regeln an.

Der Besitz bestimmt das Anbieter-Verhalten

Inhalt	Verhalten des Anbieters
Gemeinsame Notizen	Bei neuen Dateien zum Hinzufügen markieren; bei kontrollierten Dateien expliziter Checkout, Status und sicheres Löschen
Private Notizen	Keine Anbieterabfrage oder -operation
Gemeinsame Pins	Bei neuen Dateien zum Hinzufügen markieren; bei kontrollierten Dateien expliziter Checkout, Status und sicheres Löschen
Private Pins	Keine Anbieterabfrage oder -operation
Dokumente	Projekt-eigen; zunächst Nicht verfolgt, dann ausdrücklich zum Hinzufügen markieren; bei kontrollierten Dateien Checkout, Status und sicheres Löschen

Privat bedeutet, dass die Inhalte lokal im Saved-Bereich des Projekts gespeichert werden. Locus fragt den Anbieter für private Notizen und Pins niemals ab und nimmt dort keine Änderungen vor.

Lokaler Modus

Wenn kein Anbieter konfiguriert ist, wechselt Locus in den lokalen Modus. Lokale und nicht verfolgte Dateien können ohne Warnungen des Anbieters oder Hintergrundaufrufe bearbeitet werden. Notizen, Pins und Dokumente zeigen keinen Anbieterstatus, Indikator, Tooltip, Anleitung, Zum Hinzufügen markieren- oder Auschecken-Angebot. Geteilte Inhalte verbleiben in den projekteigenen Roots.

Ein konfigurierter, aber nicht verfügbarer Anbieter ist eindeutig und schützt bekannte kontrollierte Inhalte. Sofern verfügbar, verwendet die Statusleiste das standardmäßige Revisionskontrollsymbol von Unreal. Quellcodeverwaltungsstatus anzeigen steuert nur kompakte Reihenindikatoren; Sauber verfolgte Reihen bleiben ruhig, wo dokumentiert.

Checkout und schreibgeschützte Zustände

Durch das Auswählen, Öffnen oder Lesen sauber kontrollierter Inhalte wird dieser nicht ausgecheckt. Ein Shared Notiz erfordert explizites Auschecken. Eine unterstützte Mutation eines kontrollierten Shared Pin fordert den Checkout automatisch an und wird nur dann fortgesetzt, wenn dies zulässig ist. Ein Fehler lässt es geschützt.

Kontrollierte Dokumente bleiben lesbar, aber ihre maßgeblichen Markdown-Aktionen Bearbeiten und Speichern bleiben nicht verfügbar, bis der Checkout erfolgreich ist. Derselbe Schutz gilt, wenn eine kontrollierte Datei von einem anderen Benutzer oder Client ausgecheckt, veraltet, von ihrem erforderlichen Anbieter getrennt oder in einem von Locus nicht prüfbaren Zustand ist. Kopie exportieren bleibt bei Dokumenten, wo anwendbar, verfügbar.

Nach der Wiederverbindung des Anbieters aktualisieren Sie Quellcodeverwaltung oder Locus, falls nötig. Der kontrollierte Status kehrt zurück, aber eine saubere Datei bleibt schreibgeschützt, bis sie ausdrücklich ausgecheckt wird.

Locus bietet für eine schreibgeschützte kontrollierte Datei keinen unsicheren Umgehungsweg zum Schreibbarmachen.

Neue Dateien und Zum Hinzufügen markieren

Neue freigegebene Notizen behalten ihre Zum Hinzufügen markieren-Anfrage nach der Erstellung; Bei einem Fehler bleibt die gültige Datei für einen erneuten Versuch übrig. Neue freigegebene Pins bleiben Untracked, bis sie explizit hinzugefügt werden, einschließlich berechtigter Mehrfachauswahl. Ein freigegebener Pin-Snapshot ist ein separates Bild mit einem eigenen Hinzufügen- oder Auscheckstatus.

Neue Dokumente bleiben absichtlich Nicht verfolgt. Erstellen, organisieren, umbenennen, verschieben und bearbeiten Sie das Dokument zuerst und wählen Sie Zum Hinzufügen markieren, wenn der endgültige Pfad feststeht. Ein nicht verfolgtes Dokument kann umbenannt oder verschoben werden, sofern dies sonst sicher ist. Ein zum Hinzufügen markiertes oder bereits kontrolliertes Dokument kann durch Locus nicht umbenannt oder verschoben werden, weil Locus keinen anbieterneutralen transaktionalen Verschiebevorgang garantieren kann. Es verwendet keinen Umweg über Schreibbarmachen und fordert Sie nicht auf, die Quellcodeverwaltung zu deaktivieren. Ein lokales Dokument wird erst nach dem Hinzufügen und Submit über den normalen Workflow des Projekts mit Teammitgliedern geteilt. Nach dem Submit ist die Datei kontrolliert und verwendet für spätere Änderungen Auschecken; sie wird nicht erneut zum Hinzufügen markiert.

Löschen

Das Löschen erfordert eine Bestätigung. Bei kontrollierten Dateien prüft Locus den gemeldeten Status und leitet das Löschen über den Anbieter, bevor lokal bereinigt wird. Das Löschen wird blockiert, wenn ein anderer Benutzer den Checkout besitzt, die Datei veraltet ist oder die Sicherheit nicht festgestellt werden kann.

Hinweise zu Perforce

Perforce ist der Anbieter mit der aktuellen Validierungsevidenz des Projekts. Eine übliche Typemap-Auswahl für gemeinsame Notizen und Pins ist:

text+l //....uenote
text+l //....locuspin

Damit werden die JSON-basierten Dateien als Text mit exklusiver Sperre behandelt. Markdown-Dokumente sind normale Textdateien; wählen Sie die .md-Richtlinie, die zum Repository passt. Locus bearbeitet die Perforce-Typemap nicht für Sie.

Andere Unreal-Anbieter der Quellcodeverwaltung werden für 1.0 ohne Gewähr unterstützt und sind nicht validiert. Prüfen Sie das Anbieterverhalten zunächst in einem Testprojekt, bei dem ein Datenverlust unproblematisch wäre.

Perforce ist der live-zertifizierte Anbieter für 1.1. Bei anderen Unreal-Quellcodeverwaltungsanbietern handelt es sich um Best-Effort-Anbieter, die nicht validiert sind. Testen Sie sie in einem Einwegprojekt.

Wiederherstellung und externe Konflikte

Wiederherstellungs-Snapshots schützen ungespeicherte lokale Arbeit und ersetzen keine Quellcodeverwaltung. Ein externer Konflikt entsteht, wenn sich der Inhalt auf der Festplatte ändert, während ein lokaler Editor ungespeicherte Änderungen hat; Locus blockiert ein stilles Überschreiben und bietet sichere Auflösungsaktionen an. Der Status „veraltet“ der Quellcodeverwaltung und Editor-Konflikte sind verwandt, aber getrennte Zustände.

Siehe die Wiederherstellungsabschnitte unter Notizen, Pins und Dokumente oder verwenden Sie Fehlerbehebung.