دليل نقل البيانات

في 3 حزيران (يونيو) 2020، أجرينا بعض التغييرات على "حزمة تعلّم الآلة لمنصة Firebase" بهدف تمييز واجهات برمجة التطبيقات على الجهاز فقط عن واجهات برمجة التطبيقات المستنِدة إلى السحابة الإلكترونية. تنقسم المجموعة الحالية من واجهات برمجة التطبيقات الآن إلى المنتجين التاليين:

  • منتج جديد يُعرف ببساطة باسم ML Kit ويتضمّن جميع واجهات برمجة التطبيقات على الجهاز

  • تعلُّم الآلة من Firebase، التي تركّز على واجهات برمجة التطبيقات المستنِدة إلى السحابة الإلكترونية ونشر النماذج المخصّصة.

سيؤدي هذا التغيير أيضًا إلى تسهيل دمج أدوات تعلّم الآلة في تطبيقك إذا كنت بحاجة إلى حل على الجهاز فقط. يوضِّح هذا المستند كيفية نقل تطبيقك من حزمة تطوير البرامج لـ ML Kit في Firebase إلى حزمة تطوير البرامج (SDK) الجديدة لـ ML Kit.

ما الذي سيتغيّر؟

واجهات برمجة التطبيقات الأساسية على الجهاز فقط

تمّ نقل واجهات برمجة التطبيقات التالية إلى حزمة تطوير البرامج (ML Kit) الجديدة المستقلة.

  • مسح الرمز الشريطي
  • التعرّف على الوجه
  • تصنيف الصور
  • رصد العناصر وتتبّعها
  • التعرّف على النص
  • معرِّف اللغة
  • الرد السريع
  • ترجمة
  • واجهة برمجة تطبيقات الاستنتاج في AutoML Vision Edge

إنّ واجهات برمجة التطبيقات الأساسية الحالية على الجهاز ضمن حزمة تطوير البرامج (SDK) الخاصة بحزمة تعلّم الآلة لـ Firebase تم إيقافها نهائيًا ولن تتلقّى أي تحديثات بعد ذلك.

إذا كنت تستخدم واجهات برمجة التطبيقات هذه في تطبيقك اليوم، يُرجى نقل البيانات إلى حزمة تطوير البرامج (SDK) الجديدة لحزمة تعلّم الآلة من خلال اتّباع دليل نقل بيانات أدوات تعلّم الآلة لنظام التشغيل Android ودليل نقل بيانات أدوات تعلّم الآلة لنظام التشغيل iOS.

واجهات برمجة التطبيقات للنماذج المخصّصة

لتنزيل النماذج المستضافة في Firebase، يستمر توفير أداة تنزيل النماذج المخصّصة من خلال حزمة تطوير البرامج لتعلُّم الآلة في Firebase. تجلب حزمة SDK أحدث نموذج متاح وتمرره إلى وقت تشغيل TensorFlow Lite المنفصل للاستنتاج.

إنّ أداة الترجمة الفورية للنماذج المخصّصة الحالية في حزمة تطوير البرامج (SDK) الخاصة بحزمة تعلّم الآلة لمنصة Firebase تم إيقافها نهائيًا ولن تتلقّى أي تحديثات بعد ذلك. وننصح باستخدام وقت تشغيل TensorFlow Lite مباشرةً للاستنتاج. بدلاً من ذلك، إذا كنت تريد فقط استخدام نماذج مخصّصة لتصنيف الصور وواجهات برمجة التطبيقات لاكتشاف العناصر وتتبعها، يمكنك الآن استخدام النماذج المخصّصة في واجهات برمجة التطبيقات هذه في أدوات تعلُّم الآلة مباشرةً.

اطّلِع على أدلة نقل البيانات لنظامَي التشغيل Android وiOS للحصول على تعليمات تفصيلية.

ما الذي لم يتغيَّر؟

سيستمر تقديم واجهات برمجة التطبيقات والخدمات المستنِدة إلى السحابة الإلكترونية مع تكنولوجيا "تعلُّم الآلة في Firebase":

  • لا تزال واجهات برمجة التطبيقات لتصنيف الصور والتعرّف على النص والتعرّف على المعالم والمستندة إلى السحابة الإلكترونية متاحة من حزمة تطوير البرامج لتعلُّم الآلة من Firebase.

  • تواصل تعلُّم الآلة في Firebase أيضًا توفير نشر النموذج

الأسئلة الشائعة

ما سبب هذا التغيير؟

