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

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

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

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

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

 `firebase --version`

تفعيل التجربة في واجهة سطر الأوامر (CLI) 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 CLI خطوة تجميع 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، في حزمة المحاكي المحلية، ولكن لا يمكن نشرها.
  • لا تعرض Firebase وظائف Dart خلال الإصدار التجريبي، ولكن يمكنك الاطّلاع على وظائف Dart في صفحة وظائف Cloud Run ضمن Cloud console بدلاً من ذلك.

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