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

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

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

مشروع Firebase هو الكيان ذو المستوى الأعلى في Firebase. في المشروع، يمكنك تسجيل تطبيقاتك على Apple أو Android أو الويب. بعد تسجيل تطبيقاتك في Firebase، يمكنك إضافة حِزم تطوير البرامج (SDK) لمنصة Firebase لأي عدد من منتجات 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 وكذلك في وحدة تحكّم Google Cloud و وحدة تحكّم Google APIs.

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

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

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

  • تتم مشاركة الفوترة للمشروع بين Firebase وGoogle Cloud. في حال تفعيل الفوترة في مشروع "Google Cloud"، سيتم تطبيق خطة أسعار Blaze المَرِنة في Firebase على مشروعك على Firebase.

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

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

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

  • ينطبق حذف أو تعديل مورد أو بيانات ضمن المشروع على كل من Firebase و"Google Cloud".

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

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

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

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

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

وحدة تحكّم Firebase

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

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

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

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

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

توفّر Firebase أيضًا Firebase CLI لإعداد مشروع Firebase وإدارته ومعظم منتجات Firebase.

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

Firebase Management REST API

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

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

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

اسم المشروع

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

يمكنك تعديل اسم المشروع في أي وقت في اللوحة العلوية من الإعدادات > علامة التبويب الإعدادات العامة في وحدة تحكّم "Firebase".

رقم المشروع

يتضمّن مشروع 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"، وهي مَعلمات مطلوبة من قِبل Firebase وخدمات Google للتواصل مع واجهات برمجة التطبيقات لخادم Firebase وربط بيانات العميل بمشروع Firebase وتطبيق Firebase.

في ما يلي الحد الأدنى المطلوب من "خيارات Firebase":

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

إطلاق تطبيقك