فهم مشاريع Firebase

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

العلاقة بين مشاريع Firebase والتطبيقات والمنتجات

مشروع Firebase هو العنصر الأعلى مستوى في Firebase. في أحد المشاريع، يمكنك تسجيل تطبيقات Apple أو Android أو الويب. بعد تسجيل تطبيقاتك في Firebase، يمكنك إضافة حِزم تطوير البرامج (SDK) الخاصة بأي عدد من منتجات Firebase، مثل Analytics أو Cloud Firestore أو Performance Monitoring أو Remote Config.

يمكنك الاطّلاع على معلومات أكثر تفصيلاً حول هذه العملية في دليل البدء الخاص بمنصتك:
iOS+‎ | Android | الويب | Unity | C++‎ | Flutter.

فهم التسلسل الهرمي لمشاريع Firebase

مخطّط بياني يعرض التسلسل الهرمي الأساسي لمشروع Firebase، بما في ذلك المشروع والتطبيقات المسجّلة فيه والموارد والخدمات المتوفّرة فيه يعرض هذا الرسم التخطيطي التسلسل الهرمي الأساسي لمشروع Firebase. في ما يلي العلاقات الرئيسية:

  • مشروع Firebase هو بمثابة حاوية لجميع تطبيقاتك وأي موارد وخدمات تم توفيرها للمشروع.

  • يمكن أن يتضمّن مشروع Firebase تطبيقًا واحدًا أو أكثر من تطبيقات Firebase المسجّلة فيه (على سبيل المثال، إصدارَي iOS وAndroid من تطبيق ما، أو إصدارَي التطبيق المجاني والمدفوع).

  • تتشارك جميع تطبيقات Firebase المسجّلة في مشروع Firebase نفسه وتتمتّع بإمكانية الوصول إلى جميع الموارد والخدمات نفسها المتوفّرة للمشروع. وإليك بعض الأمثلة:

    • تتشارك جميع تطبيقات Firebase المسجّلة في مشروع Firebase نفسه الخلفيات نفسها، مثل Firebase Hosting وAuthentication وRealtime Database وCloud Firestore وCloud Storage وCloud Functions.

    • ترتبط جميع تطبيقات Firebase المسجّلة في مشروع Firebase نفسه بموقع "إحصاءات Google" نفسه، حيث يكون كل تطبيق من تطبيقات Firebase مصدر بيانات منفصلاً في هذا الموقع.

العلاقة بين مشاريع Firebase وGoogle Cloud

عند إنشاء مشروع جديد على Firebase، فإنّك في الواقع تنشئ مشروعًا على Google Cloud في الخلفية. يمكنك حتى إنشاء Google Cloud مشروع أولاً، ثم إضافة Firebase إلى المشروع لاحقًا. يمكنك اعتبار مشروع Google Cloud بمثابة حاوية افتراضية للبيانات والرموز والإعدادات والخدمات.

يُرجى العِلم أنّه بالنسبة إلى جميع مشاريع Firebase، يضيف Firebase تلقائيًا تصنيفًا firebase:enabled ضمن صفحة التصنيفات لمشروعك في وحدة تحكّم Google Cloud. يمكنك الاطّلاع على مزيد من المعلومات حول هذا التصنيف في الأسئلة الشائعة.

