Cloud Firestore Android Codelab

1. نظرة عامة

الأهداف

في هذا البرنامج التعليمي ، ستنشئ تطبيق توصيات مطعم على نظام Android مدعومًا من Cloud Firestore. سوف تتعلم كيفية:

  • اقرأ البيانات واكتبها إلى Firestore من تطبيق Android
  • استمع إلى التغييرات في بيانات Firestore في الوقت الفعلي
  • استخدم مصادقة Firebase وقواعد الأمان لتأمين بيانات Firestore
  • اكتب استفسارات Firestore المعقدة

المتطلبات الأساسية

قبل البدء في هذا الكود ، تأكد من أن لديك:

  • Android Studio 4.0 أو أعلى
  • محاكي Android مع API 19 أو أعلى
  • Node.js الإصدار 10 أو أعلى
  • إصدار Java 8 أو أعلى

2. أنشئ مشروع Firebase

  1. سجّل الدخول إلى وحدة تحكم Firebase باستخدام حساب Google الخاص بك.
  2. في وحدة تحكم Firebase ، انقر على إضافة مشروع .
  3. كما هو موضح في لقطة الشاشة أدناه ، أدخل اسمًا لمشروع Firebase (على سبيل المثال ، "Friendly Eats") ، وانقر فوق " متابعة ".

9d2f625aebcab6af.png

  1. قد يُطلب منك تمكين Google Analytics ، لأغراض مختبر الرموز هذا لا يهم اختيارك.
  2. بعد دقيقة أو نحو ذلك ، سيكون مشروع Firebase جاهزًا. انقر فوق متابعة .

3. إعداد مشروع العينة

قم بتنزيل الكود

قم بتشغيل الأمر التالي لنسخ نموذج التعليمات البرمجية لمعمل الرموز هذا. سيؤدي هذا إلى إنشاء مجلد يسمى friendlyeats-android على جهازك:

$ git clone https://github.com/firebase/friendlyeats-android

إذا لم يكن لديك git على جهازك ، فيمكنك أيضًا تنزيل الكود مباشرةً من GitHub.

أضف تهيئة Firebase

  1. في وحدة تحكم Firebase ، حدد نظرة عامة على المشروع في التنقل الأيمن. انقر فوق الزر Android لتحديد النظام الأساسي. عندما يُطلب منك اسم الحزمة ، استخدم com.google.firebase.example.fireeats

73d151ed16016421.png

  1. انقر فوق تسجيل التطبيق واتبع التعليمات لتنزيل ملف google-services.json ، وانقله إلى app/ مجلد الكود الذي قمت بتنزيله للتو. ثم انقر فوق التالي .

استيراد المشروع

افتح Android Studio. انقر فوق ملف > جديد > استيراد مشروع وحدد مجلد androideats-friendly .

4. قم بإعداد محاكيات Firebase

في مختبر الرموز هذا ، ستستخدم Firebase Emulator Suite لمحاكاة Cloud Firestore محليًا وخدمات Firebase الأخرى. يوفر هذا بيئة تطوير محلية آمنة وسريعة وبدون تكلفة لإنشاء تطبيقك.

قم بتثبيت Firebase CLI

ستحتاج أولاً إلى تثبيت Firebase CLI . إذا كنت تستخدم macOS أو Linux ، فيمكنك تشغيل أمر cURL التالي:

curl -sL https://firebase.tools | bash

إذا كنت تستخدم Windows ، فاقرأ إرشادات التثبيت للحصول على ثنائي مستقل أو للتثبيت عبر npm .

بمجرد تثبيت CLI ، يجب أن يقوم تشغيل firebase --version --version بالإبلاغ عن إصدار 9.0.0 أو أعلى:

$ firebase --version
9.0.0

تسجيل الدخول

قم بتشغيل firebase login لتوصيل CLI بحساب Google الخاص بك. سيؤدي هذا إلى فتح نافذة متصفح جديدة لإكمال عملية تسجيل الدخول. تأكد من اختيار الحساب نفسه الذي استخدمته عند إنشاء مشروع Firebase مسبقًا.

