يتيح لك الدعم التجريبي للغة Dart في Cloud Functions for Firebase إنشاء تطبيقات كاملة المكدس باستخدام Flutter وDart. يمكنك التواصل مع خدمات Firebase الأخرى باستخدام حزمة Admin Dart SDK Firebaseالجديدة.
للبدء في استخدام دوال Dart، عليك تنفيذ مهام الإعداد الواردة في هذا الدليل، ثم مواصلة استكشاف دوال HTTP والدوال القابلة للاستدعاء في Dart.
المتطلبات الأساسية
- حزمة Dart SDK 3.9 أو إصدار أحدث
- Firebase واجهة سطر الأوامر (CLI) (الإصدار 15.15.0 أو إصدار أحدث)
تأكَّد من توفُّر إصدار من واجهة سطر الأوامر (CLI) من 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 واجهة سطر الأوامر (CLI) خطوة تجميع 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، من دالتك
- بالإضافة إلى دوال HTTP
onRequest، يمكنك تجربة نموذجonCallأوonCallمع البث نموذج لـ استدعاء الدوال مباشرةً من تطبيقك (مع العِلم بالقيود الخاصة المتعلقة بطريقة الاستدعاء).
القيود
- يمكن نشر مشغّل
onCall، ولكن لا يمكن استدعاؤه من حِزم تطوير البرامج (SDK) للعميل باستخدام طرق مثل httpsCallable، التي تحدّد الدوال حسب الاسم. يمكنك بدلاً من ذلك استخدام طرق مثل httpsCallableFromURL وتمرير عنوان URL الكامل لدالة Cloud Run. - يمكن تشغيل المشغّلات الأخرى، مثل مشغّلات Firestore، في Local Emulator Suite، ولكن لا يمكن نشرها.
- لا تعرض Firebase Console دوال Dart خلال الإصدار التجريبي. يمكنك بدلاً من ذلك عرض دوال Dart في الـ Cloud Run functions page of the Cloud console.
إذا واجهت مشاكل أثناء استخدام دوال Dart، ننصحك بـ إرسال تقرير إلى الفريق لمساعدتنا في تحسين حزمة Dart SDK التجريبية وتوسيع نطاقها.