الربط بمشروع 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

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

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

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

لربط تطبيق Firebase Studio يدويًا بمشروع Firebase:

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

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

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

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".

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

• التعرّف على مشاريع Firebase
• الدمج مع خدمات Google وFirebase
• مراقبة تطبيقات الويب وحمايتها