من داخل مجلد friendlyeats-android قم بتشغيل firebase use --add - أضف لتوصيل مشروعك المحلي بمشروع Firebase. اتبع المطالبات لتحديد المشروع الذي قمت بإنشائه مسبقًا وإذا طُلب منك اختيار اسم مستعار ، فأدخل default .

5. قم بتشغيل التطبيق

حان الوقت الآن لتشغيل Firebase Emulator Suite وتطبيق FriendlyEats Android لأول مرة.

قم بتشغيل المحاكيات

في جهازك الطرفي من داخل دليل friendlyeats-android قم بتشغيل firebase emulators:start في بدء تشغيل Firebase Emulators. يجب أن تشاهد سجلات مثل هذا:

$ firebase emulators:start
i  emulators: Starting emulators: auth, firestore
i  firestore: Firestore Emulator logging to firestore-debug.log
i  ui: Emulator UI logging to ui-debug.log

┌─────────────────────────────────────────────────────────────┐
│ ✔  All emulators ready! It is now safe to connect your app. │
│ i  View Emulator UI at http://localhost:4000                │
└─────────────────────────────────────────────────────────────┘

┌────────────────┬────────────────┬─────────────────────────────────┐
│ Emulator       │ Host:Port      │ View in Emulator UI             │
├────────────────┼────────────────┼─────────────────────────────────┤
│ Authentication │ localhost:9099 │ http://localhost:4000/auth      │
├────────────────┼────────────────┼─────────────────────────────────┤
│ Firestore      │ localhost:8080 │ http://localhost:4000/firestore │
└────────────────┴────────────────┴─────────────────────────────────┘
  Emulator Hub running at localhost:4400
  Other reserved ports: 4500

Issues? Report them at https://github.com/firebase/firebase-tools/issues and attach the *-debug.log files.

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

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

افتح الملف FirebaseUtil.java في Android Studio. يحتوي هذا الملف على المنطق لتوصيل Firebase SDKs بمحاكيات محلية تعمل على جهازك.

في الجزء العلوي من الملف ، افحص هذا السطر:

    /** Use emulators only in debug builds **/
    private static final boolean sUseEmulators = BuildConfig.DEBUG;

نحن نستخدم BuildConfig للتأكد من أننا نتصل فقط بالمحاكيات عندما يعمل تطبيقنا في وضع debug . عندما نقوم بتجميع التطبيق في وضع release ، سيكون هذا الشرط خاطئًا.

ألقِ نظرة الآن على طريقة getFirestore() :

    public static FirebaseFirestore getFirestore() {
        if (FIRESTORE == null) {
            FIRESTORE = FirebaseFirestore.getInstance();

            // Connect to the Cloud Firestore emulator when appropriate. The host '10.0.2.2' is a
            // special IP address to let the Android emulator connect to 'localhost'.
            if (sUseEmulators) {
                FIRESTORE.useEmulator("10.0.2.2", 8080);
            }
        }

        return FIRESTORE;
    }

يمكننا أن نرى أنه يستخدم طريقة useEmulator(host, port) لتوصيل Firebase SDK بمحاكي Firestore المحلي. في جميع أنحاء التطبيق ، سنستخدم FirebaseUtil.getFirestore() للوصول إلى مثيل FirebaseFirestore ، لذلك نحن على يقين من أننا نتصل دائمًا بمحاكي Firestore عند التشغيل في وضع debug .

قم بتشغيل التطبيق

إذا كنت قد أضفت ملف google-services.json بشكل صحيح ، فيجب أن يجمع المشروع الآن. في Android Studio ، انقر فوق Build > Rebuild Project وتأكد من عدم وجود أخطاء متبقية.

في Android Studio ، قم بتشغيل التطبيق على محاكي Android. في البداية ستظهر لك شاشة "تسجيل الدخول". يمكنك استخدام أي بريد إلكتروني وكلمة مرور لتسجيل الدخول إلى التطبيق. تتصل عملية تسجيل الدخول هذه بمحاكي Firebase Authentication ، لذلك لا يتم نقل أي بيانات اعتماد حقيقية.

