Mixin

Mixin هو إطار سمة/mixin لـ Java باستخدام ASM والربط في عملية تحميل فئة وقت التشغيل عبر مجموعة من الخدمات المضمنة أو الخدمات المقدمة من المستخدم القابلة للتوصيل. تدعم الخدمات المدمجة حاليًا نظام Mojang's LegacyLauncher، على الرغم من أنه تم إهمال هذا لصالح ModLauncher بواسطة cpw، الذي يتمتع بقابلية توسعة أكبر ويدعم Java 8 والإصدارات الأحدث.

التوثيق

يمكن العثور على الوثائق الرئيسية لـ Mixin في Wiki.

يمكن العثور على وثائق إضافية للميزات الفردية والشروح في Javadoc الشامل. للحصول على مساعدة إضافية استخدم قناة #mixin على Sponge Discord Server.

الثنائيات

تتوفر ثنائيات Mixin عبر Jenkins ويتم نشرها في المستودعات المخضرمة التالية:

• https://repo.spongepowered.org/repository/maven-public/ - تصميمات SNAPHOTs والإصدارات
• https://files.minecraftforge.net/maven/ - إصدارات RELEASE فقط

الأدوات

للتعامل مع مهام التشويش، يوفر Mixin معالج التعليقات التوضيحية الذي يعمل في وقت الترجمة لإنشاء تعيينات التشويش لتطبيقها على سلسلة الأدوات الخاصة بك. في حالة استخدام Gradle 5 أو إصدار أحدث، لن يتم تحميل معالجات التعليقات التوضيحية تلقائيًا من تكوينات compile ويجب تحديدها بشكل صريح عبر تكوينات annotationProcessor . لهذا الغرض، يوفر Mixin مصنوعات "fat jar" التي تحتوي على جميع التبعيات المطلوبة عبر مصنف :processor :. على سبيل المثال، إذا كان الإصدار الخاص بك يستخدم التبعية org.spongepowered:mixin:1.2.3 ، فيجب أن يحدد تكوين annotationProcessor التبعية org.spongepowered:mixin:1.2.3:processor .

إذا كنت تستخدم Mixin في مشروع Minecraft Forge، فيمكن استخدام البرنامج الإضافي MixinGradle لتبسيط تكوين معالج Mixin Annotation. فهو يوفر صيغة بسيطة لتكوين Mixin AP لمشروعك، راجع الملف README لـ MixinGradle لمعرفة كيفية تكوين MixinGradle.

التكامل مع الكسوف

عند التطوير باستخدام Mixin ، يمكنك استخدام Mixin Annotation Processor داخل Eclipse لتوفير أخطاء وتحذيرات حساسة للسياق لمساعدتك في استكشاف أخطاء mixin وإصلاحها بسهولة أكبر. للقيام بذلك:

1. قم بتشغيل أمر gradle build لإنشاء جرة mixin
2. افتح خصائص مشروع Eclipse الخاص بك وانتقل إلى Java Compiler -> Annotation Processing -> Factory Path
3. حدد Enable project specific settings
4. انقر فوق الزر Add External JARs وحدد جرة mixin التي تم إنشاؤها باستخدام اللاحقة -processor (تلميح: يجب أن تكون في Mixin/build/libs )
5. انتقل لأعلى مستوى واحد إلى Java Compiler -> Annotation Processing
6. حدد Enable project specific settings
7. حدد خانة Enable annotation processing
8. انقر فوق الزر New... الموجود بجوار مربع Processor options

• اضبط Key على reobfSrgFile
• قم بتعيين Value على المسار المؤهل بالكامل لملف mcp-srg.srg (يختلف موقع ملف التعيين حسب النظام الأساسي، إذا لم تكن متأكدًا من مكان العثور عليه، فيرجى اتباع رابط Discord أدناه).

9. انقر فوق OK لتطبيق التغييرات

التكامل مع IntelliJ IDEA

تتوفر وظائف محسنة للعمل مع Mixin في IntelliJ IDEA عبر البرنامج الإضافي Minecraft Development for IntelliJ IDEA الذي طورته DemonWav.

تاريخ الإصدار

يعد تحديد خاصية minVersion في التكوينات الخاصة بك أمرًا في غاية الأهمية. يمكن استخدام سجل الإصدارات التالي لتحديد متى تم تقديم الميزات (وأحيانًا عندما يتم القضاء على الأخطاء الرئيسية) لمساعدتك في تحديد minVersion الذي يجب عليك تحديده.

