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