افتح الآن Emulators UI بالانتقال إلى http: // localhost: 4000 في متصفح الويب الخاص بك. ثم انقر فوق علامة التبويب المصادقة وسترى الحساب الذي أنشأته للتو:

محاكي Firebase Auth

بمجرد الانتهاء من عملية تسجيل الدخول ، سترى الشاشة الرئيسية للتطبيق:

de06424023ffb4b9.png

سنضيف قريبًا بعض البيانات لملء الشاشة الرئيسية.

6. كتابة البيانات إلى Firestore

في هذا القسم ، سنكتب بعض البيانات إلى Firestore حتى نتمكن من ملء الشاشة الرئيسية الفارغة حاليًا.

كائن النموذج الرئيسي في تطبيقنا هو مطعم (انظر model/Restaurant.java ). يتم تقسيم بيانات Firestore إلى مستندات ومجموعات ومجموعات فرعية. سنخزن كل مطعم كمستند في مجموعة عالية المستوى تسمى "restaurants" . لمعرفة المزيد حول نموذج بيانات Firestore ، اقرأ عن المستندات والمجموعات في الوثائق .

لأغراض العرض التوضيحي ، سنضيف وظائف في التطبيق لإنشاء عشرة مطاعم عشوائية عندما نضغط على زر "إضافة عناصر عشوائية" في القائمة الكاملة. افتح الملف MainActivity.java واستبدل المحتوى في طريقة onAddItemsClicked() بـ:

    private void onAddItemsClicked() {
        // Get a reference to the restaurants collection
        CollectionReference restaurants = mFirestore.collection("restaurants");

        for (int i = 0; i < 10; i++) {
            // Get a random Restaurant POJO
            Restaurant restaurant = RestaurantUtil.getRandom(this);

            // Add a new document to the restaurants collection
            restaurants.add(restaurant);
        }
    }

هناك بعض الأشياء المهمة التي يجب ملاحظتها حول الكود أعلاه:

  • بدأنا بالحصول على مرجع لمجموعة "restaurants" . يتم إنشاء المجموعات بشكل ضمني عند إضافة المستندات ، لذلك لم تكن هناك حاجة لإنشاء المجموعة قبل كتابة البيانات.
  • يمكن إنشاء المستندات باستخدام POJOs (كائن Java قديم عادي) ، والذي نستخدمه لإنشاء كل مستند مطعم.
  • تضيف طريقة add() مستندًا إلى مجموعة بمعرّف مُنشأ تلقائيًا ، لذلك لا نحتاج إلى تحديد معرّف فريد لكل مطعم.

الآن قم بتشغيل التطبيق مرة أخرى وانقر فوق الزر "إضافة عناصر عشوائية" في القائمة الكاملة (في الزاوية اليمنى العليا) لاستدعاء الكود الذي كتبته للتو:

95691e9b71ba55e3.png

افتح الآن Emulators UI بالانتقال إلى http: // localhost: 4000 في متصفح الويب الخاص بك. ثم انقر فوق علامة التبويب Firestore وسترى البيانات التي أضفتها للتو:

محاكي Firebase Auth

هذه البيانات 100٪ محلية على جهازك. في الواقع ، لا يحتوي مشروعك الحقيقي حتى الآن على قاعدة بيانات Firestore! هذا يعني أنه من الآمن تجربة تعديل وحذف هذه البيانات دون عواقب.

تهانينا ، لقد قمت للتو بكتابة البيانات إلى Firestore! في الخطوة التالية سوف نتعلم كيفية عرض هذه البيانات في التطبيق.

7. عرض البيانات من Firestore

في هذه الخطوة سوف نتعلم كيفية استرداد البيانات من Firestore وعرضها في تطبيقنا. تتمثل الخطوة الأولى لقراءة البيانات من Firestore في إنشاء Query . افتح الملف MainActivity.java وأضف الكود التالي إلى بداية طريقة onCreate() :

        mFirestore = FirebaseUtil.getFirestore();

        // Get the 50 highest rated restaurants
        mQuery = mFirestore.collection("restaurants")
                .orderBy("avgRating", Query.Direction.DESCENDING)
                .limit(LIMIT);

