الصفحة الرئيسية>موارد بناء الموقع>موارد أخرى
تنزيل

undopros

Undopro هو نظام تراجع قائم على الأوامر مدمج في النظام الافتراضي للوحدة. هذا يسمح لـ Devs باستخدام الإجراءات لعمليات التراجع عنهم دون إجبار المستخدم على تدفق جديد!

موضوع المنتدى

ثَبَّتَ

اعتمادًا على الطريقة التي ترغب في استخدامها Undopropro / توزيع أداتك ، لديك العديد من الخيارات.

  1. مدير حزمة الوحدة (موصى به)
    انتقل إلى Manager Unity Package ، أضف بواسطة GIT URL ، وأدخل: https://github.com/seneral/undopro.git#release-pkg
    أو تنزيل من فرع الإصدار PKG والتثبيت من القرص على إصدارات الوحدة السابقة
    إذا قمت بتوزيع أداةك استنادًا إلى Undopropro ، فسيتعين على المستخدمين تثبيت Undpropro يدويًا أولاً ، ثم أدتك
    ولكن هذا الخيار هو الأكثر توافقًا مع الأدوات الأخرى التي تستخدم undopro ويمكن أيضًا التحديث تلقائيًا
  2. تثبيت وتوزيع غير معزول بشكل منفصل
    ثاني أفضل الخيارات ، لا تعدل Undopros وستتمكن من توزيعها بشكل جيد طالما أن جميع الأدوات المعنية تبقي GUIDS سليمة. لكنك ستواجه مشكلات عندما تكسر الوحدة غير المنطقية ، وهناك حاجة إلى حل ساخن لجعله يعمل ، لكنك أو الأدوات الأخرى لا تزال توزع إصدارات قديمة دون المستوى إلى جانب أدتك
  3. تضمين Undopro في مشروعك
    تأكد بالتأكيد من تغيير جميع GUIDS ، ولف جميع كود لا تُعد في مساحات أسماء منفصلة ، وكذلك تعديل تعريفات التجميع ، وإلا فسوف تتعارض مع الأدوات الأخرى.
    غير موصى به ، حيث ستكون مسؤولاً فقط عن التأكد من أن إصدار Undopro الذي تقوم بتوزيعه محدث.
    قم بذلك فقط إذا كنت بحاجة تمامًا إلى إصدار محدد من Undopro أو تريد تعديله قبل استخدامه في أدتك.

سمات

  • عروض الاسترجاعات الممتدة للتراجع: منفصلة التراجع/إعادة أسماء التسجيلات ، onaddundorecord ، ...
  • API لإنشاء سجلات التراجع المستندة إلى الأوامر
  • يتعامل مع معظم الإجراءات المجهولة دون مشاكل ، حتى باستخدام السياق!

كيف تعمل

توفر الوحدة فقط معلومات محدودة للغاية حول نظام التراجع:

  • معرف السجل الحالي ، لكنه ليس فريدًا ، بدلاً من الزيادة بشكل مطرد:/
  • السجل الحالي/اسم المجموعة (غير فريد)
  • مع الانعكاس ، مكدس التراجع الكامل/Redo فقط بالاسم (ليس فريدًا)
  • رد اتصال غير متكافئ

داخليًا ، يقوم Undopro بإنشاء سجل وهمية في النظام الافتراضي عند استدعاء API لإضافة سجل قائم على الأوامر. ثم يتم تتبع ذلك باستخدام رد الاتصال المتاح ويتم تنفيذ الأوامر عند التبديل من مكدس التراجع أو العكس على التوالي. كان القطر الكبير هو سلوك نظام التراجع الافتراضي: إنه لا يمكن التنبؤ به تقريبًا! قد تكرر السجلات في ظروف معينة عند التراجع عن/إعادة التخلص منها ، أو تختفي. إنه أمر صعب للغاية ، ولكن هناك شرط لجعل خوارزمية تتبع صلبة. من الواضح أن إضافة سجلات جديدة يجب اكتشافها أيضًا.

عند الانتهاء من التتبع ، يتم حساب قيمة التحول لكل من التراجع وإعادة المكدس بشكل منفصل (تذكر ، قد تتلاشى السجلات أو تكرارها أثناء التراجع/Redo!). ثم يتم تحديث السجلات الداخلية وفقًا لذلك ويتم تحديد السجلات للتراجع عن/إعادة.

في طريق كل هذا ، يتم استدعاء عمليات الاسترداد الإضافية onundophformed/onRedOperformed/onaddundorecord.

تسلسل السجلات القائمة على الأوامر

يعد التسلسل أيضًا مشكلة كبيرة ، حيث يصعب إجراء تصرفات مجهولة ، وأسوأ من ذلك التسلسلية. يحافظ Undopro على GameObject الخفي المؤقت في المشهد الحالي والذي يحمل جميع السجلات المخصصة التي تحتاج إلى التسلسل. يتم تحقيق التسلسل من قبل بعض فئات التفاف التي تتعامل بذكاء مع كل مجموعة للأفعال ، والكائنات ، والأساليب ، إلخ.

