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