نريد الآن الاستماع إلى الاستعلام ، حتى نحصل على جميع المستندات المطابقة ويتم إخطارنا بالتحديثات المستقبلية في الوقت الفعلي. نظرًا لأن هدفنا النهائي هو ربط هذه البيانات بـ RecyclerView ، نحتاج إلى إنشاء فئة RecyclerView.Adapter للاستماع إلى البيانات.

افتح فئة FirestoreAdapter ، التي تم تنفيذها جزئيًا بالفعل. أولاً ، لنجعل المهايئ ينفذ EventListener ويعرف وظيفة onEvent بحيث يمكنه تلقي تحديثات لاستعلام Firestore:

public abstract class FirestoreAdapter<VH extends RecyclerView.ViewHolder>
        extends RecyclerView.Adapter<VH>
        implements EventListener<QuerySnapshot> { // Add this "implements"

    // ...

    // Add this method
    @Override
    public void onEvent(QuerySnapshot documentSnapshots,
                        FirebaseFirestoreException e) {

        // Handle errors
        if (e != null) {
            Log.w(TAG, "onEvent:error", e);
            return;
        }

        // Dispatch the event
        for (DocumentChange change : documentSnapshots.getDocumentChanges()) {
            // Snapshot of the changed document
            DocumentSnapshot snapshot = change.getDocument();

            switch (change.getType()) {
                case ADDED:
                    // TODO: handle document added
                    break;
                case MODIFIED:
                    // TODO: handle document modified
                    break;
                case REMOVED:
                    // TODO: handle document removed
                    break;
            }
        }

        onDataChanged();
    }

  // ...
}

عند التحميل الأولي ، سيتلقى المستمع حدث ADDED واحد لكل مستند جديد. نظرًا لأن مجموعة نتائج الاستعلام تتغير بمرور الوقت ، سيتلقى المستمع المزيد من الأحداث التي تحتوي على التغييرات. لننتهي الآن من تطبيق المستمع. قم أولاً بإضافة ثلاث طرق جديدة: onDocumentAdded added و onDocumentModified و onDocumentRemoved :

    protected void onDocumentAdded(DocumentChange change) {
        mSnapshots.add(change.getNewIndex(), change.getDocument());
        notifyItemInserted(change.getNewIndex());
    }

    protected void onDocumentModified(DocumentChange change) {
        if (change.getOldIndex() == change.getNewIndex()) {
            // Item changed but remained in same position
            mSnapshots.set(change.getOldIndex(), change.getDocument());
            notifyItemChanged(change.getOldIndex());
        } else {
            // Item changed and changed position
            mSnapshots.remove(change.getOldIndex());
            mSnapshots.add(change.getNewIndex(), change.getDocument());
            notifyItemMoved(change.getOldIndex(), change.getNewIndex());
        }
    }

    protected void onDocumentRemoved(DocumentChange change) {
        mSnapshots.remove(change.getOldIndex());
        notifyItemRemoved(change.getOldIndex());
    }

ثم استدع هذه الطرق الجديدة من onEvent :

    @Override
    public void onEvent(QuerySnapshot documentSnapshots,
                        FirebaseFirestoreException e) {

        // ...

        // Dispatch the event
        for (DocumentChange change : documentSnapshots.getDocumentChanges()) {
            // Snapshot of the changed document
            DocumentSnapshot snapshot = change.getDocument();

            switch (change.getType()) {
                case ADDED:
                    onDocumentAdded(change); // Add this line
                    break;
                case MODIFIED:
                    onDocumentModified(change); // Add this line
                    break;
                case REMOVED:
                    onDocumentRemoved(change); // Add this line
                    break;
            }
        }

        onDataChanged();
    }

أخيرًا ، قم بتنفيذ طريقة startListening() لإرفاق المستمع:

    public void startListening() {
        if (mQuery != null && mRegistration == null) {
            mRegistration = mQuery.addSnapshotListener(this);
        }
    }

الآن تم تكوين التطبيق بالكامل لقراءة البيانات من Firestore. قم بتشغيل التطبيق مرة أخرى وسترى المطاعم التي أضفتها في الخطوة السابقة:

