على الرغم من أنّه ليس عليك استخدام مشروع على 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 لتنفيذ مهام الإدارة والإعداد. ويشمل ذلك عرض قواعد الأمان وإدارة حسابات المستخدمين وعرض تقارير الأعطال التفصيلية وتعديل البيانات المخزّنة مباشرةً ومراجعة نتائج الاختبارات الثنائية.
ربط تطبيق 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، اتّبِع الخطوات التالية:
في وحدة تحكّم Firebase ، أنشئ مشروعًا جديدًا أو افتح مشروعًا حاليًا:
- إنشاء مشروع جديد: انقر على إنشاء مشروع جديد على Firebase و اتّبِع التعليمات لإنشاء مشروع جديد.
- فتح مشروع حالي: انقر على المشروع الذي تريد استخدامه.
دوِّن رقم تعريف مشروعك. في وحدة تحكّم Firebase، انقر على > إعدادات المشروع. يظهر رقم تعريف المشروع في اللوحة العلوية.
افتح تطبيقك في Firebase Studio. إذا كنت تستخدم App Prototyping agent في عرض Prototyper، انقر على
التبديل إلى "عرض التعليمات البرمجية" لفتح عرض Code.اربط مشروعك على Firebase. في الوحدة الطرفية (
Shift+Ctrl+C)، شغِّل الأوامر التالية:touch firebase.jsonيضمن هذا الأمر توفُّر ملف إعداد Firebase في دليلك.firebase login --reauthاتّبِع التعليمات لتفويض حسابك.firebase use <your project ID>استبدِل<your-project-ID>برقم تعريف المشروع الذي دوّنته سابقًا.
تغيير مشروع Firebase المرتبط بتطبيقك
لتغيير مشروع Firebase المرتبط بمساحة عملك Firebase Studio ، اتّبِع التعليمات الواردة في الربط يدويًا بمشروع على Firebase باستخدام رقم تعريف المشروع الجديد.
تحديد مشروع Firebase المرتبط بتطبيقك
للتأكّد مما إذا كان مشروع على Firebase مرتبطًا حاليًا، اطّلِع على أعلى Firebase Studio مساحة عملك. يظهر رقم تعريف المشروع المرتبط، إن وُجد، بجانب اسم مساحة عملك. يمكنك النقر على رقم تعريف المشروع لفتح هذا المشروع مباشرةً في وحدة تحكّم Firebase.