ربط تطبيقك وبدء إنشاء النماذج الأولية


قبل البدء باستخدام Firebase Local Emulator Suite، تأكَّد من أنّك أنشأت مشروعًا على Firebase وأعددت بيئة التطوير واخترت حِزم تطوير البرامج (SDK) لمنصّة Firebase و ثبّتها لنظامك الأساسي وفقًا لمواضيع البدء باستخدام Firebase لنظامك الأساسي: Apple أو Android أو الويب.

إنشاء النموذج الأولي واختباره

يحتوي Local Emulator Suite على العديد من محاكيات المنتجات، كما هو موضّح في مقدمة عن Firebase Local Emulator Suite. يمكنك إنشاء النماذج الأولية واختبارها باستخدام محاكيات فردية بالإضافة إلى مجموعات من المحاكيات، حسبما تراه مناسبًا، بما يتوافق مع منتجات Firebase التي تستخدمها في مرحلة الإنتاج.

التفاعل بين قاعدة بيانات Firebase ومحاكيات الدوالّ
محاكي قاعدة البيانات ومحاكي Cloud Functions كجزء من Local Emulator Suite الكامل

في هذا الموضوع، لتعريفك على سير عمل Local Emulator Suite، لنفترض أنّك تعمل على تطبيق يستخدم مجموعة نموذجية من المنتجات: قاعدة بيانات Firebase ودوال السحابة الإلكترونية التي يتم تشغيلها من خلال عمليات على قاعدة البيانات هذه.

بعد إعداد مشروع Firebase على الجهاز، تتضمّن دورة التطوير باستخدام Local Emulator Suite عادةً ثلاث خطوات:

  1. ميزات النموذج الأوّلي تفاعلية مع المحاكيات وEmulator Suite UI.

  2. إذا كنت تستخدم محاكي قاعدة بيانات أو محاكي Cloud Functions، عليك تنفيذ خطوة واحدة لربط تطبيقك بالمحاكيات.

  3. يمكنك برمجة اختباراتك باستخدام المحاكيات والنصوص البرمجية المخصّصة.

بدء مشروع Firebase محليًا

احرص على تثبيت واجهة سطر الأوامر أو التحديث إلى آخر إصدار له.

curl -sL firebase.tools | bash

إذا لم يسبق لك ذلك، عليك إعداد الدليل الحالي للعمل كأحد مشاريع Firebase، مع اتّباع التعليمات الظاهرة على الشاشة لتحديد أنّك تستخدم Cloud Functions وCloud Firestore أو Realtime Database:

firebase init

سيتضمّن دليل مشروعك الآن ملفات إعدادات Firebase وملف Firebase Security Rules تعريفي لقاعدة البيانات ودليل functions يحتوي على رمز وظائف السحابة الإلكترونية وملفات داعمة أخرى.

إنشاء نماذج أولية بشكل تفاعلي

تم تصميم Local Emulator Suite للسماح لك بإنشاء نماذج أولية للميزات الجديدة بسرعة، وتعد واجهة المستخدم المضمّنة في Suite إحدى أدوات إنشاء النماذج الأولية الأكثر فائدة. يشبه ذلك تشغيل وحدة تحكّم Firebase على الجهاز.

باستخدام Emulator Suite UI، يمكنك تكرار تصميم قاعدة بيانات، وتجربة عمليات تدفق بيانات مختلفة تتضمّن وظائف السحابة الإلكترونية، وتقييم تغييرات "قواعد الأمان"، والاطّلاع على السجلات للتأكّد من مستوى أداء خدمات الخلفية، وغير ذلك. بعد ذلك، إذا أردت البدء من جديد، ما عليك سوى محو قاعدة بياناتك والبدء من جديد بفكرة تصميم جديدة.

تتوفّر كل هذه الميزات عند بدء Local Emulator Suite باستخدام:

firebase emulators:start

لإنشاء نموذج أولي لتطبيقنا الافتراضي، لنبدأ بإعداد واختبار دالة أساسية في السحابة الإلكترونية لتعديل الإدخالات النصية في قاعدة بيانات، وإنشاء قاعدة البيانات هذه وملؤها في Emulator Suite UI لتشغيلها.

  1. أنشئ دالة سحابة تنشِئها عمليات الكتابة في قاعدة البيانات من خلال تعديل ملف functions/index.js في دليل مشروعك. استبدِل محتويات الملف الحالي بالمقتطف التالي. ترصد هذه الدالة التغييرات في المستندات ضمن مجموعة messages، وتحوّل محتوى حقل original في أحد المستندات إلى أحرف كبيرة، وتخزّن النتيجة في حقل uppercase في ذلك المستند.
    2.   const functions = require('firebase-functions/v1');

  exports.makeUppercase = functions.firestore.document('/messages/{documentId}')
      .onCreate((snap, context) => {
        const original = snap.data().original;
        console.log('Uppercasing', context.params.documentId, original);
        const uppercase = original.toUpperCase();
        return snap.ref.set({uppercase}, {merge: true});
      });
  2. افتح Local Emulator Suite باستخدام firebase emulators:start. يبدأ تشغيل محاكيَي Cloud Functions وقاعدة البيانات ويتم ضبطهما تلقائيًا للتفاعل مع بعضهما.
  3. يمكنك الاطّلاع على واجهة المستخدم في المتصفّح على الرابط http://localhost:4000. المنفذ 4000 هو المنفذ التلقائي لواجهة المستخدم، ولكن عليك التحقّق من رسائل المحطة الطرفية التي يتم عرضها من خلال Firebase واجهة برمجة التطبيقات. لاحِظ حالة المحاكيات المتاحة. وفي هذه الحالة، سيكون المحاكيان Cloud Functions وCloud Firestore قيد التشغيل.
    صورتي
  4. في واجهة المستخدم، ضمن علامة التبويب Firestore > البيانات، انقر على بدء مجموعة واتّبِع التعليمات لإنشاء مستند جديد في مجموعة messages، باستخدام اسم الحقل original والقيمة test. يؤدي ذلك إلى تنشيط دالة السحابة الإلكترونية. وتجدر الإشارة إلى أنّ حقل uppercase جديد سيظهر بعد قليل، وتتم تعبئته بالسلسلة "TEST".
    صورتي صورتي
  5. في علامة التبويب Firestore > الطلبات، راجِع الطلبات التي تم إجراؤها إلى قاعدة البيانات التي تمت محاكاتها، بما في ذلك جميع تقييمات Firebase Security Rules التي تم إجراؤها كجزء من تلبية هذه الطلبات.
  6. تحقَّق من علامة التبويب السجلات للتأكّد من أنّ الدالة لم تحدث أي أخطاء عند تعديلها لقاعدة البيانات.