9e45f40faefce5d0.png

عد الآن إلى Emulator UI في متصفحك وقم بتحرير أحد أسماء المطاعم. يجب أن ترى أنه يتغير في التطبيق على الفور تقريبًا!

8. فرز البيانات وتصفيتها

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

يؤدي النقر فوق الشريط الأبيض في الجزء العلوي من التطبيق إلى إظهار مربع حوار عوامل التصفية. في هذا القسم ، سنستخدم استعلامات Firestore لجعل مربع الحوار هذا يعمل:

67898572a35672a5.png

دعنا نعدل طريقة onFilter() الخاصة بـ MainActivity.java . تقبل هذه الطريقة كائن Filters وهو كائن مساعد أنشأناه لالتقاط إخراج مربع حوار المرشحات. سنقوم بتغيير هذه الطريقة لإنشاء استعلام من المرشحات:

    @Override
    public void onFilter(Filters filters) {
        // Construct basic query
        Query query = mFirestore.collection("restaurants");

        // Category (equality filter)
        if (filters.hasCategory()) {
            query = query.whereEqualTo("category", filters.getCategory());
        }

        // City (equality filter)
        if (filters.hasCity()) {
            query = query.whereEqualTo("city", filters.getCity());
        }

        // Price (equality filter)
        if (filters.hasPrice()) {
            query = query.whereEqualTo("price", filters.getPrice());
        }

        // Sort by (orderBy with direction)
        if (filters.hasSortBy()) {
            query = query.orderBy(filters.getSortBy(), filters.getSortDirection());
        }

        // Limit items
        query = query.limit(LIMIT);

        // Update the query
        mQuery = query;
        mAdapter.setQuery(query);

        // Set header
        mCurrentSearchView.setText(Html.fromHtml(filters.getSearchDescription(this)));
        mCurrentSortByView.setText(filters.getOrderDescription(this));

        // Save filters
        mViewModel.setFilters(filters);
    }

في المقتطف أعلاه ، نقوم ببناء كائن Query عن طريق إرفاق where orderBy جمل لتتناسب مع عوامل التصفية المحددة.

شغّل التطبيق مرة أخرى وحدد الفلتر التالي لإظهار أشهر المطاعم منخفضة السعر:

7a67a8a400c80c50.png

يجب أن تشاهد الآن قائمة تمت تصفيتها من المطاعم تحتوي على خيارات السعر المنخفض فقط:

a670188398c3c59.png

إذا كنت قد وصلت إلى هذا الحد ، فأنت الآن قد أنشأت تطبيقًا لعرض توصيات المطاعم يعمل بكامل طاقته على Firestore! يمكنك الآن فرز المطاعم وتصفيتها في الوقت الفعلي. في الأقسام القليلة التالية سنضيف التعليقات إلى المطاعم ونضيف قواعد الأمان إلى التطبيق.

9. تنظيم البيانات في مجموعات فرعية

في هذا القسم ، سنضيف التقييمات إلى التطبيق حتى يتمكن المستخدمون من مراجعة مطاعمهم المفضلة (أو المفضلة على الأقل).

المجموعات والمجموعات الفرعية

حتى الآن قمنا بتخزين جميع بيانات المطاعم في مجموعة عالية المستوى تسمى "المطاعم". عندما يقوم المستخدم بتقييم مطعم ما ، فإننا نريد إضافة كائن Rating جديد إلى المطاعم. لهذه المهمة سوف نستخدم مجموعة فرعية. يمكنك التفكير في مجموعة فرعية على أنها مجموعة مرفقة بمستند. لذلك سيكون لكل وثيقة مطعم مجموعة فرعية من التصنيفات مليئة بوثائق التصنيف. تساعد المجموعات الفرعية في تنظيم البيانات دون تضخيم مستنداتنا أو طلب استعلامات معقدة.

للوصول إلى مجموعة فرعية ، قم باستدعاء .collection() في المستند الأصلي:

CollectionReference subRef = mFirestore.collection("restaurants")
        .document("abc123")
        .collection("ratings");

