UndoPro

unopro

undopro是一個集成到Unity的默認系統中的基於命令的撤消系統。這允許開發人員在不強迫用戶進入新的撤消工作流的情況下使用動作進行撤消/重做操作！

論壇線程

安裝

根據您如何使用dopro /分發工具的方式，您有幾個選擇。

1. Unity軟件包經理（推薦）
   轉到Unity Package Manager，添加Git URL，然後輸入：https：//github.com/seneral/undopro.git#release-pkg
   或從Release-PKG分支下載並在較早的Unity版本上從磁盤安裝
   如果您基於Undopro分發工具，您的用戶將必須先手動安裝Dunopro，然後您的工具
   但是，此選項與使用undopro的其他工具最兼容，也可以自動更新
2. 單獨安裝和分發
   第二好的選項，不要修改dovopro，只要所有涉及的工具使GUID保持完整，您就可以將其分發。但是，當Unity Break dunopro且需要進行熱門修復以使其正常工作時，您將遇到問題，但是您或其他工具仍在與您的工具一起分發舊的undopro版本
3. 嵌入到您的項目中
   絕對確保更改所有GUID，並將所有undopro代碼包裝到單獨的名稱空間中，並修改彙編定義，否則它將與其他工具衝突。
   不建議使用，因為您將僅負責確保您分發的unopro版本是最新的。
   僅當您絕對需要特定版本的undopro時，或者要在工具中使用它之前對其進行修改。

特徵

• 撤消的擴展回調：獨立撤消/重做記錄名稱，onaddundorecord，...
• 用於創建基於命令的撤消記錄的API
• 處理大多數匿名動作而沒有問題，甚至使用上下文！

它如何工作

Unity僅提供有關撤消系統的非常有限的信息：

• 當前記錄的ID，但不是唯一的，而不是穩步增加：/
• 當前記錄/組名稱（不是唯一）
• 通過反射，只有名稱（不是唯一）的完整撤消/重做堆棧
• 未編寫的回調

在內部，當調用用於添加基於命令的記錄的API時，dopro在默認系統中創建虛擬記錄。然後使用可用回調跟踪此操作，並在分別從重做堆棧或另一種方式切換時執行命令。一個很大的障礙是默認撤消系統的行為：這幾乎是不可預測的！當撤消/重做或消失時，記錄可能會在某些條件下複製。這非常困難，但是必須進行堅實的跟踪算法。顯然，還必須檢測到新記錄。

跟踪完成後，計算撤消和重做堆棧的移位值（請記住，記錄在撤消/重做過程中可能會消失或重複！）。然後對內部記錄進行相應的更新，並概述了“撤消/重做的記錄”。

在所有這些過程中，調用了indundoperformed/onredoperformed/onaddundorecord的其他回調。

基於命令的記錄的序列化

序列化也是一個很大的問題，因為行動甚至更糟的匿名動作都難以序列化。 undopro在當前場景中維護一個隱藏的，臨時的遊戲對象，該場景擁有所有需要序列化的自定義記錄。序列化是由一些包裝器類實現的，這些類別巧妙地處理了操作，對象，方法等的所有組合。

該系統甚至可以通常使用！ - >支持所有可序列化對象（unityEngine.Object和system.Object）和不可啟動的對象部分（一層可序列化的構件序列化），所有其他對像都會默認 - >支持最匿名的操作（尚未找到難以驗證的操作）！您可以完全使用上下文並參考幾乎所有本地變量（上面概述的條件適用）！

問題

這個系統似乎確實可靠，但我不聲稱它是完全防彈的！當它弄亂跟踪時，可能發生的最壞情況是，您的記錄被少量抵消（操作是在/之前/之前執行一個或兩個記錄）。目前尚未知道幸運的情況，但我對任何失敗都不承擔任何責任！如果您設法打破它，請通知我，並為我提供您所做的事情（通過問題），我嘗試解決此問題:)

安裝

只需將undopro文件夾放在項目中的某個地方，就可以了！即使它不必在編輯器文件夾中，但這並不意味著您可以在運行時使用它！在運行時將需要編輯器API的功能由預處理器檢查排除。另一方面，在編輯器文件夾中，您會發現兩個有用的窗口來測試1的功能。撤消系統本身和2。動作序列化系統。除了這些窗口外，您還可以輕鬆地調試系統，以查看它是如何通過不使用#Define undo_debug在Unpopromanager中的工作的！為了為自己的項目使用“操作序列化系統”，只需複製文件夾undopro/serializableAction以及許可證！

API

開發人員的API非常簡單。添加undopro依賴性，然後使用Unepropomanager與系統相互作用。重要元素：

• RecordOpteration andPerform-接受撤消/重做的操作以及標籤，並將其添加為記錄。此外，它將執行重做動作。
• RecordOperation（2個超載） - 接受Doundo/Redo的操作以及標籤，並將其添加為記錄。如果您已經手動執行了動作，請使用
• OnundOperformed回調 - 在執行撤消時調用。通過所有撤消記錄，如果它們被分組，則可能是多個記錄。
• onredoperformed回調 - 在執行重做時調用。通過所有重做記錄，如果它們被分組，則可以是多個記錄。
• onaddundorecord回調 - 添加記錄時，均來自undopro和默認系統。通過它的名稱以及是否被認為是“重要”（有些記錄在添加時清除了重做堆棧，有些（例如選擇更改）不會）。這也可能與添加的記錄是否包含在最後一組記錄中或打開新組（不確定）有關。
• 啟用undundopro/disaundopro-切換系統狀態。不建議禁用，因為它只會在記錄中創建一個漏洞並弄亂了以前的記錄！

建議：如果您計算了某些內容或執行了具有中間結果的任何操作，則可以很容易地設置此結果，只要結果可序列化即可。與其重新計算在撤消/重做動作中，只是在撤消動作中設置了先前的序列化結果，而在重做動作中則設置了新的動作。完畢！

作者和許可證

此擴展名是由Seneral創建的，並根據MIT許可發布（在License.MD中進一步指定）