UndoPro

Undopro

Undopro ist ein befehlsbasiertes Rückgängigungssystem, das in das Standardsystem von Unity integriert ist. Auf diese Weise können Entwickler Aktionen für ihre Rückgänger-/Wiederherstellungsvorgänge verwenden, ohne den Benutzer in einen neuen Rückgängigmaterial zu zwingen!

Forum Thread

Installieren

Abhängig davon, wie Sie Ihr Tool verwenden möchten, haben Sie mehrere Optionen.

1. Einheitspaketmanager (empfohlen)
   Gehen Sie zu Unity Paket Manager, fügen Sie nach Git-URL hinzu und geben Sie ein: https://github.com/seneral/undopro.git#release-pkg
   Oder laden Sie von der Release-PKG-Filiale herunter und installieren Sie sie von der Festplatte in früheren Einheitsversionen
   Wenn Sie Ihr Tool auf der Basis von undopro verteilten, müssten Ihre Benutzer zuerst manuell installieren, dann Ihr Tool
   Diese Option ist jedoch am meisten mit anderen Tools mit undopropro kompatibel und kann automatisch aktualisiert werden
2. UNTERAUSEN UND SOPRO SELLSIEREN UND VERSIVE
   Zweitsbeste Optionen, ändern Sie nicht und opro und Sie können es gut verteilen, solange alle beteiligten Tools die Richtlinien intakt halten. Aber Sie werden auf Probleme stoßen, wenn die Einheit und Opro einbricht und es eine heiße Lösung benötigt, damit es funktioniert, aber Sie oder andere Tools verteilen immer noch ältere undopropro -Versionen neben Ihrem Tool
3. In Ihr Projekt einbetten
   Stellen Sie unbedingt sicher, dass Sie alle Richtlinien ändern, alle undopropro -Code in separate Namespaces einwickeln und die Montagedefinitionen ändern. Andernfalls wird er mit anderen Tools in Konflikt stehen.
   Nicht empfohlen, da Sie ausschließlich dafür verantwortlich sind, sicherzustellen, dass die von Ihnen verteilte undopro -Version auf dem neuesten Stand ist.
   Tun Sie dies nur, wenn Sie unbedingt eine bestimmte Version von undopro benötigen oder diese ändern möchten, bevor Sie sie in Ihrem Tool verwenden.

Merkmale

• Erweiterte Rückrufe für Rückgänger: separates Rückgänger/Wiederholen mit Datensatznamen, OnaddundoreCord, ...
• API zum Erstellen von Befehlsbasis undo-Datensätzen
• Behandelt die meisten anonymen Aktionen ohne Probleme, selbst wenn Sie den Kontext verwenden!

Wie es funktioniert

Unity liefert nur sehr begrenzte Informationen über das Rückgängigungssystem:

• Die ID des aktuellen Datensatzes, aber es ist nicht einzigartig, als stetig zu nimmt:/
• Der aktuelle Datensatz/Gruppenname (nicht eindeutig)
• Mit Reflexion nur den vollständigen Rückgängigmachen/Wiederherstellungsstapel mit Namen (nicht eindeutig)
• Uneredoperformierte Rückrufe

Innen erstellt undopro erstellt einen Dummy-Datensatz im Standardsystem, wenn die API zum Hinzufügen eines Befehlsbasis aufgerufen wird. Dies wird dann mit dem verfügbaren Rückruf verfolgt und die Befehle werden ausgeführt, wenn sie aus dem Wiederherstellungsstapel bzw. umgekehrt umschalten. Ein großer Hurden war das Verhalten des Standard -Rückgabesystems: Es ist fast unvorhersehbar! Datensätze können unter bestimmten Bedingungen duplizieren, wenn sie rückgängig gemacht/redone oder verschwinden. Es ist sehr schwer, aber eine Anforderung, einen soliden Tracking -Algorithmus zu erstellen. Offensichtlich muss auch die Hinzufügung neuer Aufzeichnungen erkannt werden.

Bei der Verfolgung wurde ein Verschiebungswert sowohl für rückgängig gemacht als auch für den Wiederherstellungsstapel separat berechnet (denken Sie daran, dass die Aufzeichnungen während des Rückgängigkeits/Wiederherstellungen verschwinden oder duplizieren können!). Die internen Datensätze werden dann entsprechend aktualisiert und die Aufzeichnungen zum Rückgängigmachen/Redo werden beschrieben.

Unter all dem werden die zusätzlichen Rückrufe aufgerufen, die aufgerufen wurden/Onredoperformed/OnaddundoreCord.

Serialisierung von Befehlsbasierten Datensätzen

Serialisierung ist auch ein großes Problem, da Aktionen und noch schlimmere anonyme Handlungen schwer zu serialisieren sind. Undopro unterhält ein verstecktes, temporäres GameObject in der aktuellen Szene, die alle benutzerdefinierten Datensätze enthält, die serialisiert werden müssen. Die Serialisierung wird durch einige Wrapper -Klassen erreicht, die jede Kombination für Aktionen, Objekte, Methoden usw. intelligent behandeln