يمكنك الوصول إلى مجموعة فرعية والاستعلام عنها تمامًا كما هو الحال مع مجموعة المستوى الأعلى ، ولا توجد قيود على الحجم أو تغييرات في الأداء. يمكنك قراءة المزيد عن نموذج بيانات Firestore هنا .

كتابة البيانات في المعاملة

لا تتطلب إضافة Rating إلى المجموعة الفرعية المناسبة سوى استدعاء .add() ، ولكننا نحتاج أيضًا إلى تحديث متوسط ​​تصنيف كائن Restaurant وعدد التقييمات لعكس البيانات الجديدة. إذا استخدمنا عمليات منفصلة لإجراء هذين التغييرين ، فهناك عدد من ظروف السباق التي قد تؤدي إلى بيانات قديمة أو غير صحيحة.

لضمان إضافة التقييمات بشكل صحيح ، سنستخدم معاملة لإضافة تقييمات إلى مطعم. ستؤدي هذه المعاملة بعض الإجراءات:

  • اقرأ التصنيف الحالي للمطعم واحسب التصنيف الجديد
  • أضف التصنيف إلى المجموعة الفرعية
  • قم بتحديث متوسط ​​تصنيف المطعم وعدد التقييمات

افتح RestaurantDetailActivity.java وقم بتنفيذ وظيفة addRating :

    private Task<Void> addRating(final DocumentReference restaurantRef,
                                 final Rating rating) {
        // Create reference for new rating, for use inside the transaction
        final DocumentReference ratingRef = restaurantRef.collection("ratings")
                .document();

        // In a transaction, add the new rating and update the aggregate totals
        return mFirestore.runTransaction(new Transaction.Function<Void>() {
            @Override
            public Void apply(Transaction transaction)
                    throws FirebaseFirestoreException {

                Restaurant restaurant = transaction.get(restaurantRef)
                        .toObject(Restaurant.class);

                // Compute new number of ratings
                int newNumRatings = restaurant.getNumRatings() + 1;

                // Compute new average rating
                double oldRatingTotal = restaurant.getAvgRating() *
                        restaurant.getNumRatings();
                double newAvgRating = (oldRatingTotal + rating.getRating()) /
                        newNumRatings;

                // Set new restaurant info
                restaurant.setNumRatings(newNumRatings);
                restaurant.setAvgRating(newAvgRating);

                // Commit to Firestore
                transaction.set(restaurantRef, restaurant);
                transaction.set(ratingRef, rating);

                return null;
            }
        });
    }

ترجع الدالة addRating() Task تمثل المعاملة بأكملها. في وظيفة onRating() تتم إضافة المستمعين إلى المهمة للرد على نتيجة المعاملة.

الآن قم بتشغيل التطبيق مرة أخرى وانقر فوق أحد المطاعم ، والذي يجب أن يظهر شاشة تفاصيل المطعم. انقر فوق الزر + لبدء إضافة مراجعة. أضف مراجعة باختيار عدد من النجوم وإدخال بعض النصوص.

78fa16cdf8ef435a.png

سيؤدي الضغط على إرسال إلى بدء المعاملة. عند اكتمال المعاملة ، سترى تقييمك معروضًا أدناه وتحديثًا لعدد تعليقات المطعم:

f9e670f40bd615b0.png

تهاني! لديك الآن تطبيق مراجعة مطعم اجتماعي ومحلي ومتحرك تم إنشاؤه على Cloud Firestore. سمعت أن هذه هي شعبية جدا هذه الأيام.

10. تأمين البيانات الخاصة بك

حتى الآن لم نفكر في أمان هذا التطبيق. كيف نعرف أن المستخدمين يمكنهم قراءة وكتابة البيانات الخاصة بهم فقط؟ يتم تأمين قواعد بيانات Firestore بواسطة ملف تكوين يسمى قواعد الأمان .

افتح ملف firestore.rules ، يجب أن ترى ما يلي:

rules_version = '2';
service cloud.firestore {
  match /databases/{database}/documents {
    match /{document=**} {
      //
      // WARNING: These rules are insecure! We will replace them with
      // more secure rules later in the codelab
      //
      allow read, write: if request.auth != null;
    }
  }
}

