يتيح لك الدعم التجريبي للغة Dart في Cloud Functions for Firebase إنشاء تطبيقات كاملة الميزات باستخدام Flutter وDart. التواصل مع خدمات Firebase الأخرى باستخدام Firebase حزمة تطوير البرامج (SDK) الجديدة Admin Dart.
لبدء استخدام دوال Dart، عليك تنفيذ مهام الإعداد الواردة في هذا الدليل، ثم مواصلة استكشاف دوال HTTP ودوال قابلة للاستدعاء في Dart.
المتطلبات الأساسية
- الإصدار 3.9 من حزمة تطوير البرامج (SDK) للغة Dart أو إصدار أحدث
- Firebase واجهة سطر الأوامر (الإصدار 15.15.0 أو الإصدارات الأحدث)
تأكَّد من أنّ لديك إصدارًا من واجهة سطر الأوامر Firebase يتوافق مع Dart في Cloud Functions for Firebase باستخدام العلامة --version:
`firebase --version`
تفعيل التجربة في واجهة سطر الأوامر (Firebase)
firebase experiments:enable dartfunctions
إعداد مشروعك
- الجري:
bash firebase init functions - اختَر Dart كلغة.
- عندما يُطلب منك تأكيد رغبتك في تثبيت التبعيات الآن، اختر "نعم".
عرض رمز الدالة
اطّلِع على الرمز الذي تم إنشاؤه في 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 التي تم نشرها حديثًا.
الخطوات التالية
- اضبط خيارات الإعداد مثل الحد الأدنى لعدد المثيلات.
- تعرَّف على مزيد من المعلومات حول دوال HTTP والدوال القابلة للاستدعاء.
- اتّبِع الدرس التطبيقي حول دوال Dart الدرس التطبيقي حول دوال Dart
- استخدِم Dart Admin SDK التجريبي للتفاعل مع خدمات Firebase الأخرى، مثل Cloud Firestore، من دالتك
- بالإضافة إلى
onRequestدوال HTTP، يمكنك تجربةonCallنموذج أوonCallنموذج مع البث لاستدعاء الدوال مباشرةً من تطبيقك (مع ملاحظة القيد الخاص المتعلق بطريقة الاستدعاء).
القيود
- يمكن نشر مشغّل
onCall، ولكن لا يمكن استدعاؤه من حِزم SDK للعملاء باستخدام طرق مثل httpsCallable، التي تحدّد الدوال بالاسم. يمكنك بدلاً من ذلك استخدام طرق مثل httpsCallableFromURL وتمرير عنوان URL الكامل للدالة على Cloud Run. - يمكن تشغيل مشغّلات أخرى، مثل مشغّلات Firestore، في حزمة المحاكي المحلية، ولكن لا يمكن نشرها.
- لا تعرض وحدة تحكّم Firebase وظائف Dart أثناء الإصدار التجريبي. يمكنك بدلاً من ذلك عرض دوال Dart في صفحة Cloud Run الدوال في Cloudوحدة التحكّم.
إذا واجهت مشاكل أثناء استخدام وظائف Dart، ننصحك بإرسال تقرير إلى الفريق لمساعدتنا في تحسين حزمة تطوير البرامج (SDK) التجريبية من Dart وتوسيع نطاقها.