بدء استخدام Firebase مع مشروع حالي على Google Cloud

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

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

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

بما أنّ مشروع Firebase هو مشروع على Google Cloud project:

  • يمكنك الوصول إلى المشروع والتفاعل معه في Firebase console بالإضافة إلى Google Cloud console و Google APIs console.

  • يمكنك التفاعل مع المشروع باستخدام الـ Firebase CLI والـ gcloud CLI و أي مورد من Terraform من Google.

  • يمكنك استخدام المنتجات وواجهات برمجة التطبيقات من كلٍّ من Firebase وGoogle Cloud في الـ مشروع.

  • تتم مشاركة أذونات وأدوار "إدارة الهوية وإمكانية الوصول" للمشروع بين Firebase وGoogle Cloud. أيّ إذن وصول يحصل عليه أحد أعضاء المشروع (أيّ مستخدم) إلى مشروعك على Google Cloud سينطبق أيضًا على مشروعك على Firebase (والعكس صحيح).

  • الفوترة للمشروع تتم مشاركتها بين Firebase و Google Cloud. إذا كانت الفوترة مفعَّلة في مشروعك على Google Cloud، سيتم إدراج مشروع Firebase ضمن خطة Blaze المَرِنة للدفع حسب الاستخدام في Firebase.

  • تتم مشاركة المعرّفات الفريدة للمشروع (مثل رقم تعريف المشروع و رقم المشروع) بين Firebase وGoogle Cloud.

  • أيّ تسلسل هرمي للموارد يتم تطبيقه على مشروعك Google Cloud (مثل المؤسسة والمجلدات وما إلى ذلك) سينطبق أيضًا على مشروع Firebase.

  • يؤدي حذف المشروع إلى حذفه في كلٍّ من Firebase وGoogle Cloud.

  • يؤدي حذف مورد أو بيانات أو تعديلها ضمن المشروع إلى تطبيق التغييرات في كلٍّ من Firebase و Google Cloud.

كيفية إضافة Firebase إلى مشروع حالي Google Cloud

يمكنك "إضافة Firebase" إلى مشروع حالي على Google Cloud باستخدام أيّ من الخيارات التالية. تأكَّد من أنّ لديك الأ101}ذونات المطلوبة لإضافة Firebase إلى مشروع Google Cloud.

يُرجى العِلم أنّه بعد "إضافة Firebase" إلى مشروع Google Cloud حالي، لا يمكن التراجع عن هذا الإجراء (أي لا يمكنك إزالة Firebase بالكامل من مشروع Google Cloud). مزيد من المعلومات في هذا السؤال الشائع.

Google Cloud

Firebase وحدة تحكّم

  1. سجِّل الدخول إلى وحدة تحكّم Firebase console باستخدام الحساب الذي يمنحك إذن الوصول إلى مشروع Google Cloud الحالي.

  2. انقر على الزر لإنشاء مشروع Firebase جديد.

  3. في أسفل الصفحة، انقر على إضافة Firebase إلى مشروع على Google Cloud.

  4. في حقل النص، ابدأ بإدخال اسم المشروع الحالي، ثم اختَر المشروع من القائمة المعروضة.

  5. انقر على فتح المشروع.

  6. اقبل بنود Firebase إذا طُلب منك ذلك.

  7. اتّبِع التعليمات الظاهرة على الشاشة "لإضافة Firebase" وإعداد مشروع على Firebase.

    يُرجى العِلم أنّ تفعيل ميزة "المساعدة المستندة إلى الذكاء الاصطناعي" في Firebase و Google Analytics هما إجراءان اختياريان.

Firebase CLI

  1. ثبِّت CLI Firebaseإذا لم يسبق لك إجراء ذلك.

  2. سجِّل الدخول باستخدام حساب Google نفسه الذي يمنحك إذن الوصول إلى المشروع الحالي Google Cloud.

  3. نفِّذ الأمر التالي:

    firebase projects:addfirebase

  4. عندما يُطلب منك ذلك، اختَر المشروع الحالي Google Cloud من القائمة المعروضة.

REST API

  1. فعِّل Firebase Management API في المشروع الحالي Google Cloud.

  2. أنشئ رمز دخول واجهة برمجة التطبيقات.

  3. فعِّل خدمات Firebase للمشروع من خلال استدعاء projects.addFirebase.

    يُرجى العِلم أنّك ستحتاج إلى اسم مورد مشروعك لإجراء هذا الاستدعاء.

للاطّلاع على تعليمات مفصّلة، يُرجى مراجعة مقالة إضافة خدمات Firebase إلى مشروعك في دليل Firebase: "إعداد مشروع على Firebase وإدارته باستخدام Management REST API". تأكَّد من اتّباع جميع التعليمات الواردة في قسم قبل البدء في هذا الدليل.

Terraform

  1. فعِّل Firebase Management API‏ (firebase.googleapis.com) في المشروع الحالي Google Cloud.

  2. فعِّل خدمات Firebase للمشروع باستخدام مورد google_firebase_project.

للاطّلاع على معلومات مفصّلة عن استخدام Firebase وTerraform، يُرجى مراجعة مقالة البدء في استخدام Terraform وFirebase.

الأسئلة الشائعة ونصائح تحديد المشاكل وحلّها

الخطوات التالية

  • يُرجى الاطّلاع على المَراجع التالية لمزيد من المعلومات عن مشاريع Firebase:

    • التعرّف على مشاريع Firebase — تقدّم هذه المقالة نظرات عامة موجزة عن العديد من المفاهيم المهمة حول مشاريع Firebase ، بما في ذلك علاقتها بـ Google Cloud والتسلسل الهرمي الأساسي للمشروع وتطبيقاته وموارده.

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

  • ابدأ باستخدام Firebase في تطبيقاتك للأجهزة الجوّالة وتطبيقات الويب من خلال تسجيل تطبيقاتك في مشروع Firebase وربطها بمنصة Firebase: iOS+ | Android | الويب | Flutter | Unity | C++.