يمكنك بسهولة التكرار بين رمز دالة السحابة الإلكترونية وتعديلات قواعد البيانات التفاعلية حتى تصل إلى تدفق البيانات الذي تبحث عنه، بدون لمس رمز الدخول إلى قاعدة البيانات داخل التطبيق وإعادة تجميع مجموعات الاختبار وإعادة تشغيلها.

ربط تطبيقك بالمحاكيات

بعد تحقيق تقدّم جيد في إنشاء النماذج التفاعلية واختيار أحد التصاميم، ستكون مستعدًا لإضافة رمز الوصول إلى قاعدة البيانات إلى تطبيقك باستخدام حزمة تطوير البرامج (SDK) المناسبة. ستستمر في استخدام علامة التبويب "قاعدة البيانات"، وبالنسبة إلى الدوال، علامة التبويب السجلّات في Emulator Suite UI للتأكّد من أنّ سلوك تطبيقك سليم.

Local Emulator Suite هي أداة تطوير محلية. لن تؤدي عمليات الكتابة إلى قواعد بيانات الإنتاج إلى تنشيط الدوالّ التي تعمل على وضع نماذج أولية لها على الجهاز.

للتبديل إلى جعل تطبيقك يُجري عمليات كتابة في قاعدة البيانات، عليك توجيه فئات الاختبار أو الإعدادات داخل التطبيق إلى Cloud Firestore المحاكي.

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 firestore = Firebase.firestore
firestore.useEmulator("10.0.2.2", 8080)

firestore.firestoreSettings = firestoreSettings {
    isPersistenceEnabled = false
}
EmulatorSuite.kt
Java
// 10.0.2.2 is the special IP address to connect to the 'localhost' of
// the host computer from an Android emulator.
FirebaseFirestore firestore = FirebaseFirestore.getInstance();
firestore.useEmulator("10.0.2.2", 8080);

FirebaseFirestoreSettings settings = new FirebaseFirestoreSettings.Builder()
        .setPersistenceEnabled(false)
        .build();
firestore.setFirestoreSettings(settings);
EmulatorSuite.java
Swift
let settings = Firestore.firestore().settings
settings.host = "127.0.0.1:8080"
settings.cacheSettings = MemoryCacheSettings()
settings.isSSLEnabled = false
Firestore.firestore().settings = settings
ViewController.swift

Web

import { getFirestore, connectFirestoreEmulator } from "firebase/firestore";

// firebaseApps previously initialized using initializeApp()
const db = getFirestore();
connectFirestoreEmulator(db, '127.0.0.1', 8080);
fs_emulator_connect.js

Web

// Firebase previously initialized using firebase.initializeApp().
var db = firebase.firestore();
if (location.hostname === "localhost") {
  db.useEmulator("127.0.0.1", 8080);
}
emulator-suite.js

برمجة الاختبارات باستخدام نصوص برمجية مخصّصة

ننتقل الآن إلى الخطوة الأخيرة في سير العمل العام. بعد إنشاء نموذج أولي للميزة داخل التطبيق وتبيّن أنّه يُحقّق أداءً جيدًا على جميع منصّاتك، يمكنك الانتقال إلى مرحلة التنفيذ والاختبار النهائيين. بالنسبة إلى اختبار الوحدات وسير عمل CI، يمكنك تشغيل أدوات المحاكاة وإجراء الاختبارات البرمجية وإيقاف أدوات المحاكاة في استدعاء واحد باستخدام الأمر exec:

firebase emulators:exec "./testdir/test.sh"

استكشِف أدوات محاكاة فردية بالتفصيل

بعد أن اطّلعت على مخطّط العمل الأساسي من جهة العميل، يمكنك متابعة الاطّلاع على تفاصيل حول المحاكيات الفردية في المجموعة، بما في ذلك كيفية استخدامها لتطوير التطبيقات من جهة الخادم:

الخطوة التالية

احرص على قراءة المواضيع المتعلّقة بمحاكيات معيّنة مرتبطة أعلاه. بعد ذلك، يُرجى اتّباع الخطوات التالية: