يتضمّن واجهة سطر الأوامر في Firebase محاكي Cloud Functions الذي يمكنه محاكاة أنواع الدوال التالية:
- دوال HTTPS
- الدوال القابلة للاستدعاء
- دوال الخلفية التي يتم تشغيلها من Firebase Authentication وRealtime Database Cloud Firestore وCloud Storage وCloud Pub/Sub.
يمكنك تشغيل الدوال محليًا لاختبارها قبل نشرها في قناة الإصدار العلني.
تثبيت واجهة سطر الأوامر في Firebase
لاستخدام المحاكي Cloud Functions، يجب أولاً تثبيت واجهة سطر الأوامر في Firebase من خلال اتّباع الخطوات التالية:
npm install -g firebase-tools
لاستخدام المحاكي المحلي، يجب أن يعتمد Cloud Functions على:
firebase-admin
الإصدار8.0.0
أو أحدث.firebase-functions
الإصدار3.0.0
أو أحدث.
إعداد بيانات اعتماد المشرف (اختياري)
إذا كنت تريد تفاعل اختبارات الدوال مع Google APIs أو منصة Firebase الأخرى واجهات برمجة التطبيقات عبر SDK لمشرف Firebase، قد تحتاج إلى إعداد بيانات اعتماد المشرف.
- تحتوي المُشغِّلات Cloud Firestore وRealtime Database على بيانات اعتماد كافية، ولا تتطلبان إعدادًا إضافيًا.
- أما جميع واجهات برمجة التطبيقات الأخرى، بما في ذلك واجهات برمجة تطبيقات Firebase، مثل Authentication وFCM، أو Google APIs، مثل Cloud Translation أو Cloud Speech، فتتطلب خطوات الإعداد الموضّحة في هذا القسم. ينطبق ذلك سواء كنت تستخدم واجهة Cloud Functions أو
firebase emulators:start
.
لإعداد بيانات اعتماد المشرف للدوال التي تتم محاكاتها:
- افتح جزء حسابات الخدمة من وحدة التحكم Google Cloud.
- تأكَّد من اختيار حساب الخدمة التلقائي App Engine واستخدامه. قائمة الخيارات على يسار الشاشة لاختيار إنشاء مفتاح.
- اختَر JSON لنوع المفتاح وانقر على إنشاء عندما يُطلب منك ذلك.
اضبط بيانات اعتماد Google التلقائية للتوجيه إلى المفتاح الذي تم تنزيله:
نظام التشغيل Unix
export GOOGLE_APPLICATION_CREDENTIALS="path/to/key.json" firebase emulators:start
Windows
set GOOGLE_APPLICATION_CREDENTIALS=path\to\key.json firebase emulators:start
بعد الانتهاء من هذه الخطوات، يمكن لاختبارات الوظائف الوصول إلى Firebase
واجهات Google APIs باستخدام SDK للمشرف. على سبيل المثال، عند إجراء اختبار
مشغل Authentication، فإن الدالة التي تتم محاكاتها يمكن أن تستدعي
admin.auth().getUserByEmail(email)
إعداد ضبط الوظائف (اختياري)
إذا كنت تستخدم متغيرات تهيئة الدوال المخصصة، شغِّل أولاً
للحصول على الإعدادات المخصّصة (عليك تنفيذ هذا الإجراء في دليل functions
)
في بيئتك المحلية:
firebase functions:config:get > .runtimeconfig.json # If using Windows PowerShell, replace the above with: # firebase functions:config:get | ac .runtimeconfig.json
تشغيل مجموعة المحاكي
لتشغيل المحاكي Cloud Functions، استخدِم الأمر emulators:start
:
firebase emulators:start
سيبدأ الأمر emulators:start
في تشغيل أدوات المحاكاة لـ Cloud Functions،
Cloud Firestore وRealtime Database وFirebase Hosting حسب المنتجات
الذي أعددته في مشروعك المحلي باستخدام firebase init
إذا أردت
لبدء محاكي معيّن، استخدِم العلامة --only
:
firebase emulators:start --only functions
إذا كنت ترغب في تشغيل مجموعة اختبار أو نص برمجي للاختبار بعد انتهاء أدوات المحاكاة
بدأت، استخدم الأمر emulators:exec
:
firebase emulators:exec "./my-test.sh"
استخدِم تطبيقك للتواصل مع المحاكيات
قد يتعين عليك تنفيذ إجراءات لتعزيز تفاعل تطبيقك مع المحاكيات بعض الإعدادات الإضافية.
ضبط تطبيقك للدوال القابلة للاستعانة بها
إذا كانت أنشطة النموذج الأولي وأنشطة الاختبار تتضمن دوال خلفية قابلة للاستدعاء، يمكنك ضبط التفاعل مع محاكي Cloud Functions for Firebase على النحو التالي:
Kotlin+KTX
// 10.0.2.2 is the special IP address to connect to the 'localhost' of // the host computer from an Android emulator. val functions = Firebase.functions functions.useEmulator("10.0.2.2", 5001)
Java
// 10.0.2.2 is the special IP address to connect to the 'localhost' of // the host computer from an Android emulator. FirebaseFunctions functions = FirebaseFunctions.getInstance(); functions.useEmulator("10.0.2.2", 5001);
Swift
Functions.functions().useFunctionsEmulator(origin: "http://127.0.0.1:5001")
Web
import { getApp } from "firebase/app"; import { getFunctions, connectFunctionsEmulator } from "firebase/functions"; const functions = getFunctions(getApp()); connectFunctionsEmulator(functions, "127.0.0.1", 5001);
Web
firebase.functions().useEmulator("127.0.0.1", 5001);
ضبط تطبيقك على أدوات محاكاة دوال HTTPS
سيتم عرض كل دالة HTTPS في الرمز البرمجي الخاص بك من المحاكي المحلي باستخدام تنسيق عنوان URL التالي:
http://$HOST:$PORT/$PROJECT/$REGION/$NAME
على سبيل المثال، سيتم عرض دالة helloWorld
بسيطة ذات منفذ المضيف والمنطقة التلقائيين على:
https://localhost:5001/$PROJECT/us-central1/helloWorld
خصِّص تطبيقك لمحاكاة الدوال التي يتم تشغيلها في الخلفية.
يتيح محاكي Cloud Functions الدوال التي يتم تشغيلها في الخلفية من المصادر التالية:
- محاكي "Realtime Database"
- محاكي "Cloud Firestore"
- محاكي "Authentication"
- محاكي "Pub/Sub"
لبدء أحداث في الخلفية، عليك تعديل موارد الواجهة الخلفية باستخدام Emulator Suite UI، أو من خلال ربط تطبيقك أو اختبار الرمز بالمحاكيات باستخدام SDK لنظامك الأساسي.
معالِجات اختبار الأحداث المخصّصة الصادرة عن الإضافات
للدوال التي تنفّذها للتعامل مع Firebase Extensions أحداث مخصّصة في الإصدار 2 من Cloud Functions، سيتم إقران محاكي "Cloud Functions" يتوافق محاكي Eventarc مع مشغِّلات Eventarc.
لاختبار معالِجات الأحداث المخصّصة للإضافات التي تُصدر أحداثًا، عليك تثبيت المحاكيات Cloud Functions وEventarc.
تضبط بيئة التشغيل "Cloud Functions" بيئة "EVENTARC_EMULATOR
".
إلى localhost:9299
في العملية الحالية إذا كان محاكي Eventarc
قيد التشغيل. ترتبط "Firebase Admin SDK" تلقائيًا بحدث Eventarc.
عند ضبط متغيّر بيئة EVENTARC_EMULATOR
. يمكنك
عدِّل المنفذ التلقائي كما هو موضَّح في ضبط Local Emulator Suite.
عندما يتم تكوين متغيرات البيئة بشكل صحيح، يتم تحديث Firebase Admin SDK يرسل الأحداث تلقائيًا إلى محاكي Eventarc. في المقابل، أطلقت منصة Eventarc يعيد المحاكي الاتصال بالمحاكي Cloud Functions لتشغيل أي تطبيق. المعالِجات المسجّلة.
يمكنك الاطّلاع على سجلّات الدوال في Emulator Suite UI للحصول على تفاصيل عن تنفيذ المعالج.
التفاعلات مع الخدمات الأخرى
تشتمل حزمة المحاكي على أدوات محاكاة متعددة تتيح لاختبار التفاعلات عبر المنتجات.
Cloud Firestore
إذا كانت لديك وظائف تستخدم حزمة تطوير البرامج (SDK) لمشرف Firebase من أجل الكتابة Cloud Firestore، سيتم إرسال عمليات الكتابة هذه إلى محاكي "Cloud Firestore". إذا كان قيد التشغيل. إذا تم تشغيل المزيد من الدوال بواسطة تلك الكتابة، سيتم تشغيلها في محاكي Cloud Functions.
Cloud Storage
إذا كانت لديك وظائف تستخدم حزمة تطوير البرامج (SDK) لمشرف Firebase (الإصدار 9.7.0 أو إصدار أحدث) للكتابة إلى Cloud Storage، سيتم إرسال عمليات الكتابة هذه إلى محاكي Cloud Storage. إذا كان قيد التشغيل. إذا تم تشغيل المزيد من الدوال بواسطة تلك الكتابة، سيتم تشغيلها في محاكي Cloud Functions.
Firebase Authentication
إذا كانت لديك وظائف تستخدم حزمة تطوير البرامج (SDK) لمشرف Firebase (الإصدار 9.3.0 أو إصدار أحدث) للكتابة إلى Firebase Authentication، سيتم إرسال عمليات الكتابة هذه إلى محاكي المصادقة. إذا كان قيد التشغيل. إذا تم تشغيل المزيد من الدوال بواسطة تلك الكتابة، سيتم تشغيلها في محاكي Cloud Functions.
استضافة Firebase
في حال استخدام Cloud Functions من أجل إنشاء محتوى ديناميكي
Firebase Hosting، firebase emulators:start
يستخدم دوال HTTP المحلية كخوادم وكيل للاستضافة.
التسجيل
ويبث المحاكي السجلات من الدوال إلى النافذة الطرفية حيث
الجري. وهي تعرض جميع النتائج من console.log()
وconsole.info()
وconsole.error()
وconsole.warn()
في الدوال.
الخطوات التالية
للاطّلاع على مثال كامل على استخدام مجموعة مُحاكي Firebase، راجع اختبار عيّنة Quickstart.