بما أنّ مشروع Firebase هو مشروع Google Cloud:

  • يمكنك الوصول إلى المشروع والتفاعل معه في Firebase console وكذلك في Google Cloud console وGoogle APIs console.

  • يمكنك التفاعل مع المشروع باستخدام Firebase CLI وgcloud CLI وأي مورد Terraform من Google.

  • يمكنك استخدام المنتجات وواجهات برمجة التطبيقات من كلّ من Firebase وGoogle Cloud في المشروع.

  • تتم مشاركة أذونات وأدوار إدارة الهوية وإمكانية الوصول (IAM) للمشروع بين Firebase وGoogle Cloud. أي إذن وصول يملكه أحد أعضاء المشروع (أي أحد الجهات الرئيسية) إلى مشروعك Google Cloud سينطبق أيضًا على مشروعك على Firebase (والعكس صحيح).

  • تتم مشاركة الفوترة للمشروع بين Firebase وGoogle Cloud. إذا كانت الفوترة مفعّلة في مشروعك على Google Cloud، سيتم إدراج مشروع Firebase ضمن خطة Blaze المَرِنة للدفع حسب الاستخدام في Firebase.

  • تتم مشاركة المعرّفات الفريدة للمشروع (مثل رقم المشروع ورقم تعريف المشروع) بين Firebase وGoogle Cloud.

  • سيتم أيضًا تطبيق أي تسلسل هرمي للموارد مطبّق على مشروعك Google Cloud (مثل المؤسسة والمجلدات وما إلى ذلك) على مشروعك على Firebase.

  • يؤدي حذف المشروع إلى حذفه في كل من Firebase وGoogle Cloud.

  • يؤدي حذف مورد أو بيانات أو تعديلها داخل المشروع إلى تطبيق هذا الإجراء على كل من Firebase وGoogle Cloud.

إعداد مشروع Firebase وتسجيل التطبيقات

يمكنك إعداد مشروع Firebase وتسجيل التطبيقات في وحدة تحكّم Firebase (أو، لحالات الاستخدام المتقدّمة، باستخدام Firebase Management REST API أو Firebase CLI). عند إعداد مشروع وتسجيل التطبيقات، عليك اتّخاذ بعض القرارات التنظيمية وإضافة معلومات إعداد خاصة بـ Firebase إلى مشاريعك المحلية.

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

التفاعل مع مشروع Firebase

بالإضافة إلى حِزم تطوير البرامج الخاصة بالمنتجات، يمكنك التفاعل مباشرةً مع مشروع Firebase باستخدام العديد من الأدوات والواجهات المختلفة.

Firebase وحدة التحكّم

توفّر Firebase وحدة التحكّم البيئة الأكثر شمولاً لإدارة منتجات Firebase والتطبيقات والإعدادات على مستوى المشروع.

تعرض اللوحة الجانبية اليمنى من وحدة التحكّم منتجات Firebase، ويتم تنظيمها حسب الفئات ذات المستوى الأعلى. في أعلى اللوحة الجانبية اليمنى، يمكنك الوصول إلى إعدادات المشروع من خلال النقر على . تتضمّن إعدادات المشروع عمليات الدمج وأذونات الوصول والفوترة.

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

يُرجى العِلم أنّ مشروع Firebase هو أيضًا مشروع Google Cloud، لذا قد تجد أنّ العديد من المهام أو المنتجات تتطلّب منك استخدام وحدة تحكّم Google Cloud بدلاً من وحدة تحكّم Firebase.

Firebase واجهة سطر الأوامر (أداة سطر أوامر)

توفّر Firebase أيضًا Firebase CLI لإعداد منتجات Firebase معيّنة وإدارتها، مثل Firebase Hosting وCloud Functions for Firebase وFirebase Extensions.

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

Firebase Management REST API

باستخدام Firebase Management REST API، يمكنك إدارة مشروع Firebase آليًا. على سبيل المثال، يمكنك تسجيل تطبيق في مشروع أو إدراج التطبيقات المسجّلة حاليًا بشكل آلي (iOS+‎ | Android | الويب).

معرّفات مشاريع Firebase

يمكن تحديد مشروع Firebase في الخلفية وفي واجهات المطوّرين المختلفة باستخدام معرّفات مختلفة، بما في ذلك اسم المشروع ورقم المشروع ورقم تعريف المشروع.

اسم المشروع

عند إنشاء مشروع، عليك تقديم اسم مشروع. هذا المعرّف هو الاسم الداخلي فقط للمشروع في Firebase console وGoogle Cloud console وFirebase CLI. لا يتم عرض اسم المشروع في أي منتج أو خدمة أو مورد من منتجات Firebase أو Google Cloud المتاحة للجميع، بل يهدف فقط إلى مساعدتك في التمييز بسهولة أكبر بين المشاريع المتعددة.

