بدء استخدام حزمة تطوير البرامج التجريبية (SDK) للغة Dart

يتيح لك الدعم التجريبي للغة Dart في Cloud Functions for Firebase إنشاء تطبيقات كاملة المكدس باستخدام Flutter وDart. يمكنك التواصل مع خدمات Firebase الأخرى باستخدام حزمة Admin Dart SDK Firebaseالجديدة.

للبدء في استخدام دوال Dart، عليك تنفيذ مهام الإعداد الواردة في هذا الدليل، ثم مواصلة استكشاف دوال HTTP والدوال القابلة للاستدعاء في Dart.

المتطلبات الأساسية

تأكَّد من توفُّر إصدار من واجهة سطر الأوامر في Firebase يتيح استخدام Dart في Cloud Functions for Firebase مع العلامة ‎--version:

 `firebase --version`

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

firebase experiments:enable dartfunctions

إعداد مشروعك

  1. التشغيل:

    firebase init functions

  2. اختَر Dart كلغة.

  3. عندما يُطلب منك "هل تريد تثبيت التبعيات الآن؟"، أجِب بـ "نعم".

عرض رمز الدالة

يمكنك عرض الرمز الذي تم إنشاؤه في functions/bin/server.dart (أو نقطة الدخول). يوضّح هذا الرمز دالة HTTP بسيطة.

ملاحظة: يضبط الرمز النموذجي الحد الأقصى لعدد مثيلات الدالة helloWorld على 10 باستخدام أداة إنشاء HttpsOptions. يمكنك الاطّلاع على مزيد من المعلومات حول خيارات وقت التشغيل في مقالة ضبط خيارات وقت التشغيل.

الاختبار محليًا

firebase emulators:start

بعد تشغيل Local Emulator Suite، سيظهر لك سطر سجلّ مثل functions http function initialized (http://127.0.0.1:5001/<url>). يمكنك تحميل عنوان URL هذا في المتصفّح لاستدعاء دالة Dart التي تمت محاكاتها محليًا.

إذا عدّلت رمز Dart، سترصد Firebase Local Emulator Suite التغيير وتعيد تحميل الدالة تلقائيًا.

نشر

firebase deploy --only functions

تختلف عملية نشر دوال Dart عن دوال Node.js أو Python. بدلاً من تحميل الرمز المصدر ليتم إنشاؤه في Cloud Build، تنفّذ Firebase واجهة سطر الأوامر خطوة تجميع Dart على جهاز التطوير وتحمِّل البرنامج الثنائي الذي تم إنشاؤه مباشرةً إلى الوظائف Cloud Run.

عند اكتمال عملية النشر، سيظهر لك سطر سجلّ مثل Function URL (hello-world(us-central1)): https://hello-world-<random-hash>.<region>.run.app

يمكنك تحميل عنوان URL هذا في المتصفّح لاستدعاء دالة Dart التي تم نشرها حديثًا.

الخطوات التالية

القيود

  • يمكن نشر مشغّل onCall، ولكن لا يمكن استدعاؤه من حِزم تطوير البرامج (SDK) للعميل باستخدام طرق، مثل httpsCallable، التي تحدّد الدوال حسب الاسم. يمكنك بدلاً من ذلك استخدام طرق، مثل httpsCallableFromURL ، وتمرير عنوان URL الكامل لدالة Cloud Run.
  • يمكن تشغيل المشغّلات الأخرى، مثل مشغّلات Firestore، في Local Emulator Suite، ولكن لا يمكن نشرها.
  • لا تعرض وحدة تحكم Firebase دوال Dart خلال الإصدار التجريبي. يمكنك بدلاً من ذلك عرض دوال Dart في الـ Cloud Run functions page of the Cloud console.

إذا واجهت مشاكل أثناء استخدام دوال Dart، ننصحك بـ إرسال تقرير إلى الفريق لمساعدتنا في تحسين حزمة Dart SDK التجريبية وتوسيع نطاقها.