إصدار	تاريخ	الميزات / التغييرات
0.8.3	فبراير 2021	تمت إضافة دعم محدد الهدف الديناميكي ومحدد الهدف @Desc تمت إضافة محدد هدف النمط تمت إضافة دعم أكثر تعبيرًا لمحددات الأهداف الواضحة شد الوجه والتحسينات الشاملة لjavadoc
0.8.1 (0.8.2)	سبتمبر 2020	الإصلاح العاجل لدعم ModLauncher 7.0 إصلاح المشكلة الحرجة من خلال حل الأعضاء المبهمين في الواجهات الموروثة تم التحديث إلى ASM 7.2
0.8	يناير 2020	تم التحديث إلى ASM 6.2 دعم ModLauncher تمت إضافة التعرف على Java 9 و10 دعم ForgeGradle 3+ جداول التعتيم tsrg يمكن الآن أن ترث التكوينات من التكوينات الأخرى يمكن الآن استخدام Invocation لكشف المُنشئين تحسين كبير في الإبلاغ عن السياق لاستثناءات أدوات التطبيق والمعالج المسبق غير المتوقعة، مما يسهل التشخيص عندما يختنق العميل على كود تشغيل محدد إصلاحات الشوائب ل استدعاء أعضاء mixins الوصول من داخل رمز mixin معالجة غير صحيحة للمسافات في إعلانات الهدف الصريحة سلوك غير متوقع عند محاولة إعادة توجيه المُنشئ اكتشف بشكل صحيح تداخل الوصول غير المتوافق وتجاهل الملحقات الصالحة (لا تحذر) تتوافق الآن أدوات الوصول الثابتة للواجهة مع الهدف بشكل صحيح إذا تم تحميل الواجهة قبل الفئة المستهدفة تم اكتشاف عدم تطابق ثابت للموصل بشكل صحيح والإبلاغ عنه بدلاً من التسبب في حدوث عطل تم إصلاح أخطاء المولد والحاقن المتعلقة بمعاملات الكلمات المزدوجة على المكدس الذي يحتاج إلى DUP2 تم إصلاح المشكلة في مولد LVT المطوي من FabricMC يفشل بسرعة عندما يتم إخفاء الطريقة النهائية عن طريق الخطأ بواسطة مزيج إصلاح مظهر مثيلات CallbackInfo الضالة في حاقن الالتقاط المحلي LVTs تمت إزالة تبعية Apache Commons-IO تمت إعادة تسمية ASM المظللة تحسين دقة المتغيرات المحلية لحقن التقاط المتغير المحلي بإمكان @Coerce على حاقنات رد الاتصال وعمليات إعادة التوجيه الآن حل الواجهات الفائقة بما في ذلك الواجهات المختلطة
0.7.11	يوليو 2018	إصلاحات لثلاثة أخطاء طفيفة: معالجة maxShiftBy، إصلاح البحث المسموح به وتحسينه قبل Invoc، تعطيل دمج التوقيع العام ما لم يكن برنامج إلغاء التحويل البرمجي نشطًا.
0.7.10	يونيو 2018	قم بتسجيل خطأ عندما تخضع فئة mixin لقيود أداة تحميل الفئة
0.7.9	أبريل 2018	السماح لبعض الحاقنات باستهداف طرق الخلط.
0.7.8	أبريل 2018	إصلاحات الأخطاء الخاصة بالتحقق من صحة إعلان العضو، وعمليات إعادة التوجيه غير البرية، والأخطاء الداخلية في منشئ الفئات الفرعية Args
0.7.7	مارس 2018	إصلاحات للتعامل مع مشغلات رسائل السجل لمرحلة INIT والخطأ عند التشغيل مع تكوينات المسجل غير المتوقعة أضف تحذيرات بشأن نقاط الشرائح غير الصالحة وتضييق التحويل في معالجات ModifyConstant
0.7.6	نوفمبر 2017	إصلاح الميراث لخصائص نظام السلسلة
0.7.5	أكتوبر 2017	أضف دعمًا لـ Coerce على حاقنات إعادة التوجيه.
0.7.4	سبتمبر 2017	تمت إضافة تعليق توضيحي @Dynamic لتزيين عناصر المزيج بأهداف تم حقنها ديناميكيًا.
0.7.3	أغسطس 2017	التغييرات الداخلية لتوفير الدعم modlauncher وjava 9
0.7.2	أغسطس 2017	إضافة ملف التعريف لفحص أداء mixin.
0.7.1	أغسطس 2017	إصلاحات وتحسينات على Mixin AP، وإصلاح التعامل مع المصفوفات متعددة الأبعاد وحل الأساليب في الفئات الفائقة للأنواع المشتقة من الفئات المبهمة أضف إعادة رسم خريطة وقت التشغيل لدعم استخدام تبعيات deobfCompile مع إصدارات رسم الخرائط المختلفة.
0.7	يوليو 2017	تم الآن توقيع جميع الثنائيات الرسمية الترقية إلى ASM 5.2 إضافة دعم للفئات الداخلية في Mixins يمكن أن يكون للحقن الآن أهداف واضحة متعددة @At يمكن أن يكون للتعليقات التوضيحية الآن معرف خاص بها أضف دعمًا لاستخدام @Overwrite في الأساليب غير المبهمة كطريقة للتحقق من وجود هدف الكتابة الفوقية تحسين الدعم للجسور الاصطناعية، واكتشاف طرق الجسر المتعارضة كشف وتحذير من قيم At.Shift.BY المفرطة بإمكان ModifyConstant الآن دعم شرائح متعددة إضافة السماح للحقن للكشف عن الإفراط في الحقن
0.6.15	يوليو 2017	إضافة دعم لثوابت متعددة في ModifyConstant أضف CONSTANT كنقطة حقن للأغراض العامة أضف دعمًا لإعادة توجيه الوصول إلى طول المصفوفة في معيدي توجيه الحقول
0.6.14	يوليو 2017	أضف دعمًا لاستخدام @Coerce على الأنواع المرجعية في Callback Injectors لدعم الأنواع المشتقة.
0.6.13	يوليو 2017	أضف دعمًا لمطابقة الرؤية لأساليب الكتابة الفوقية لمطابقة الفئة المستهدفة. يعمل على إصلاح المشكلات حيث تم تعديل طريقة الفئة المستهدفة بواسطة محول الوصول للحصول على رؤية أعلى
0.6.12	يونيو 2017	أضف وسيطة الشريحة إلى @ModifyConstant أضف حاقن ModifyArgs الذي يمكنه تغيير وسيطات استدعاء الأساليب المتعددة باستخدام معالج واحد.
0.6.11	يونيو 2017	إصلاح التعامل مع Unique عند وجود نفس الطريقة الفريدة في أكثر من مزيج يستهدف نفس الفئة إصلاح التعامل مع lambdas المدمجة بحيث يتم تطبيق lambdas من mixins بشكل صحيح عندما تكون lambdas موجودة بالفعل في الفئة المستهدفة (سواء في الفئة الأصلية أو عند تطبيقها بواسطة mixins السابقة)
0.6.10	مايو 2017	(0.6.9) إصلاح بسيط لإزالة الاعتماد على المساعد المهمل احترام إعادة رسم خريطة على Mixin للوارد @At تتطلب أن تكون عمليات إعادة التوجيه التي تحدث قبل الاتصال بـ superctor ثابتة
0.6.8	فبراير 2017	اسمح لـModifyConstant بربط الصفر الضمني في المقارنات
0.6.7	يناير 2017	أضف دعمًا لـ @Redirect عند الوصول إلى المصفوفة
0.6.6	يناير 2017	السماح بالطرق الثابتة في مجموعات الوصول في Java 8 والإصدارات الأحدث
0.6.5	يناير 2017	إضافة دعم لشرائح الحاقن
0.6.4	يناير 2017	السماح بالواصفات في نقاط الحقن الجديدة
0.6.3	ديسمبر 2016	دعم SourceDebugExtension
0.6.2	ديسمبر 2016	أضف دعمًا لمزيج @Pseudo (الهدف الافتراضي).
0.6.1	نوفمبر 2016	معالجة التعليقات التوضيحية للتنفيذات الناعمة في AP
0.6	أكتوبر 2016	دعم وصول Mixin
0.5.17	أكتوبر 2016	اسمح لـRedirect عن طريق الحقن باستهداف أكواد التشغيل الجديدة لإعادة توجيه المنشئ
0.5.16	أكتوبر 2016	تحسينات معالج التعليقات التوضيحية. دعم الظلال والتجاوزات في عمليات المزج متعددة الأهداف دعم بيئات التشويش القابلة للتوصيل في AP
0.5.14	سبتمبر 2016	إضافة دعم إلغاء الترجمة غير المتزامن
0.5.13	سبتمبر 2016	إضافة استراتيجية بديلة لحقن مُهيئات الحقل
0.5.10	يونيو 2016	دعم @Unique في الحقول
0.5.9	يونيو 2016	من الصعب الفشل إذا تم بالفعل تحويل هدف mixin المطلوب
0.5.8	يونيو 2016	دعم القيود على الحقن
0.5.7	يونيو 2016	أضف تعليقًا توضيحيًا فريدًا
0.5.6	مايو 2016	تغيرات البيئة، بيئة الدعم عبر الوكلاء
0.5.5	أبريل 2016	أضف حاقنModifyConstant أضف تعليقًا توضيحيًا @Debug السماح بمعالجات @ModifyArg الثابتة في أساليب المثيل
0.5.4	أبريل 2016	تتلقى معالجات الأخطاء أيضًا أخطاء تحضير mixin
0.5.3	فبراير 2016	تتوافق عن طريق الحقن تمكين hotswapper تلقائيًا إذا كان الوكيل نشطًا إصلاح مشكلات متعددة تتعلق بالأدوية العامة في معالجات التعليقات التوضيحية
0.5.2	فبراير 2016	معرف الدعم على الحقن أولوية الدعم للحقن
0.5.1	فبراير 2016	إصلاح الحاقنات، يتم الآن فحص الحاقنات من جميع الخلطات قبل معالجة أي حاقنات فعليًا. يجعل الحقن أكثر حتمية.
0.4.19	فبراير 2016	أضف دعمًا لـ @Redirect في الحقول بالإضافة إلى الأساليب
0.4.18	فبراير 2016	أضف حاقنModifyLocal
0.4.17	يناير 2016	دعم ExtraSRGs في معالج التعليقات التوضيحية تضمين المنشئين في الخريطة المرجعية أضف تعليقًا توضيحيًا @Mutable لمنع التحذيرات @Final
0.4.15	يناير 2016	قم بتضمين الأهداف السهلة في refmap
0.4.14	يناير 2016	إضافة دعم لمزيج الواجهة
0.4.13	يناير 2016	أضف تعليقًا توضيحيًا @Final
0.4.11	يناير 2016	أضف دعمًا لتجميع الحاقن والقيمة المطلوبة على مستوى التكوين
0.4.10	ديسمبر 2015	دعم إعادة تعيين وقت التشغيل باستخدام RemapperChain تجاهل محولات الفئة المزينة بـ @Resource دعم @reason و@author للتحقق من صحة عمليات الكتابة الفوقية
0.4.8	ديسمبر 2015	تم تحسين معالج التعليقات التوضيحية لدعم MixinGradle دعم بيئات التشويش المستهدفة المتعددة في refmaps
0.4.6	سبتمبر 2015	أضف مرحلة INIT للتعامل مع بدء تشغيل FML المبكر إضافة دعم لامدا في mixins إضافة دعم لاستبدال الكود الساخن في mixins تحسين دعم ميزات Java 8
0.4.4	يوليو 2015	أضف قيودًا على عمليات الكتابة الفوقية
0.4.3	مايو 2015	أضف نقطة الحقن INVOKE_ASSIGN دعم عمليات الاسترجاعات عن طريق الحاقن بدون وسيطات دعم الإكراه لأنواع المعلمات المتغيرة في عمليات الاسترجاعات دعم اقتطاع معالجات حاقن الالتقاط المحلي إلغاء تجميع الفئات المصدرة في وقت التشغيل باستخدام نبات السرخس إضافة عامل تصفية التصدير
0.4	مايو 2015	تم نقل الظل لحزمة ASM واستخدامها طوال الوقت
0.3.2	أبريل 2015	دعم معالج الأخطاء
0.3.1	أبريل 2015	دمج التعليقات التوضيحية السماح باستخدام أسماء مستعارة لأساليب الكتابة الفوقية
0.3	مارس 2015	البيئات المنفذة دعم الأسلوب الجوهري تمكين التقاط المتغير المحلي دعم الاسم المستعار
0.2	مارس 2015	تمت إضافة دعم supermixin (الخلطات الموروثة من الخلطات الأخرى)
0.1	يناير 2015	دعم Mixin الأساسي دعم الحاقن الأساسي معالج التعليقات التوضيحية