تقدم هذه الصفحة لمحات عامة مختصرة عن العديد من المفاهيم المهمة حول مشاريع Firebase. عندما تكون متاحة، اتبع الروابط للعثور على معلومات أكثر تفصيلاً حول الميزات والخدمات والأدوات وأفضل الممارسات.
مشروع Firebase هو الكيان ذو المستوى الأعلى لـ Firebase. في المشروع، يمكنك تسجيل تطبيقات Apple أو Android أو الويب الخاصة بك. بعد تسجيل تطبيقاتك في Firebase، يمكنك إضافة حزم Firebase SDK لأي عدد من منتجات Firebase ، مثل Analytics أو Cloud Firestore أو مراقبة الأداء أو التكوين عن بُعد.
تعرف على المزيد من المعلومات التفصيلية حول هذه العملية في دليل الخطوات الأولى لنظامك الأساسي:
دائرة الرقابة الداخلية + | أندرويد | الويب | الوحدة | سي++ | رفرفة .
يوضح هذا الرسم البياني التسلسل الهرمي الأساسي لمشروع 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 خلف الكواليس. يمكنك أيضًا إنشاء مشروع Google Cloud أولاً، ثم إضافة Firebase إلى المشروع لاحقًا. يمكنك التفكير في مشروع Google Cloud كحاوية افتراضية للبيانات والتعليمات البرمجية والتكوين والخدمات.
لاحظ أنه بالنسبة لجميع مشاريع Firebase، يضيف Firebase تلقائيًا تصنيف firebase:enabled
داخل صفحة التصنيفات لمشروعك في وحدة تحكم Google Cloud. تعرف على المزيد حول هذه التسمية في الأسئلة الشائعة .
نظرًا لأن مشروع Firebase هو مشروع Google Cloud:
يمكنك التفاعل مع مشروع في وحدة تحكم Firebase وكذلك في وحدة تحكم Google Cloud وفي وحدة تحكم Google APIs .
يمكنك استخدام المنتجات وواجهات برمجة التطبيقات من Firebase وGoogle Cloud في المشروع.
تتم مشاركة الفوترة والأذونات للمشروع عبر Firebase وGoogle Cloud.
تتم مشاركة المعرفات الفريدة للمشروع (مثل رقم المشروع ومعرف المشروع ) عبر Firebase وGoogle Cloud.
يؤدي حذف المشروع إلى حذفه عبر Firebase وGoogle Cloud.
يمكنك إعداد مشروع Firebase وتسجيل التطبيقات في وحدة تحكم Firebase (أو، لحالات الاستخدام المتقدمة، عبر Firebase Management REST API أو Firebase CLI ). عند إعداد مشروع وتسجيل التطبيقات، يتعين عليك اتخاذ بعض القرارات التنظيمية وإضافة معلومات التكوين الخاصة بـ Firebase إلى مشاريعك المحلية.
بالنسبة لتطبيقات الإنتاج، تحتاج إلى إعداد سير عمل تطوير واضح، والذي يتضمن عادةً استخدام بيئات متعددة. راجع وثائقنا المتعلقة بسير عمل المطورين ، بما في ذلك أفضل الممارسات العامة وإرشادات الأمان العامة لإعداد مشاريع Firebase وتسجيل التطبيقات لإنشاء سير عمل التطوير الخاص بك.
إلى جانب حزم SDK للمنتج، يمكنك التفاعل مباشرة مع مشروع Firebase باستخدام العديد من الأدوات والواجهات المختلفة.
توفر وحدة تحكم Firebase البيئة الأكثر ثراءً لإدارة منتجات Firebase والتطبيقات والإعدادات على مستوى المشروع.
تسرد اللوحة الموجودة على الجانب الأيسر من وحدة التحكم منتجات Firebase، مرتبة حسب فئات المستوى الأعلى. في الجزء العلوي من اللوحة اليمنى، قم بالوصول إلى إعدادات المشروع من خلال النقر على عمليات التكامل وأذونات الوصول والفوترة .
. تتضمن إعدادات المشروعيعرض منتصف وحدة التحكم الأزرار التي تطلق عمليات سير عمل الإعداد لتسجيل أنواع مختلفة من التطبيقات. بعد البدء في استخدام Firebase، تتغير المنطقة الرئيسية لوحدة التحكم إلى لوحة معلومات تعرض إحصائيات حول المنتجات التي تستخدمها.
لاحظ أنه نظرًا لأن مشروع Firebase هو أيضًا مشروع Google Cloud، فقد تجد أن العديد من المهام أو المنتجات تتطلب منك استخدام وحدة تحكم Google Cloud بدلاً من وحدة تحكم Firebase.
يقدم Firebase أيضًا واجهة سطر أوامر Firebase لتكوين منتجات معينة من Firebase وإدارتها، مثل استضافة Firebase، والوظائف السحابية لـ Firebase، وFirebase Extensions.
بعد تثبيت واجهة سطر الأوامر (CLI)، يمكنك الوصول إلى أمر firebase
العمومي . استخدم واجهة سطر الأوامر (CLI) لربط دليل تطبيقك المحلي بمشروع Firebase ، ثم انشر إصدارات جديدة من المحتوى المستضاف على Firebase أو تحديثات للوظائف.
باستخدام Firebase Management REST API ، يمكنك إدارة مشروع Firebase برمجيًا. على سبيل المثال، يمكنك تسجيل تطبيق ما برمجيًا في مشروع أو إدراج التطبيقات المسجلة بالفعل ( iOS+ | Android | web ).
يمكن تحديد مشروع Firebase في الواجهة الخلفية لـ Firebase وفي واجهات المطورين المختلفة باستخدام معرفات مختلفة، بما في ذلك اسم المشروع ورقم المشروع ومعرف المشروع .
عند إنشاء مشروع، يمكنك توفير اسم المشروع . هذا المعرف هو الاسم الداخلي فقط لمشروع في وحدة تحكم Firebase ، ووحدة تحكم Google Cloud ، و Firebase CLI . لا يتم عرض اسم المشروع في أي منتج أو خدمة أو مورد مرئي للعامة من Firebase أو Google Cloud؛ إنه ببساطة يساعدك على التمييز بسهولة أكبر بين المشاريع المتعددة.
يمكنك تعديل اسم المشروع في أي وقت من خلال Project الخاصة بوحدة تحكم Firebase. يتم عرض اسم المشروع في الجزء العلوي.
يحتوي مشروع Firebase ( ومشروع Google Cloud المرتبط به) على رقم مشروع . هذا هو المعرّف الأساسي العالمي الفريد الذي خصصته Google للمشروع. استخدم هذا المعرف عند تكوين عمليات التكامل و/أو إجراء استدعاءات واجهة برمجة التطبيقات (API) لخدمات Firebase أو Google أو خدمات الجهات الخارجية.
لا يمكنك تعديل رقم المشروع. إذا قمت بحذف مشروع، فسيتم حذف رقم المشروع أيضًا ولا يمكن استخدامه مرة أخرى بواسطة أي مشروع آخر.
ابحث عن رقم مشروع مشروع Firebase باستخدام أحد الخيارات التالية:
باستخدام وحدة تحكم Firebase : انقر فوق إعدادات المشروع . يتم عرض رقم المشروع في الجزء العلوي.
باستخدام Firebase CLI : قم بتشغيل
firebase projects:list
. يتم عرض رقم المشروع مع جميع مشاريع Firebase المرتبطة بحسابك.استخدام Firebase Management REST API : استدعاء
projects.list
. يحتوي نص الاستجابة على رقم المشروع في كائنFirebaseProject
.
بالنسبة للعديد من استدعاءات واجهة برمجة التطبيقات (API)، يتعين عليك تضمين معرف فريد للمشروع. على الرغم من أن العديد من واجهات برمجة التطبيقات تقبل معرف المشروع ، فمن المستحسن استخدام رقم المشروع لإجراء استدعاءات واجهة برمجة التطبيقات إلى Firebase أو Google أو خدمات الجهات الخارجية.
تعرف على المزيد حول استخدام معرفات المشروع، وخاصة رقم المشروع، في معيار Google AIP 2510 .
يحتوي مشروع Firebase ( ومشروع Google Cloud المرتبط به) على معرف مشروع . هذا هو المعرف الفريد الذي يحدده المستخدم للمشروع عبر كل من Firebase وGoogle Cloud. عند إنشاء مشروع Firebase، يقوم Firebase تلقائيًا بتعيين معرف فريد للمشروع، ولكن يمكنك تعديله أثناء إعداد المشروع. يجب التعامل مع هذا المعرف عمومًا كاسم مستعار مناسب للإشارة إلى المشروع.
ابحث عن معرف مشروع مشروع Firebase باستخدام أحد الخيارات التالية:
باستخدام وحدة تحكم Firebase : انقر فوق إعدادات المشروع . يتم عرض معرف المشروع في الجزء العلوي.
باستخدام Firebase CLI : قم بتشغيل
firebase projects:list
. يتم عرض معرف المشروع مع جميع مشاريع Firebase المرتبطة بحسابك.استخدام Firebase Management REST API : استدعاء
projects.list
. يحتوي نص الاستجابة على معرف المشروع في كائنFirebaseProject
.
يتم عرض معرف المشروع في موارد Firebase المرئية بشكل عام، على سبيل المثال:
- النطاق الفرعي للاستضافة الافتراضي —
PROJECT_ID .web.app
وPROJECT_ID .firebaseapp.com
- عنوان URL الافتراضي لقاعدة بيانات الوقت الفعلي —
PROJECT_ID -default-rtdb.firebaseio.com
أوPROJECT_ID -default-rtdb. REGION_CODE .firebasedatabase.app
- الاسم الافتراضي لحاوية التخزين السحابي —
PROJECT_ID .appspot.com
بالنسبة لجميع الموارد المذكورة أعلاه، يمكنك إنشاء مثيلات غير افتراضية. الأسماء المرئية للعامة للأسماء غير الافتراضية قابلة للتخصيص بالكامل. يمكنك ربط النطاقات المخصصة بموقع يستضيفه Firebase، وتقسيم قاعدة بيانات الوقت الحقيقي ، وإنشاء مجموعات تخزين سحابية متعددة (تفضل بزيارة صفحة البدء الخاصة بالنظام الأساسي).
بالنسبة لبعض حالات الاستخدام، قد يكون لديك مشاريع Firebase متعددة مرتبطة بنفس دليل التطبيق المحلي. في هذه المواقف، عند استخدام واجهة سطر أوامر Firebase ، تحتاج إلى تمرير علامة --project
مع أوامر firebase
للتواصل مع مشروع Firebase الذي تريد التفاعل معه.
يمكنك أيضًا إعداد اسم مستعار للمشروع لكل مشروع في Firebase حتى لا تضطر إلى تذكر معرفات المشروع.
بالنسبة للعديد من استدعاءات واجهة برمجة التطبيقات (API)، يتعين عليك تضمين معرف فريد للمشروع. على الرغم من أن العديد من واجهات برمجة التطبيقات تقبل معرف المشروع، فمن المستحسن استخدام رقم المشروع لإجراء استدعاءات واجهة برمجة التطبيقات إلى Firebase أو Google أو خدمات الجهات الخارجية.
تعرف على المزيد حول استخدام معرفات المشروع، وخاصة رقم المشروع، في معيار Google AIP 2510 .
عند تسجيل تطبيق في مشروع 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:
يعتبر محتوى ملف أو كائن تكوين Firebase عامًا، بما في ذلك المعرف الخاص بالنظام الأساسي للتطبيق (معرف حزمة Apple أو اسم حزمة Android) والقيم الخاصة بمشروع Firebase، مثل مفتاح API، ومعرف المشروع، وعنوان URL لقاعدة بيانات Realtime، و اسم حاوية التخزين السحابي. نظرًا لهذا، استخدم قواعد أمان Firebase لحماية بياناتك وملفاتك في Realtime Database و Cloud Firestore و Cloud Storage .
بالنسبة للمشروعات مفتوحة المصدر، لا نوصي عمومًا بتضمين ملف أو كائن تكوين Firebase الخاص بالتطبيق في التحكم بالمصدر لأنه، في معظم الحالات، يجب على المستخدمين إنشاء مشاريع Firebase الخاصة بهم وتوجيه تطبيقاتهم إلى موارد Firebase الخاصة بهم (عبر تكوين Firebase الخاص بهم ملف أو كائن).
فيما يلي بعض الحدود العامة لمشاريع وتطبيقات ومواقع Firebase:
عدد المشاريع لكل حساب
- خطة تسعير Spark - تقتصر حصة إنشاء المشروع على عدد أقل من المشاريع (عادةً حوالي 5-10).
- خطة تسعير Blaze - تزداد حصة إنشاء المشروع لكل حساب بشكل كبير طالما أن حساب الفوترة السحابية المرتبط في وضع جيد.
نادرًا ما يشكل الحد الأقصى لحصة إنشاء المشروع مصدر قلق لمعظم المطورين، ولكن إذا لزم الأمر، يمكنك طلب زيادة في حصة المشروع .
انتبه إلى أن الحذف الكامل للمشروع يتطلب 30 يومًا ويتم احتسابه ضمن حصة المشروع حتى يتم حذف المشروع بالكامل.
عدد التطبيقات لكل مشروع
يقيد Firebase العدد الإجمالي لتطبيقات Firebase ضمن مشروع Firebase إلى 30.
يجب عليك التأكد من أن جميع تطبيقات Firebase ضمن مشروع Firebase واحد هي متغيرات النظام الأساسي لنفس التطبيق من منظور المستخدم النهائي. اقرأ المزيد حول الإيجارات المتعددة في مستندات أفضل الممارسات لدينا.
تعرف على المزيد حول الحد الأقصى للتطبيقات لكل مشروع في الأسئلة الشائعة.
عدد مواقع الاستضافة لكل مشروع
تدعم ميزة استضافة Firebase متعددة المواقع 36 موقعًا كحد أقصى لكل مشروع.
- قم بإعداد تنبيهات الميزانية لمشروعك في وحدة تحكم Google Cloud.
- راقب لوحة تحكم الاستخدام والفوترة في وحدة تحكم Firebase للحصول على صورة شاملة لاستخدام مشروعك عبر خدمات Firebase المتعددة.
- قم بمراجعة القائمة المرجعية لإطلاق Firebase .