الربط بمشروع Firebase

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

التعرّف على مشاريع Firebase

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

يمكن أن يتضمّن مشروع Firebase تطبيقًا واحدًا أو أكثر من تطبيقات Firebase المسجّلة فيه (على سبيل المثال، كلّ من الإصدارَين المجاني والمدفوع من أحد التطبيقات)، ولكن ضَع في اعتبارك ما يلي:

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

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

ربط تطبيق Firebase Studio بمشروع على Firebase

لاستخدام خدمات Firebase في تطبيقك، عليك ربط تطبيقك بمشروع على Firebase. على سبيل المثال، إذا أردت استخدام Firebase Authentication، عليك الربط بمشروع على Firebase لتتمكّن من إنشاء حسابات المستخدمين وإدارتها. في مراحل معيّنة من عملية التطوير ، ينشئ Firebase Studio مشروعًا على Firebase لك، أو يمكنك اختيار إنشاء مشروع يدويًا.

الربط تلقائيًا بمشروع على Firebase

عند استخدام App Prototyping agent، يوفّر Firebase Studio مشروعًا على Firebase نيابةً عنك في الحالات التالية:

  • إنشاء مفتاح Gemini API تلقائيًا
  • طلب ربط تطبيقك بمشروع على Firebase
  • طلب المساعدة في ربط تطبيقك بخدمات Firebase، مثل Cloud Firestore أو Firebase Authentication
  • النقر على الزر نشر وإعداد Firebase App Hosting

عند استخدام المحادثة التفاعلية، Gemini يمكن استخدام أوامر الوحدة الطرفية أو خادم Firebase MCP للربط بمشروع على Firebase في الحالات التالية:

  • طلب ربط تطبيقك بمشروع على Firebase
  • طلب المساعدة في ربط تطبيقك بخدمات Firebase، مثل Cloud Firestore أو Firebase Authentication

الربط يدويًا بمشروع على Firebase

لربط تطبيقك في Firebase Studio يدويًا بمشروع على Firebase، اتّبِع الخطوات التالية:

  1. في وحدة تحكّم Firebase ، أنشئ مشروعًا جديدًا أو افتح مشروعًا حاليًا:

    • إنشاء مشروع جديد: انقر على إنشاء مشروع جديد على Firebase و اتّبِع التعليمات لإنشاء مشروع جديد.
    • فتح مشروع حالي: انقر على المشروع الذي تريد استخدامه.

  2. دوِّن رقم تعريف مشروعك. في وحدة تحكّم Firebase، انقر على > إعدادات المشروع. يظهر رقم تعريف المشروع في اللوحة العلوية.

  3. افتح تطبيقك في Firebase Studio. إذا كنت تستخدم App Prototyping agent في عرض Prototyper، انقر على رمز تبديل الرمز التبديل إلى "عرض التعليمات البرمجية" لفتح عرض Code.

  4. اربط مشروعك على Firebase. في الوحدة الطرفية (Shift+Ctrl+C)، شغِّل الأوامر التالية:

    1. touch firebase.json يضمن هذا الأمر توفُّر ملف إعداد Firebase في دليلك.
    2. firebase login --reauth اتّبِع التعليمات لتفويض حسابك.
    3. firebase use <your project ID> استبدِل <your-project-ID> برقم تعريف المشروع الذي دوّنته سابقًا.

تغيير مشروع Firebase المرتبط بتطبيقك

لتغيير مشروع Firebase المرتبط بمساحة عملك Firebase Studio ، اتّبِع التعليمات الواردة في الربط يدويًا بمشروع على Firebase باستخدام رقم تعريف المشروع الجديد.

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

للتأكّد مما إذا كان مشروع على Firebase مرتبطًا حاليًا، اطّلِع على أعلى Firebase Studio مساحة عملك. يظهر رقم تعريف المشروع المرتبط، إن وُجد، بجانب اسم مساحة عملك. يمكنك النقر على رقم تعريف المشروع لفتح هذا المشروع مباشرةً في وحدة تحكّم Firebase.

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