يمكنك تعديل اسم المشروع في أي وقت في إعدادات المشروع في Firebase Console. يظهر اسم المشروع في اللوحة العلوية.

رقم المشروع

يتضمّن مشروع Firebase (ومشروع Google Cloud المرتبط به) رقم مشروع. هذا هو المعرّف الأساسي الفريد عالميًا الذي تحدّده Google للمشروع. استخدِم هذا المعرّف عند ضبط عمليات الدمج و/أو إجراء طلبات بيانات من واجهة برمجة التطبيقات إلى Firebase أو Google أو الخدمات التابعة لجهات خارجية.

لا يمكنك تعديل رقم مشروع. في حال حذف مشروع، سيتم أيضًا حذف رقم المشروع ولن يتمكّن أي مشروع آخر من استخدامه مرة أخرى.

رقم تعريف المشروع

يحتوي مشروع Firebase (والمشروع Google Cloud المرتبط به) على رقم تعريف المشروع. هذا المعرّف هو معرّف فريد يحدّده المستخدم للمشروع على مستوى جميع منتجات Firebase وGoogle Cloud. عند إنشاء مشروع على Firebase، يمنح Firebase تلقائيًا معرّفًا فريدًا للمشروع، ولكن يمكنك تعديله أثناء إعداد المشروع. يجب بشكل عام التعامل مع هذا المعرّف كاسم مستعار مناسب للإشارة إلى المشروع.

ملفات إعداد Firebase وعناصرها

عند تسجيل تطبيق في مشروع Firebase، توفّر لك وحدة تحكّم Firebase ملف إعداد Firebase (تطبيقات Apple أو Android) أو عنصر إعداد (تطبيقات الويب) يمكنك إضافته مباشرةً إلى دليل التطبيق على جهازك.

  • بالنسبة إلى تطبيقات Apple، يمكنك إضافة ملف إعداد GoogleService-Info.plist.
  • بالنسبة إلى تطبيقات Android، يمكنك إضافة ملف إعداد google-services.json.
  • بالنسبة إلى تطبيقات الويب، يمكنك إضافة عنصر إعدادات Firebase.

يمكنك في أي وقت الحصول على ملف إعداد Firebase أو عنصر لتطبيق.

يربط ملف أو عنصر إعدادات Firebase تطبيقًا بمشروع Firebase محدّد وبالموارد التابعة له (قواعد البيانات، وحِزم التخزين، وما إلى ذلك). يتضمّن الإعداد "خيارات Firebase"، وهي مَعلمات مطلوبة من Firebase وخدمات Google للتواصل مع واجهات برمجة التطبيقات لخادم Firebase وربط بيانات العميل بمشروع Firebase وتطبيق Firebase. إليك الحد الأدنى المطلوب من "خيارات Firebase":

  • مفتاح واجهة برمجة التطبيقات: سلسلة مشفّرة بسيطة يتم استخدامها عند استدعاء واجهات برمجة تطبيقات معيّنة لا تحتاج إلى الوصول إلى بيانات المستخدم الخاصة (القيمة النموذجية: AIzaSyDOCAbC123dEf456GhI789jKl012-MnO)

  • رقم تعريف المشروع: هو معرّف فريد يحدّده المستخدم للمشروع على مستوى جميع خدمات Firebase وGoogle Cloud. قد يظهر هذا المعرّف في عناوين URL أو أسماء بعض موارد Firebase، ولكن يجب بشكل عام التعامل معه كاسم مستعار مناسب للإشارة إلى المشروع. (قيمة مثال: myapp-project-123)

  • معرّف التطبيق (AppID): هو المعرّف الفريد لتطبيق Firebase على جميع خدمات Firebase بتنسيق خاص بالنظام الأساسي:

    • تطبيقات Apple على Firebase: GOOGLE_APP_ID (قيمة مثال: 1:1234567890:ios:321abc456def7890)
      هذا ليس معرّف حزمة Apple.
    • تطبيقات Android على Firebase: mobilesdk_app_id (قيمة مثال: 1:1234567890:android:321abc456def7890)
      هذا ليس اسم حزمة Android أو رقم تعريف تطبيق Android.
    • تطبيقات Firebase على الويب: appId (قيمة مثال: 1:65211879909:web:3ae38ef1cdcb2e01fe5f0c)

