Keyboard shortcuts

Press or to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

حالة التوافق القديم

تشرح هذه الصفحة مسارات التوافق الخاصة بالترحيل التي ما تزال متاحة عمدًا، وما الذي تم تخفيف التركيز عليه بالفعل، وما الذي يُتوقع أن يبقى على المدى الطويل.

التصنيف العام

العنصرالحالة الحاليةالمسار الموصى بهالاتجاه المخطط
URootUi وURootUi::screen() وURootUi::world_2d(...) وURootUi::world_3d(...)الواجهة العامة الرسميةاستعملها مباشرةتبقى على المدى الطويل
UiSpace وUiCameraRef وUiCanvasSizeأنواع دعم رسميةاستعملها مباشرةتبقى على المدى الطويل
UScreenRootطبقة مهجورة على مسار صريح فقطURootUi::screen()يتم تقليل التركيز عليها الآن؛ وهدف الإزالة الحالي هو أول alpha بعد 0.3.0 لا يعود يحتاج دعم الترحيل المبني على هذه الطبقة
UWorldRootطبقة مهجورة على مسار صريح فقطURootUi::world_2d(size) أو URootUi::world_3d(size)يتم تقليل التركيز عليها الآن؛ وهدف الإزالة الحالي هو أول alpha بعد 0.3.0 لا يعود يحتاج دعم الترحيل المبني على هذه الطبقة
meters_per_unit = 1.0 على URootUiمفتاح توافق صريح داخل الواجهة الرسميةاستعمله فقط عندما تحتاج الحجم الفيزيائي التاريخي نفسه لجذور العالم القديمةيبقى على المدى الطويل كمفتاح اختياري صريح، لا كقصة افتراضية

ترجمة التوافق داخليًا

هذه العناصر ليست القصة العامة الموصى بها، لكنها ما تزال موجودة داخليًا بينما يستقر سطح alpha:

  • طبقات الجذور القديمة تتحول أولًا إلى مدخلات الجذر الرسمية قبل بدء حسم الكاميرا وحجم الـ canvas
  • طبقة المحاذاة scalar القديمة تتحول نحو نموذج المحاذاة الممتد قبل قرارات التمركز
  • مسار flex الرئيسي القديم ما يزال موجودًا داخليًا كتوافق، بينما تبقى حقول grow/shrink الرسمية هي المفضلة

قواعد الصيانة

  • لا تضف UScreenRoot أو UWorldRoot إلى prelude الموصى بها
  • لا تضف أمثلة جديدة تعتمد على طبقات الجذور المهجورة
  • أبقِ نصوص README ووثائق الترحيل متطابقة مع هذه الصفحة قبل كل قطع alpha

نافذة الإزالة المخططة

  • الهدف الحالي: إزالة UScreenRoot وUWorldRoot في أول alpha بعد 0.3.0 إذا بقيت ملاحظات الترحيل نظيفة
  • أعد تقييم هذا الهدف قبل القطع إذا بقيت أمثلة منشورة أو أدلة ترحيل أو تقارير مستخدمين تعتمد على هذه الطبقات

مرتبط