Dieses System kann sogar im Allgemeinen verwendet werden! -> unterstützt alle serialisierbaren Objekte (von unityEngine.object und System.Object) und unverzählbarer Objekte teilweise (eine leichte Serialisierungselement -Serialisierung). Alle anderen Objekte erhalten standardmäßig -> stützt selbst die meisten anonymen Aktionen (noch keine nicht sertialisierbaren gefundenen Objekte)! Sie können den Kontext und die Referenz fast alle lokalen Variablen (oben beschriebene Bedingungen anwenden) voll verwenden!

Probleme

Dieses System scheint zuverlässig zu sein, aber ich behaupte nicht, dass es völlig kugelsicher ist! Der schlimmste Fall, der passieren kann, wenn es die Nachverfolgung durcheinander bringt, ist, dass Ihre Datensätze um einen kleinen Betrag ausgeglichen werden (Aktionen werden nach/früher ein oder zwei Datensätze ausgeführt). Derzeit ist zum Glück keine solche Situation bekannt, aber ich haftet nicht für Fehler! Wenn Sie es schaffen, es zu brechen, benachrichtigen Sie mich bitte darüber und geben Sie mir Informationen darüber, was Sie getan haben (durch Probleme), und ich versuche, dies zu beheben :)

Installation

Setzen Sie einfach den undopro -Ordner irgendwo in Ihr Projekt ein und Sie können loslegen! Auch wenn es nicht im Editorordner sein muss, heißt es nicht, dass Sie es zur Laufzeit verwenden können! Funktionen, die die Editor -API erfordern, werden zur Laufzeit von Präprozessorenprüfungen ausgeschlossen. Im Editorordner hingegen finden Sie zwei nützliche Fenster, um die Funktionalität von 1 zu testen. Das Rückgabesystem selbst und 2. Serialisierungssystem. Zusammen mit diesen Fenstern können Sie das System problemlos selbst debuggen, um zu sehen, wie es funktioniert, indem Sie #Define Unrückgast in undoopromanager inkonfitieren! Um einfach das Aktions -Serialisierungssystem für Ihr eigenes Projekt zu verwenden, kopieren Sie natürlich den Ordner undopro/serializableAction zusammen mit der Lizenz natürlich!

API

Die API für Entwickler ist sehr einfach. Fügen Sie die undopro -Abhängigkeit hinzu und verwenden Sie dann den UNDOPROMAGER, um mit dem System zu interagieren. Wichtige Elemente:

• Recordopteration undPerform - akzeptiert die Aktionen für Rückgänger/Wiederholung zusammen mit einem Etikett und fügt sie als Datensatz hinzu. Zusätzlich wird es die Redo -Aktion ausführen.
• Recordoperation (2 Überladungen) - akzeptiert die Aktionen für Rückgänger/Wiederherstellung zusammen mit einem Etikett und fügt sie als Datensatz hinzu. Verwenden Sie, wenn Sie die Aktion bereits manuell ausgeführt haben
• Onundoperformed Callback - genannt, als Rückgänger durchgeführt wurde. Pässt alle rückgängigen Aufzeichnungen, die bei Gruppen mehrfach sein können.
• ONREDORTOPERFORMED CALLBACK - Rufen Sie bei der Ausführung von Redo. Pässt alle redone -Datensätze, was bei Gruppen mehrfach sein kann.
• OnaddundoreCord Callback - Aufgerufen, als ein Datensatz hinzugefügt wurde, sowohl von undopropro als auch aus dem Standardsystem. Pässt seinen Namen und ob er als „wichtig“ angesehen wird (einige Aufzeichnungen löschen den Wiederherstellungsstapel, wenn Sie hinzugefügt werden, einige, wie die Auswahländerung, nicht). Dies könnte sich auch darauf beziehen, ob der hinzugefügte Datensatz in der letzten Gruppe von Datensatz enthalten ist oder ob er eine neue Gruppe eröffnet hat (ungewiss).
• Enableundopro/disababundopro - Schalten Sie den Status des Systems um. Nicht empfohlen zu deaktivieren, da es einfach ein Loch im Datensatz erstellt und vorherige Datensätze durcheinander bringen!

Empfehlung: Wenn Sie etwas berechnet oder einen Betrieb mit einem Zwischenergebnis durchgeführt haben, ist es sehr einfach, dies einzurichten, sofern das Ergebnis serialisierbar ist. Anstatt in den Rückgängig-/Wiederherstellungsaktionen neu zu berechnen, setzen Sie nur das vorherige serialisierbare Ergebnis in der undo -Aktion und der neuen in der Redo -Aktion. Erledigt!

Autor und Lizenz

Diese Erweiterung wurde von Senal erstellt und wird im Rahmen der MIT -Lizenz veröffentlicht (weiter in Lizenz.MD)