فهم مشاريع Firebase

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

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

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

تعرف على المزيد من المعلومات التفصيلية حول هذه العملية في قسم "البدء" الدليل الإرشادي لنظام التشغيل الذي تستخدمه:
+iOS | Android | الويب | الانسجام | C++ | Flutter.

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

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

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

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

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

    • تشترك جميع تطبيقات Firebase المسجّلة في مشروع Firebase نفسه بالطريقة نفسها مثل Firebase Hosting والمصادقة وقاعدة بيانات الوقت الفعلي وCloud Firestore التخزين السحابي ووظائف السحابة.

    • ترتبط جميع تطبيقات Firebase المسجَّلة في مشروع Firebase نفسه بموقع "إحصاءات Google" نفسه، حيث يُعد كل تطبيق في 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). عند إعداد مشروع التطبيقات وتسجيلها، تحتاج إلى اتخاذ بعض القرارات التنظيمية وإضافة معلومات الإعداد المتعلّقة بمنصة Firebase لمشاريعك المحلية

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

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

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

وحدة تحكُّم Firebase

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

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

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

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

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

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

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

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

واجهة برمجة التطبيقات REST Management في Firebase

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

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

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

اسم المشروع

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

يمكنك تعديل اسم مشروع متى شئت من خلال الانتقال إلى مشروع الإعدادات "وحدة تحكُّم Firebase". يتم عرض اسم المشروع في الجزء العلوي.

رقم المشروع

يعد مشروع Firebase (و المرتبط بمشروع Google Cloud) رقم المشروع. هذا هو عنوان URL الأساسي الفريد الذي حدّده محرّك بحث 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 بالكامل بتنسيق خاص بالنظام الأساسي:

    • تطبيقات 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 لقاعدة بيانات الوقت الفعلي واسم حزمة Cloud Storage بناءً على ذلك، استخدام قواعد أمان Firebase لحماية بياناتك وملفاتك في Realtime Database، Cloud Firestore، وCloud Storage

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

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

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

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

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

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

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

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

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

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

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

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

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

إطلاق التطبيق