دعنا نغير هذه القواعد لمنع وصول البيانات أو التغييرات غير المرغوب فيها ، وافتح ملف firestore.rules واستبدل المحتوى بما يلي:

rules_version = '2';
service cloud.firestore {
  match /databases/{database}/documents {
    // Determine if the value of the field "key" is the same
    // before and after the request.
    function isUnchanged(key) {
      return (key in resource.data)
        && (key in request.resource.data)
        && (resource.data[key] == request.resource.data[key]);
    }

    // Restaurants
    match /restaurants/{restaurantId} {
      // Any signed-in user can read
      allow read: if request.auth != null;

      // Any signed-in user can create
      // WARNING: this rule is for demo purposes only!
      allow create: if request.auth != null;

      // Updates are allowed if no fields are added and name is unchanged
      allow update: if request.auth != null
                    && (request.resource.data.keys() == resource.data.keys())
                    && isUnchanged("name");

      // Deletes are not allowed.
      // Note: this is the default, there is no need to explicitly state this.
      allow delete: if false;

      // Ratings
      match /ratings/{ratingId} {
        // Any signed-in user can read
        allow read: if request.auth != null;

        // Any signed-in user can create if their uid matches the document
        allow create: if request.auth != null
                      && request.resource.data.userId == request.auth.uid;

        // Deletes and updates are not allowed (default)
        allow update, delete: if false;
      }
    }
  }
}

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

لقراءة المزيد حول قواعد الأمان ، قم بزيارة الوثائق .

11. الخلاصة

لقد قمت الآن بإنشاء تطبيق كامل الميزات أعلى Firestore. لقد تعرفت على أهم ميزات Firestore بما في ذلك:

  • المستندات والمجموعات
  • قراءة وكتابة البيانات
  • الفرز والتصفية مع الاستفسارات
  • المجموعات الفرعية
  • المعاملات

يتعلم أكثر

لمواصلة التعرف على Firestore ، إليك بعض الأماكن الجيدة للبدء:

استند تطبيق المطعم في مختبر الرموز هذا إلى مثال تطبيق "Friendly Eats". يمكنك تصفح الكود المصدري لهذا التطبيق هنا .

اختياري: النشر في الإنتاج

حتى الآن ، استخدم هذا التطبيق فقط Firebase Emulator Suite. إذا كنت تريد معرفة كيفية نشر هذا التطبيق في مشروع Firebase حقيقي ، فتابع إلى الخطوة التالية.

12. (اختياري) انشر تطبيقك

حتى الآن ، كان هذا التطبيق محليًا بالكامل ، وجميع البيانات موجودة في Firebase Emulator Suite. ستتعلم في هذا القسم كيفية تكوين مشروع Firebase حتى يعمل هذا التطبيق في الإنتاج.

مصادقة Firebase

في وحدة تحكم Firebase ، انتقل إلى قسم المصادقة وانقر على البدء . انتقل إلى علامة تبويب طريقة تسجيل الدخول وحدد خيار البريد الإلكتروني / كلمة المرور من موفري الخدمة الأصليين .

قم بتمكين طريقة تسجيل الدخول إلى البريد الإلكتروني / كلمة المرور وانقر فوق حفظ .

Sign-in-Provider.png

فيرستور

إنشاء قاعدة بيانات

انتقل إلى قسم قاعدة بيانات Firestore في وحدة التحكم وانقر فوق إنشاء قاعدة بيانات :

  1. عند مطالبتك بشأن قواعد الأمان ، اختر البدء في وضع الإنتاج ، سنقوم بتحديث هذه القواعد قريبًا.
  2. اختر موقع قاعدة البيانات الذي ترغب في استخدامه لتطبيقك. لاحظ أن اختيار موقع قاعدة البيانات هو قرار دائم ولتغييره سيتعين عليك إنشاء مشروع جديد. لمزيد من المعلومات حول اختيار موقع المشروع ، راجع الوثائق .

نشر القواعد