والغرض من هذا التغيير هو توضيح الحلول التي يقدّمها هذا المنتج. في إطار هذا التغيير، تركّز حزمة تطوير البرامج (SDK) الجديدة لـ ML Kit بشكل كامل على تعلُّم الآلة على الجهاز، حيث تتم جميع عمليات معالجة البيانات على الجهاز، وتكون متاحة لمطوّري البرامج بدون تكلفة. قبل ذلك، ظلّت خدمات السحابة الإلكترونية التي كانت جزءًا من Firebase ML Kit متاحة من خلال تعلُّم الآلة في Firebase، وسيظل بإمكانك استخدامها بشكل متوازٍ مع واجهات برمجة تطبيقات ML Kit.

بالنسبة إلى واجهات برمجة التطبيقات المتاحة على الجهاز فقط، تسهّل حزمة تعلّم الآلة الجديدة على المطوّرين على المطوّرين دمج أدوات تعلّم الآلة في تطبيقاتهم. من الآن فصاعدًا، ستحتاج فقط إلى إضافة عناصر تابعة إلى مشروع التطبيق، ثم بدء استخدام واجهة برمجة التطبيقات. ليست هناك حاجة لإعداد مشروع Firebase فقط لاستخدام واجهات برمجة التطبيقات على الجهاز فقط.

ماذا يحدث لنماذجي التي تتم استضافتها في Firebase؟

وستستمر ميزة "تعلُّم الآلة من Firebase" في عرض نماذجك كما في السابق. هذه الوظيفة لا تتغير. إليك بعض التحسينات:

  • يمكنك الآن نشر نماذجك في Firebase آليًا باستخدام حِزم تطوير البرامج (SDK) للغة Python أو Node.

  • يمكنك الآن استخدام حزمة تطوير البرامج لتعلُّم الآلة من Firebase جنبًا إلى جنب مع وقت التشغيل TensorFlow Lite. تُنزِّل حزمة تطوير البرامج (SDK) لمنصة Firebase النموذج على الجهاز، ويُجري وقت تشغيل TensorFlow Lite الاستنتاج. يتيح لك ذلك اختيار إصدار وقت التشغيل الذي تفضله بسهولة، بما في ذلك الإصدار المخصص.

ما هي المزايا التي يمكنني الحصول عليها من نقل البيانات إلى حزمة تطوير البرامج (SDK) الجديدة لحزمة تعلّم الآلة؟

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

  • يمكنك الآن استخدام واجهات برمجة التطبيقات الجديدة لتصنيف الصور المخصّصة ورصد العناصر المخصّصة وتتبعها لدمج نماذج تصنيف الصور المخصّصة بسهولة في تطبيقاتك وإنشاء تجارب مستخدم تفاعلية في الوقت الفعلي.

  • تتم إضافة دعم دورة حياة Android Jetpack إلى جميع واجهات برمجة التطبيقات. يمكنك الآن استخدام addObserver لإدارة واجهات برمجة تطبيقات ML Kit وإنهاءها تلقائيًا أثناء تدوير التطبيق أو إغلاقه من قِبل المستخدم أو النظام. وهذا يجعل التكامل مع CameraX أسهل.

يمكن الاطّلاع على قائمة كاملة بأحدث التغييرات في ملاحظات إصدار حزمة تطوير البرامج (SDK) الخاصة بأداة ML Kit.

أستخدم اليوم أدوات تعلّم الآلة لمنصة Firebase، متى أحتاج إلى نقل البيانات؟

ويعتمد ذلك على واجهات برمجة تطبيقات حزمة تعلّم الآلة لمنصة Firebase التي تستخدمها حاليًا في تطبيقك.

  • إنّ واجهات برمجة التطبيقات الأساسية على الجهاز فقط لحزمة تطوير البرامج (SDK) الخاصة بحزمة تعلّم الآلة لمنصة Firebase ستستمر في العمل في المستقبل القريب. مع ذلك، لن تستفيد من الميزات والتحديثات الجديدة من خلال تأخير عملية الانتقال إلى حزمة تطوير البرامج (SDK) الجديدة لـ ML Kit. بالإضافة إلى ذلك، بمجرد تحديث المكونات الأخرى في تطبيقك، هناك خطر قد تواجه فيه تعارضات في التبعيات. وقد يحدث ذلك عندما تكون بعض العناصر التابعة الأخرى (المباشرة أو غير المباشرة) أحدث من تلك التي تتوقّعها حزمة تطوير البرامج (SDK) القديمة الخاصة بحزمة تعلّم الآلة من Firebase لبرنامج Firebase. ومن أمثلة المكتبات التي قد يحدث ذلك لها OkHttp وfirebase-common.

  • إذا كنت تستخدم واجهات برمجة تطبيقات السحابة الإلكترونية من خلال حزمة تطوير برامج (SDK) تعلّم الآلة لـ Firebase، ليس عليك إجراء أي تغيير في الوقت الحالي.

  • إذا كنت تستخدم نشر نموذج مخصّص، ننصحك بالترقية إلى أحدث إصدار يسمح بتشغيل استنتاجات البيانات مباشرةً في وقت تشغيل TensorFlow Lite.