بدء استخدام 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 بالإضافة إلى وحدة تحكّم Google Cloud ووحدة تحكّم Google APIs.

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

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

وحدة تحكّم Firebase

  1. انتقِل إلى وحدة تحكّم Firebase.

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

  3. انقر على إنشاء مشروع.

  4. في أسفل الصفحة، انقر على الرابط الخاص بحالة هل لديك مشروع على Google Cloud؟

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

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

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

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

    يُرجى العلم أنّ تفعيل Google Analytics اختياري.

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

  1. في حال عدم إجراء ذلك من قبل، ثبِّت Firebase CLI.

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

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

    firebase projects:addfirebase

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

  5. إذا لم يسبق لك قبول بنود Firebase، افتح أحد projects Firebase في وحدة تحكُّم Firebase لقبول البنود. اطّلِع على مزيد من المعلومات عن متطلبات اتّباع بنود Firebase في هذه الأسئلة الشائعة.

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

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

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

  3. فعِّل خدمات Firebase للمشروع من خلال الاتصال بالرقم projects.addFirebase.

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

  4. إذا لم يسبق لك قبول بنود Firebase، افتح أحد projects Firebase في وحدة تحكُّم Firebase لقبول البنود. اطّلِع على مزيد من المعلومات عن متطلبات اتّباع بنود Firebase في هذه الأسئلة الشائعة.

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

Terraform

  1. فعِّل واجهة برمجة التطبيقات Firebase Management API (firebase.googleapis.com) في مشروع Google Cloud الحالي.

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

  3. إذا لم يسبق لك قبول بنود Firebase، افتح أحد projects Firebase في وحدة تحكُّم Firebase لقبول البنود. اطّلِع على مزيد من المعلومات عن متطلبات اتّباع بنود Firebase في هذه الأسئلة الشائعة.

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

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

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

  • اطّلِع على المراجع التالية لمعرفة المزيد عن مشاريع Firebase:

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

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

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