تقدّم هذه الصفحة ملخّصات موجزة لعدد من المفاهيم المهمة حول Firebase. مماثلة. اتّبِع الروابط للاطّلاع على معلومات أكثر تفصيلاً عند توفّرها. حول الميزات والخدمات والأدوات وأفضل الممارسات.
العلاقة بين المشاريع والتطبيقات والمنتجات في Firebase
مشروع Firebase هو الكيان ذو المستوى الأعلى في Firebase. في المشروع، يمكنك سجل Apple أو Android أو تطبيقات الويب. بعد تسجيل تطبيقاتك من خلال لمنصة Firebase، يمكنك إضافة حِزم تطوير البرامج (SDK) لمنصّة Firebase لأيّ عدد من منتجات Firebase، مثل Analytics، Cloud Firestore أو Performance Monitoring أو Remote Config
تعرف على المزيد من المعلومات التفصيلية حول هذه العملية في قسم "البدء"
الدليل الإرشادي لنظام التشغيل الذي تستخدمه:
+iOS | Android |
الويب | الانسجام | C++ |
Flutter.
فهم التسلسل الهرمي لمشروعات Firebase
يعرض هذا المخطّط البياني التسلسل الهرمي الأساسي لمشروع Firebase. إليك أهم التفاصيل
العلاقات:
يشبه مشروع Firebase حاوية جميع تطبيقاتك وأي موارد. والخدمات المقدمة للمشروع.
يمكن تسجيل تطبيق Firebase واحد أو أكثر في مشروع Firebase. (على سبيل المثال، كل من إصداري iOS وAndroid لأحد التطبيقات، أو الإصدارين المجانيين والإصدارات المدفوعة من التطبيق).
تشترك جميع تطبيقات Firebase المسجّلة في مشروع Firebase نفسه الوصول إلى جميع الموارد والخدمات نفسها المتوفرة للمشروع. وإليك بعض الأمثلة:
تشترك جميع تطبيقات Firebase المسجّلة في مشروع Firebase نفسه بالطريقة نفسها الخلفيات، مثل Firebase Hosting وAuthentication وRealtime Database وCloud Firestore Cloud Storage، وCloud Functions.
ترتبط جميع تطبيقات Firebase المسجَّلة في مشروع Firebase نفسه بموقع "إحصاءات Google" نفسه، حيث يُعد كل تطبيق في Firebase مصدر بيانات منفصل في ذلك الموقع
العلاقة بين مشاريع Firebase وGoogle Cloud
عندما تنشئ مشروع 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. (أو، بالنسبة إلى حالات الاستخدام المتقدّمة، من خلال Firebase Management REST API أو واجهة سطر الأوامر Firebase). عند إعداد مشروع التطبيقات وتسجيلها، تحتاج إلى اتخاذ بعض القرارات التنظيمية وإضافة معلومات الإعداد المتعلّقة بمنصة Firebase لمشاريعك المحلية
بالنسبة إلى تطبيقات الإنتاج، يجب وضع سير عمل واضح للتطوير. والتي تتضمن عادة استخدام بيئات متعددة. راجع وثائقنا حول وسير عمل مطوّري البرامج من بينها أفضل الممارسات العامة أو إرشادات الأمان العامة لإعداد مشاريع Firebase وتسجيل التطبيقات لإنشاء التطوير سير العمل.
التفاعل مع مشروع Firebase
بالإضافة إلى حِزم SDK الخاصة بالمنتجات، يمكنك التفاعل مباشرةً مع مشروع على Firebase باستخدام العديد من الأدوات والواجهات المختلفة.
وحدة تحكّم واحدة (Firebase)
توفّر وحدة تحكُّم Firebase البيئة الأكثر ثراءً لإدارة Firebase والمنتجات والتطبيقات والإعدادات على مستوى المشروع.
وحدة تحكم Firebase - شاشة نظرة عامة على المشروع"
class="attempt-rightscreen"
style="max-width: calc((100% - 40px)/1.75);">
تسرد اللوحة الجانبية لوحدة التحكم منتجات Firebase، مرتبة حسب فئات المستوى الأعلى. في الجزء العلوي من اللوحة اليمنى، يمكنك الوصول إلى ملف الإعدادات بالنقر على . يحدد المشروع الإعدادات تتضمن عمليات الدمج أذونات الوصول والفوترة.
يعرض منتصف وحدة التحكم الأزرار التي تطلق مهام سير عمل الإعداد لتسجيل أنواع مختلفة من التطبيقات. بعد أن تبدأ في استخدام Firebase، يتم تحديد الجزء الرئيسي تتغير وحدة التحكم إلى لوحة معلومات تعرض إحصائيات حول المنتجات التي استخدامها.
لاحظ أنه نظرًا لأن مشروع Firebase هو أيضًا مشروع Google Cloud، يمكنك أن المهام أو المنتجات المختلفة تتطلب منك استخدام Google Cloud بدلاً من وحدة تحكّم Firebase.
واجهة سطر الأوامر Firebase (أداة سطر أوامر)
يوفّر Firebase أيضًا واجهة سطر الأوامر Firebase لإعداد إدارة منتجات محددة في Firebase، مثل Firebase Hosting، Cloud Functions for Firebase، وFirebase Extensions.
بعد تثبيت واجهة سطر الأوامر، يمكنك الوصول إلى
الأمر 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:
يُعد محتوى ملف تهيئة Firebase أو كائنه عامًا، بما في ذلك رقم التعريف الخاص بالنظام الأساسي للتطبيق (معرّف حزمة Apple أو اسم حزمة Android) والقيم الخاصة بمشروع Firebase، مثل مفتاح واجهة برمجة التطبيقات ورقم تعريف المشروع عنوان URL لـ Realtime Database واسم حزمة Cloud Storage. بناءً على ذلك، استخدام Firebase Security Rules لحماية بياناتك وملفاتك في Realtime Database, Cloud Firestore, وCloud Storage.
بالنسبة إلى المشاريع مفتوحة المصدر، لا ننصح عمومًا بتضمين ملف تهيئة Firebase أو كائن في التحكم المصدر، لأنه في معظم الحالات، على المستخدمين إنشاء مشاريعهم الخاصة على Firebase وتوجيه تطبيقاتهم إلى موارد Firebase الخاصة بهم (عبر ملف أو كائن إعداد Firebase).
الحدود العامة للمشاريع والتطبيقات والمواقع الإلكترونية على Firebase
في ما يلي بعض الحدود العامة للمشاريع والتطبيقات والمواقع الإلكترونية على Firebase:
عدد المشاريع لكل حساب
- خطة تسعير Spark: حصة إنشاء المشروع تقتصر على عدد أقل من المشروعات (عادة حوالي 5-10).
- خطة أسعار Blaze - زيادة حصة إنشاء المشروع لكل حساب طالما أن حساب Cloud Billing المرتبط به وضع جيد.
نادرًا ما يكون الحد المفروض على حصة إنشاء المشروعات مصدر قلق لمعظم المطورين، ولكن إذا لزم الأمر، يمكنك طلب زيادة حصة المشروع.
كن على علم أن الحذف الكامل للمشروع يتطلب 30 يومًا وعددًا في حصة المشروع حتى يتم حذف المشروع بالكامل.
عدد التطبيقات لكل مشروع
يفرض Firebase قيودًا على العدد الإجمالي لتطبيقات Firebase ضمن مشروع Firebase. إلى 30.
يجب التأكّد من أنّ جميع "تطبيقات Firebase" ضمن مشروع واحد على Firebase النظام الأساسي للتطبيق نفسه من منظور المستخدم النهائي. القراءة المزيد عن فترات إقامة متعددة في مستندات أفضل الممارسات لدينا.
يمكنك الاطّلاع على مزيد من المعلومات عن سياسة الحد الأقصى لعدد التطبيقات لكل مشروع في الأسئلة الشائعة.
عدد Hosting موقع إلكتروني لكل مشروع
ميزة "Firebase Hosting" للمواقع الإلكترونية المتعددة يدعم 36 موقعًا كحد أقصى لكل مشروع.
إطلاق التطبيق
- إعداد الميزانية تنبيهات لمشروعك في وحدة تحكم Google Cloud.
- يمكنك مراقبة الاستخدام والفوترة لوحة البيانات في وحدة تحكم Firebase للحصول على صورة شاملة عبر خدمات Firebase المتعددة.
- راجِع قائمة التحقّق الخاصة بإطلاق Firebase.