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

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

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

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

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

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

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

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

ربط تطبيق 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 CLI، يمكنك استخدام أوامر سطر الأوامر أو خادم Firebase MCP للاتصال بمشروع Firebase في الحالات التالية:Gemini

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

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

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

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

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

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

  3. افتح تطبيقك على Firebase Studio. إذا كنت تستخدم App Prototyping agent في Prototyper view, click Code switch icon Switch to Code to open Code view.

  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.

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