يُعدّ محتوى ملف إعدادات Firebase أو عنصر إعدادات Firebase عامًا، بما في ذلك المعرّف الخاص بالنظام الأساسي للتطبيق (معرِّف حزمة Apple أو اسم حزمة Android) والقيم الخاصة بمشروع Firebase، مثل مفتاح واجهة برمجة التطبيقات ورقم تعريف المشروع وعنوان URL الخاص بـ Realtime Database واسم حزمة Cloud Storage. في ضوء ذلك، استخدِم Firebase Security Rules لحماية بياناتك وملفاتك في Realtime Database وCloud Firestore وCloud Storage.

بالنسبة إلى المشاريع المفتوحة المصدر، لا ننصح عمومًا بتضمين ملف أو عنصر إعدادات Firebase للتطبيق في نظام التحكّم بالمصادر، لأنّه في معظم الحالات، على المستخدمين إنشاء مشاريع Firebase الخاصة بهم وتوجيه تطبيقاتهم إلى موارد Firebase الخاصة بهم (من خلال ملف أو عنصر إعدادات Firebase الخاص بهم).

الحدود العامة لمشاريع وتطبيقات ومواقع Firebase

في ما يلي بعض الحدود العامة لمشاريع وتطبيقات ومواقع Firebase الإلكترونية:

  • عدد المشاريع لكل حساب Google (عنوان البريد الإلكتروني)

    • خطة Spark الأساسية: تقتصر حصة إنشاء المشاريع على عدد صغير من المشاريع (عادةً ما يتراوح بين 5 و10 مشاريع).
    • خطة Blaze المَرِنة: لا يزال عدد المشاريع التي يمكن إنشاؤها محدودًا، ولكن قد يزداد عند ربط حساب Cloud Billing في وضع جيد.

    يُرجى ملاحظة ما يلي بشأن الحدّ الأقصى المسموح به لعدد المشاريع التي يمكنك إنشاؤها:

    • هذا الحدّ ليس خاصًا بمنصة Firebase. تتشابه حدود حصة المشاريع في Firebase مع تلك الخاصة بـ Google Cloud.
    • في الحالات النادرة التي تحتاج فيها إلى ذلك، يمكنك طلب زيادة حصة المشروع.
    • يتطلّب الحذف الكامل للمشروع 30 يومًا، ويتم احتسابه ضمن حصة المشروع إلى أن يتم حذفه بالكامل.

    تعرَّف على أفضل الممارسات العامة التي تنصح بها Firebase لإعداد مشاريع Firebase.

  • عدد التطبيقات لكل مشروع

    تفرض Firebase حدًا أقصى يبلغ 30 تطبيقًا إجماليًا على عدد تطبيقات Firebase ضمن مشروع Firebase.

    يجب التأكّد من أنّ جميع تطبيقات Firebase ضِمن مشروع Firebase واحد هي إصدارات متوافقة مع منصات مختلفة من التطبيق نفسه من منظور المستخدم النهائي. يمكنك الاطّلاع على مزيد من المعلومات حول الاستخدام المتعدّد في مستندات أفضل الممارسات.

    يمكنك الاطّلاع على مزيد من المعلومات حول الحدّ الأقصى لعدد التطبيقات لكل مشروع في الأسئلة الشائعة.

  • عدد المواقع الإلكترونية Hosting لكل مشروع

    تتيح ميزة المواقع المتعددة في Firebase Hosting استخدام 36 موقعًا إلكترونيًا كحد أقصى لكل مشروع.

إطلاق تطبيقك