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

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

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

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

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

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

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

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

  • تتم مشاركة أذونات وأدوار إدارة الهوية وإمكانية الوصول (IAM) للمشروع بين 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 حالي باستخدام أي من الخيارات التالية. تأكَّد من أنّ لديك الأذونات المطلوبة لإضافة Firebase إلى مشروع Google Cloud.

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

Firebase وحدة التحكّم

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

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

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

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

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

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

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

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

Firebase واجهة سطر الأوامر

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

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

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

    firebase projects:addfirebase

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

واجهة برمجة تطبيقات REST

  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++‎.