حالة التوافق القديم
تشرح هذه الصفحة مسارات التوافق الخاصة بالترحيل التي ما تزال متاحة عمدًا، وما الذي تم تخفيف التركيز عليه بالفعل، وما الذي يُتوقع أن يبقى على المدى الطويل.
التصنيف العام
| العنصر | الحالة الحالية | المسار الموصى به | الاتجاه المخطط |
|---|---|---|---|
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إذا بقيت ملاحظات الترحيل نظيفة - أعد تقييم هذا الهدف قبل القطع إذا بقيت أمثلة منشورة أو أدلة ترحيل أو تقارير مستخدمين تعتمد على هذه الطبقات