يمكن استخدام هذا النظام عمومًا! -> يدعم جميع الكائنات القابلة للتسلسل (من كل من UnityEngine.Object و System.Object) والكائنات التي لا يمكن التالي جزئيًا (تسلسل واحد من الأعضاء القابل للتسلسل) ، تتخلف جميع الكائنات الأخرى -> تدعم حتى معظم الإجراءات المجهولة (لا يوجد عثر عليها بعد)! يمكنك استخدام السياق والرجوع تقريبًا جميع المتغيرات المحلية تقريبًا (تنطبق الشروط المذكورة أعلاه)!

مشاكل

يبدو هذا النظام موثوقًا به ، لكنني لا أدعي أنه مقاوم تمامًا! أسوأ حالة يمكن أن تحدث عندما تفسد التتبع هي أن سجلاتك تقابلها كمية صغيرة (يتم تنفيذ الإجراءات سجل أو اثنين بعد/قبل). لا يوجد حاليًا أي موقف معروف لحسن الحظ ، لكنني لا أتحمل أي مسؤولية عن أي إخفاقات! إذا تمكنت من كسرها ، فيرجى إبلاغي بها وتزويدني بمعلومات عما فعلته (من خلال القضايا) وأحاول إصلاح هذا :)

تثبيت

ما عليك سوى وضع مجلد Undopros في مكان ما في مشروعك وأنت على ما يرام! على الرغم من أنه لا يجب أن يكون في مجلد المحرر ، فهذا لا يعني أنه يمكنك استخدامه في وقت التشغيل! يتم استبعاد الوظائف التي تتطلب واجهة برمجة تطبيقات المحرر في وقت التشغيل بواسطة الشيكات قبل المعالج. في مجلد المحرر من ناحية أخرى ، تجد نوافذ مفيدة لاختبار وظائف 1. نظام التراجع نفسه و 2. نظام التسلسل الإجراء. جنبا إلى جنب مع هذه النوافذ ، يمكنك تصحيح النظام بسهولة بنفسك لترى كيف يعمل عن طريق عدم تحديد #Define undo_debug في Undopromanager! من أجل استخدام نظام التسلسل الإجراء لمشروعك الخاص ، فقط نسخ المجلد undopro/serializableaction مع ترخيص بالطبع!

API

واجهة برمجة التطبيقات للمطورين بسيطة للغاية. أضف التبعية undopro ثم استخدم Undopromanager للتفاعل مع النظام. عناصر مهمة:

  • RecordOpterationAlderform - يقبل الإجراءات الخاصة بالتراجع عن/إعادة مع تسمية ويضيفها كسجل. بالإضافة إلى ذلك ، سوف يؤدي إجراء إعادة.
  • RecordOperation (2 Overloads) - يقبل الإجراءات للتراجع عن/إعادة مع تسمية ويضيفها كسجل. استخدم إذا قمت بالفعل بتنفيذ الإجراء يدويًا
  • رد اتصال OnundOperformed - يسمى عندما تم تنفيذ التراجع. يمر جميع السجلات التراجع ، والتي يمكن أن تكون متعددة إذا تم تجميعها.
  • رد الاتصال OnRedOperformed - يسمى عندما تم إجراء Redo. يمر جميع سجلات إعادة البيع ، والتي يمكن أن تكون متعددة إذا تم تجميعها.
  • رد اتصال OnAddundoreCord - يسمى عند إضافة سجل ، سواء من Undopro أو النظام الافتراضي. يمرر اسمه وما إذا كان يعتبر "مهمًا" (بعض السجلات مسح مكدس Redo عند إضافته ، بعضها ، مثل تغيير التحديد ، لا). يمكن أن يرتبط هذا أيضًا بما إذا كان السجل المضافة مدرجًا في المجموعة الأخيرة من السجلات أو إذا فتح مجموعة جديدة (غير مؤكد).
  • EnableDopro/DisableUndOpro - تبديل حالة النظام. لا ينصح بالتعطيل لأنه سيخلق مجرد ثقب في السجل وإفساد السجلات السابقة!

التوصية: إذا قمت بحساب شيء ما أو قمت بأي عملية بنتيجة وسيطة ، فمن السهل جدًا إعداد هذا شريطة أن تكون النتيجة قابلة للتسلسل. بدلاً من إعادة حساب في إجراءات التراجع/REDO ، حدد فقط النتيجة التسلسلية السابقة في اتخاذ إجراء التراجع والذات الجديدة في إجراء Redo. منتهي!

المؤلف والترخيص

تم إنشاء هذا التمديد من قبل Seneral وتم نشره بموجب ترخيص معهد ماساتشوستس للتكنولوجيا (تم تحديده في الترخيص. MD)

يوسع
معلومات إضافية
تطبيقات ذات صلة
نوصي لك
أخبار ذات صلة الكل