افهم مشاريع Firebase

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

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

مشروع Firebase هو الكيان ذو المستوى الأعلى لـ Firebase. في المشروع، يمكنك تسجيل تطبيقات Apple أو Android أو الويب الخاصة بك. بعد تسجيل تطبيقاتك في Firebase، يمكنك إضافة حزم Firebase SDK لأي عدد من منتجات Firebase ، مثل Analytics أو Cloud Firestore أو مراقبة الأداء أو التكوين عن بُعد.

تعرف على المزيد من المعلومات التفصيلية حول هذه العملية في دليل الخطوات الأولى لنظامك الأساسي:
دائرة الرقابة الداخلية + | أندرويد | الويب | الوحدة | سي++ | رفرفة .

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

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

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

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

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

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

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

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

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

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

نظرًا لأن مشروع Firebase هو مشروع Google Cloud:

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

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

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

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

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

وحدة تحكم Firebase

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

وحدة تحكم Firebase - شاشة نظرة عامة على المشروع

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

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

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

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

يقدم Firebase أيضًا واجهة سطر أوامر Firebase لتكوين منتجات معينة من Firebase وإدارتها، مثل استضافة Firebase، والوظائف السحابية لـ Firebase، وFirebase Extensions.

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

واجهة برمجة تطبيقات إدارة Firebase REST

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

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

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

اسم المشروع

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

يمكنك تعديل اسم المشروع في أي وقت من خلال Project الخاصة بوحدة تحكم Firebase. يتم عرض اسم المشروع في الجزء العلوي.

رقم المشروع

يحتوي مشروع Firebase ( ومشروع Google Cloud المرتبط به) على رقم مشروع . هذا هو المعرّف الأساسي العالمي الفريد الذي خصصته Google للمشروع. استخدم هذا المعرف عند تكوين عمليات التكامل و/أو إجراء استدعاءات واجهة برمجة التطبيقات (API) لخدمات 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":

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

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

  • معرف التطبيق ("AppID") : المعرف الفريد لتطبيق Firebase عبر كل Firebase بتنسيق خاص بالنظام الأساسي:

    • تطبيقات 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، مثل مفتاح API، ومعرف المشروع، وعنوان URL لقاعدة بيانات Realtime، و اسم حاوية التخزين السحابي. نظرًا لهذا، استخدم قواعد أمان Firebase لحماية بياناتك وملفاتك في Realtime Database و Cloud Firestore و Cloud Storage .

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

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

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

  • عدد المشاريع لكل حساب

    • خطة تسعير Spark - تقتصر حصة إنشاء المشروع على عدد أقل من المشاريع (عادةً حوالي 5-10).
    • خطة تسعير Blaze - تزداد حصة إنشاء المشروع لكل حساب بشكل كبير طالما أن حساب الفوترة السحابية المرتبط في وضع جيد.

    نادرًا ما يشكل الحد الأقصى لحصة إنشاء المشروع مصدر قلق لمعظم المطورين، ولكن إذا لزم الأمر، يمكنك طلب زيادة في حصة المشروع .

    انتبه إلى أن الحذف الكامل للمشروع يتطلب 30 يومًا ويتم احتسابه ضمن حصة المشروع حتى يتم حذف المشروع بالكامل.

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

    يقيد Firebase العدد الإجمالي لتطبيقات Firebase ضمن مشروع Firebase إلى 30.

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

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

  • عدد مواقع الاستضافة لكل مشروع

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

إطلاق التطبيق الخاص بك