Catch up on everthing we announced at this year's Firebase Summit. Learn more

افهم مشاريع Firebase

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

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

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

معرفة معلومات أكثر تفصيلا حول هذه العملية في أدلة الشروع في العمل ( منصات أبل | أندرويد | ويب | الوحدة | C ++ ).

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

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

منذ مشروع Firebase هو مشروع جوجل الغيمة:

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

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

تأكد من مراجعة بعض أفضل الممارسات العامة على مستوى المشروع (في أسفل هذه الصفحة) قبل إعداد مشروع وتسجيل التطبيقات.

اسم المشروع

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

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

رقم المشروع

مشروع Firebase (ولها مشروع سحابة Google المقترنة ) لديها عدد المشاريع. هذا هو المعرف المتعارف عليه عالميًا والفريد من نوعه للمشروع من قِبل Google. استخدم هذا المعرف عند تكوين عمليات الدمج و / أو إجراء مكالمات API إلى Firebase أو Google أو خدمات الجهات الخارجية.

مكالمات API ورقم المشروع

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

معرفة المزيد حول استخدام معرفات المشروع، ولا سيما عدد المشاريع، في جوجل AIP 2510 القياسية .

ابحث عن رقم المشروع

  • وحدة التحكم Firebase: انقر على إعدادات المشروع . يتم عرض رقم المشروع في الجزء العلوي.

  • Firebase CLI: تشغيل firebase projects:list . يتم عرض رقم المشروع مع جميع مشاريع Firebase المرتبطة بحسابك.

  • Firebase إدارة REST API: نداء projects.list . يحتوي الجسم استجابة عدد المشاريع في FirebaseProject الكائن.

معرّف المشروع

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

إذا حذفت مشروعًا ، فسيتم أيضًا حذف معرف المشروع ولا يمكن استخدامه مرة أخرى من قبل أي مشروع آخر.

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

يتم عرض معرّف المشروع في موارد 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 CLI ومعرف المشروع

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

يمكنك أيضا إنشاء اسم مستعار مشروع لكل مشروع Firebase بحيث لم يكن لديك لنتذكر معرفات المشروع.

مكالمات API ومعرف المشروع

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

معرفة المزيد حول استخدام معرفات المشروع، ولا سيما عدد المشاريع، في جوجل AIP 2510 القياسية .

ابحث عن معرّف المشروع

  • وحدة التحكم Firebase: انقر على إعدادات المشروع . يتم عرض معرف المشروع في الجزء العلوي.

  • Firebase CLI: تشغيل firebase projects:list . يتم عرض معرّف المشروع مع جميع مشاريع Firebase المرتبطة بحسابك.

  • Firebase إدارة REST API: نداء projects.list . الجسم استجابة يحتوي على ID المشروع في FirebaseProject الكائن.

ملفات وكائنات تهيئة Firebase

عند تسجيل تطبيق في مشروع Firebase ، توفر وحدة تحكم Firebase ملف تكوين Firebase (تطبيقات Apple / Android) أو كائن تكوين (تطبيقات الويب) تضيفه مباشرة إلى دليل التطبيق المحلي.

  • لتطبيقات أبل، يمكنك إضافة GoogleService-Info.plist ملف التكوين.
  • لتطبيقات الروبوت، يمكنك إضافة google-services.json ملف التكوين.
  • بالنسبة لتطبيقات الويب ، يمكنك إضافة كائن تكوين Firebase.

في أي وقت، يمكنك الحصول على ملف التكوين Firebase التطبيق أو الكائن .

يربط ملف أو كائن تهيئة Firebase تطبيقًا بمشروع Firebase محدد وموارده (قواعد البيانات ، وحاويات التخزين ، وما إلى ذلك). يتضمن التكوين "خيارات Firebase" ، وهي معلمات مطلوبة من قِبل Firebase وخدمات Google للتواصل مع واجهات برمجة تطبيقات خادم Firebase ولربط بيانات العميل بمشروع Firebase وتطبيق Firebase. فيما يلي الحد الأدنى المطلوب من "خيارات Firebase":

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

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

  • ID التطبيق ( "معرف التطبيق"): المعرف الفريد للتطبيق Firebase في جميع Firebase مع شكل منصة محددة:

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

يعتبر محتوى ملف أو كائن تكوين Firebase عامًا ، بما في ذلك معرف النظام الأساسي للتطبيق (معرف حزمة Apple أو اسم حزمة Android) والقيم الخاصة بمشروع Firebase ، مثل مفتاح API ومعرف المشروع وعنوان URL لقاعدة بيانات Realtime و اسم حاوية التخزين السحابي. ونظرا لهذا، واستخدام قواعد الأمن Firebase لحماية البيانات والملفات الخاصة بك في قاعدة بيانات في الوقت الحقيقي ، سحابة Firestore ، و سحابة التخزين .

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

إدارة مشروع Firebase

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

أدوات لإدارة المشروع

وحدة تحكم Firebase

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

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

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

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

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

Firebase كما يقدم Firebase CLI لتكوين وإدارة منتجات محددة Firebase، مثل Firebase استضافة وظائف الغيمة لFirebase.

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

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

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

أفضل الممارسات العامة

إضافة تطبيقات لمشروع

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

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

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

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

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

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

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

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

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

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

    تعلم المزيد عن الحد على تطبيقات لكل مشروع في التعليمات.

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

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

متعدد الايجار

لا يُنصح بربط العديد من التطبيقات و / أو مواقع الويب المختلفة المستقلة منطقيًا بمشروع Firebase واحد (يُطلق عليه غالبًا "متعدد الإيجارات"). يمكن أن يؤدي تعدد المستأجرين إلى مشاكل خطيرة تتعلق بالتكوين وخصوصية البيانات ، بما في ذلك المشكلات غير المقصودة المتعلقة بتجميع التحليلات والمصادقة المشتركة وهياكل قواعد البيانات شديدة التعقيد والصعوبات المتعلقة بقواعد الأمان.

عموما، إذا كان مجموعة من التطبيقات لا يشتركون في نفس البيانات وتكوينات، والنظر بقوة تسجيل كل التطبيق مع مشروع Firebase مختلفة.

على سبيل المثال ، إذا قمت بتطوير تطبيق تسمية أولية ، فيجب أن يكون لكل تطبيق مصنف بشكل مستقل مشروع Firebase الخاص به ، ولكن يمكن أن يكون نظام Apple الأساسي وإصدارات Android من هذا التصنيف في نفس المشروع. يجب ألا يشارك كل تطبيق مصنف بشكل مستقل (لأسباب تتعلق بالخصوصية) البيانات مع الآخرين.

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