يستهدف هذا المستند المطوّرين الذين سبق لهم إنشاء نسخة من Blockly ويبحثون عن تحديث إلى إصدار حديث من Blockly بدون تصحيح المكتبة. على الرغم من أنّ هذه المهمة تبدو شاقة، هناك بعض الخطوات التي يمكنك اتّخاذها لتسهيل العملية.
فهم عملية إلغاء التفرع
يعني استخدام الإصدار الرئيسي من Blockly أنّك تستخدم إصدارًا تم إصداره مؤخرًا من Blockly، وأنّ جميع تخصيصاتك تستخدم واجهات برمجة تطبيقات Blockly العامة بدون تعديل الرمز البرمجي. إنّ إلغاء إنشاء الإصدار المشتق هو العمل الذي عليك تنفيذه لتنفيذ وظائف المخصّصة لإصدارك المشتق باستخدام واجهات برمجة التطبيقات الأساسية.
حالات إلغاء التفرع البسيطة
في ما يلي سببان شائعان قد يكونان قد أدّيا إلى إنشاء نسخة فرعية، وحلول حول كيفية العودة إلى الإصدار الرئيسي:
- أنشأت الكتل والمولدات الخاصة بك بدون تغيير أي رمزبرمجي في Blockly: لإلغاء إنشاء الإصدار المشتق في هذه الحالة، ما عليك سوى نقل الكتل والمولدات المخصّصة من مستودع Blockly إلى رمزبرمجي تطبيقك. من المفترض أن تتمكّن بعد ذلك من تحديث إصدار Blockly.
- إضافة وظيفة مخصّصة في مساحة اسم Blockly بدون تغيير أي رمز برمجي في Blockly: على سبيل المثال، أضفت حقولًا مخصّصة أو طرقًا مساعدة لا يستخدمها سوى تطبيقك. لإلغاء إنشاء نسخة في هذه الحالة، عليك نقل هذا الرمز العميق المخصّص إلى تطبيقك خارج مستودع Blockly. بعد ذلك، من المفترض أن تتمكّن من تحديث إصدار Blockly.
حالة إلغاء التفرع على نطاق واسع
تحديد الوظيفة المُنشَقة
السبب الأخير الذي يدفع المستخدمين إلى إنشاء نسخة من Blockly هو تصحيح أخطاء Blockly لإنشاء وظائف مخصّصة يعتقدون أنّها غير مضمّنة في الإصدار الأصلي في الوقت الحالي. إذا كان الإصدار المشتق من الإصدار الأساسي متأخرًا بشكل كبير، من المحتمل أنّنا أضفنا الوظيفة التي تحتاج إليها، إما كمكوّنات إضافية أو في الإصدار الأساسي. يمكن أن يوفّر معرفة الميزات التي أضفتها في الإصدار المشتق مخطّط عمل لتحديد الميزات التي ستحتاج إلى تعديلها.
فهم البنية
بعد فهم الميزات التي تستخدم واجهات برمجة التطبيقات الخاصة بالإصدار المشتق، ننصحك باتّباع ما يلي:
- بالنسبة إلى كل ميزة تستخدم الإصدار المشتق، هل هناك طريقة لتكرارها باستخدام واجهات برمجة تطبيقات Blockly؟
- إذا تبيّن لك أنّه لا يمكنك تكرار الميزة باستخدام واجهات برمجة تطبيقات Blockly، يُرجى التواصل معنا من خلال المنتدى أو الإبلاغ عن مشكلة على GitHub. سيبدأ فريقنا بعد ذلك في التحقيق في إمكانية إضافة واجهات برمجة التطبيقات لتفعيل ميزة التخصيص.
تحديد مسار الإزالة
الخطوة التالية هي بدء عملية تنفيذ البنية الأساسية الجديدة المستندة إلى Blockly للميزات باستخدام الإصدار المشتق. هناك نهجان أساسيان يمكنك اتّباعهما:
- ترقية Blockly والاطّلاع على الأخطاء: ستظهر لك على الفور الأجزاء في الرمز البرمجي التي يجب تعديلها. يمكنك استخدام هذه المعلومات مع ما تعرف عليه من سلوك مخصّص لتوجيه عملية التطوير.
- إعادة صياغة الرمز البرمجي لفصل الميزات عن Blockly: يتطلّب ذلك اكتساب فهم عميق للميزات المخصّصة لنسختك المشتقة والميزات المستمَدة من Blockly. بعد فصل الرمز البرمجي بالكامل، استبدِل الإصدار القديم من Blockly بأحدث إصدار، ثم أصلِح أيّ مشاكل متبقّية في الدمج.
المضي قدمًا
في ما يلي بعض القواعد التي يجب اتّباعها كمطوّر تطبيقات Blockly في المستقبل:
- بشكل عام، يجب عدم إضافة فئات جديدة إلى مساحة اسم Blockly. يمكنك تسجيل حقول مخصّصة أو فئات أخرى قابلة للتسجيل بدون الإفصاح عنها داخل مستودع Blockly أو في مساحة اسم Blockly.
- يجب عدم الاعتماد على أدوات إنشاء Blockly لتجميع تطبيقك. لا نعتبر أدوات الإنشاء جزءًا من واجهة برمجة التطبيقات العامة، لذلك قد نُجري عليها تغييرات تؤدي إلى تعطُّل تطبيقك. أنت مسؤول عن تجميع تطبيقك إذا أردت ذلك.
التواصل
يمكنك التواصل مع فريق Blockly من خلال منتدى Blockly. إذا واجهت أي مشاكل أثناء عملية إلغاء التفرع، يُرجى نشرها هناك وسنساعدك في حلّها.