لنشر قواعد الأمان التي كتبتها سابقًا ، قم بتشغيل الأمر التالي في دليل codelab:

$ firebase deploy --only firestore:rules

سيؤدي هذا إلى نشر محتويات firestore.rules إلى مشروعك ، والتي يمكنك تأكيدها بالانتقال إلى علامة التبويب " القواعد " في وحدة التحكم.

نشر الفهارس

يحتوي تطبيق FriendlyEats على عمليات فرز وتصفية معقدة تتطلب عددًا من الفهارس المركبة المخصصة. يمكن إنشاء هذه يدويًا في وحدة تحكم Firebase ولكن من الأسهل كتابة تعريفاتها في ملف firestore.indexes.json ونشرها باستخدام Firebase CLI.

إذا فتحت ملف firestore.indexes.json ، فسترى أن الفهارس المطلوبة قد تم توفيرها بالفعل:

{
  "indexes": [
    {
      "collectionId": "restaurants",
      "queryScope": "COLLECTION",
      "fields": [
        { "fieldPath": "city", "mode": "ASCENDING" },
        { "fieldPath": "avgRating", "mode": "DESCENDING" }
      ]
    },
    {
      "collectionId": "restaurants",
      "queryScope": "COLLECTION",
      "fields": [
        { "fieldPath": "category", "mode": "ASCENDING" },
        { "fieldPath": "avgRating", "mode": "DESCENDING" }
      ]
    },
    {
      "collectionId": "restaurants",
      "queryScope": "COLLECTION",
      "fields": [
        { "fieldPath": "price", "mode": "ASCENDING" },
        { "fieldPath": "avgRating", "mode": "DESCENDING" }
      ]
    },
    {
      "collectionId": "restaurants",
      "queryScope": "COLLECTION",
      "fields": [
        { "fieldPath": "city", "mode": "ASCENDING" },
        { "fieldPath": "numRatings", "mode": "DESCENDING" }
      ]
    },
    {
      "collectionId": "restaurants",
      "queryScope": "COLLECTION",
      "fields": [
        { "fieldPath": "category", "mode": "ASCENDING" },
        { "fieldPath": "numRatings", "mode": "DESCENDING" }
      ]
    },
    {
      "collectionId": "restaurants",
      "queryScope": "COLLECTION",
      "fields": [
        { "fieldPath": "price", "mode": "ASCENDING" },
        { "fieldPath": "numRatings", "mode": "DESCENDING" }
      ]
    },
    {
      "collectionId": "restaurants",
      "queryScope": "COLLECTION",
      "fields": [
        { "fieldPath": "city", "mode": "ASCENDING" },
        { "fieldPath": "price", "mode": "ASCENDING" }
      ]
    },
    {
      "collectionId": "restaurants",
      "fields": [
        { "fieldPath": "category", "mode": "ASCENDING" },
        { "fieldPath": "price", "mode": "ASCENDING" }
      ]
    }
  ],
  "fieldOverrides": []
}

لنشر هذه الفهارس ، قم بتشغيل الأمر التالي:

$ firebase deploy --only firestore:indexes

لاحظ أن إنشاء الفهرس ليس فوريًا ، يمكنك مراقبة التقدم في وحدة تحكم Firebase.

تكوين التطبيق

في فئة FirebaseUtil ، قمنا بتهيئة Firebase SDK للاتصال بالمحاكيات عندما تكون في وضع التصحيح:

public class FirebaseUtil {

    /** Use emulators only in debug builds **/
    private static final boolean sUseEmulators = BuildConfig.DEBUG;

    // ...
}

إذا كنت ترغب في اختبار تطبيقك باستخدام مشروع Firebase الحقيقي ، فيمكنك إما:

  1. أنشئ التطبيق في وضع الإصدار وقم بتشغيله على الجهاز.
  2. قم بتغيير sUseEmulators مؤقتًا إلى false ثم قم بتشغيل التطبيق مرة أخرى.

لاحظ أنك قد تحتاج إلى تسجيل الخروج من التطبيق وتسجيل الدخول مرة أخرى للاتصال بشكل صحيح بالإنتاج.