افهم مشاريع Firebase

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

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

مشروع Firebase هو كيان المستوى الأعلى لـ Firebase. في المشروع ، يمكنك تسجيل تطبيقات Apple أو Android أو الويب. بعد تسجيل تطبيقاتك في Firebase ، يمكنك إضافة Firebase SDKs لأي عدد من منتجات Firebase ، مثل Analytics أو Cloud Firestore أو مراقبة الأداء أو Remote Config.

تعرف على مزيد من المعلومات التفصيلية حول هذه العملية في دليل البدء لمنصتك:
iOS + | أندرويد | الويب | الوحدة | C ++ | رفرفة .

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

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

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

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

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

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

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

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

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

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

نظرًا لأن مشروع 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 Console بدلاً من وحدة تحكم Firebase.

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

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

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

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

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

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

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

اسم المشروع

عندما تنشئ مشروعًا ، فإنك توفر اسمًا للمشروع . هذا المعرّف هو الاسم الداخلي فقط لمشروع ما في Firebase console و Google Cloud Console و 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 )

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

    • تطبيقات Firebase Apple: GOOGLE_APP_ID (مثال للقيمة: 1:1234567890:ios:321abc456def7890 )
      هذا ليس معرف حزمة Apple.
    • تطبيقات Firebase Android: mobilesdk_app_id (مثال للقيمة: 1:1234567890:android:321abc456def7890 )
      هذا ليس اسم حزمة Android أو معرف تطبيق Android.
    • تطبيقات Firebase Web: 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:

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

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

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

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

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

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

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

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

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

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

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