نشر تطبيقك باستخدام Firebase Studio

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

  • Firebase App Hosting: تُعدّ هذه الخدمة مثالية لنشر تطبيقات Next.js وAngular الديناميكية، App Hosting وتوفّر دعمًا مدمجًا للإطار، وعملية تكامل مع GitHub، وعملية تكامل مع منتجات Firebase الأخرى، مثل Firebase Authentication وCloud Firestore و Firebase AI Logic.

    إذا طوّرت تطبيق Next.js باستخدام أداة App Prototyping agent، يمكنك نشره مباشرةً من Firebase Studio ببضع نقرات فقط.

  • Firebase Hosting: تُعدّ هذه الخدمة مناسبة لاستضافة تطبيقات الويب والمحتوى الثابت على الويب (مثل HTML وCSS وJavaScript والصور والأصول الثابتة الأخرى) والتطبيقات المكوّنة من صفحة واحدة. Firebase Hosting توفّر إمكانية تسليم المحتوى بسرعة من خلال شبكة CDN عالمية وشهادات SSL مجانية و دعم النطاقات المخصّصة.

    إذا طوّرت تطبيق ويب ثابتًا أو تطبيق ويب مكوّنًا من صفحة واحدة في Firebase Studio, يمكنك نشره مباشرةً من Firebase Studio من خلال مطالبة Gemini بنشر تطبيقك.

  • Cloud Run: استخدِم Cloud Run لنشر التطبيقات المستندة إلى حاويات. يُعدّ هذا الخيار مناسبًا لنشر التطبيقات القابلة للنقل والقابلة للتوسّع التي يمكن تشغيلها على أي منصة.

  • خيارات النشر الأخرى: يمكنك النشر على حل الاستضافة الذي تختاره، بما في ذلك المنصات الأخرى أو الخادم الخاص بك.

نشر تطبيقك ومراقبته باستخدام Firebase App Hosting

بعد اختبار تطبيقك والتأكّد من أنّه يلبي احتياجاتك في مساحة العمل، يمكنك نشره على الويب باستخدام Firebase App Hosting.

عند إعداد App Hosting، ينشئ Firebase Studio مشروعًا على Firebase لك (إذا لم يتم إنشاء مشروع من قبل من خلال الإنشاء التلقائي لمفتاح Gemini API أو خدمات أخرى للواجهة الخلفية) ويرشدك خلال عملية ربط حساب Cloud Billing.

لنشر تطبيقك:

  1. انقر على نشر لإعداد مشروعك على Firebase ونشر تطبيقك. تظهر اللوحة نشر تطبيقك.

  2. في خطوة مشروع Firebase ، تعرض App Prototyping agent مشروع Firebase المرتبط بمساحة العمل. إذا لم يكن هناك مشروع حالي على Firebase ، تنشئ App Prototyping agent مشروعًا جديدًا لك. انقر على التالي للمتابعة.

  3. في خطوة ربط Cloud Billing حساب ، اختَر أحد الخيارَين التاليَين:

    • اختَر الحساب Cloud Billing الذي تريد ربطه بمشروعك على Firebase.

    • إذا لم يكن لديك حساب Cloud Billing أو أردت إنشاء حساب جديد، انقر على إنشاء حساب Cloud Billing. يؤدي ذلك إلى فتح الـ Google Cloud console، حيث يمكنك إنشاء حساب جديد للخدمة الذاتية Cloud Billing account. بعد إنشاء الحساب، ارجع إلى Firebase Studio واختَر الحساب من قائمة ربط Cloud Billing.

  4. انقر على التالي. Firebase Studio يربط حساب الفوترة بالمشروع المرتبط بمساحة العمل، والذي تم إنشاؤه إما عند الإنشاء التلقائي لمفتاح Gemini API أو عند النقر على نشر.

  5. انقر على إعداد الخدمات. تبدأ App Prototyping agent في توفير خدمات Firebase.

  6. انقر على النشر الآن. Firebase Studio يُعدّ خدمات Firebase ثم يبدأ طرح خدمة App Hosting قد يستغرق ذلك عدة دقائق حتى يكتمل. لمزيد من المعلومات حول ما يحدث وراء الكواليس، يُرجى الاطّلاع على مقالة عملية التصميم App Hosting.

  7. عند اكتمال خطوة النشر، تظهر نظرة عامة على التطبيق مع عنوان URL والإحصاءات المستندة إلى App Hosting إمكانية المراقبة. لاستخدام نطاق مخصّص (مثل example.com أو app.example.com) بدلاً من النطاق الذي أنشأته Firebase، يمكنك إضافة نطاق مخصّص في وحدة تحكّم Firebase

لمزيد من المعلومات عن App Hosting، يُرجى الاطّلاع على المقالة فهم App Hosting وكيفية عملها.

(Cloud Firestore فقط) إضافة الفهارس والتحقّق من قواعد الأمان في مرحلة الإنتاج

عند اكتمال عملية النشر ونشر تطبيقك على Firebase، يصبح Cloud Firestore وFirebase Authentication جاهزَين للاختبار في مرحلة الإنتاج.

إنشاء فهارس لقاعدة بياناتك Cloud Firestore

عند نشر تطبيقك على Cloud Firestore، لا يتم إنشاء الفهارس تلقائيًا. يعني ذلك أنّه بعد النشر، قد تحتاج إلى إنشاء فهارس لطلبات البحث.

قد يظهر ذلك في رسائل الخطأ أو في "وحدة تحكّم المطوّرين" في المتصفّح.

لإنشاء الفهارس بعد النشر:

  1. من تطبيق منشور: في اللوحة نظرة عامة على التطبيق (انقر على نشر إذا لم تكن ظاهرة)، ابحث عن الرابط زيارة تطبيقك وانقر عليه.

    من معاينة Firebase Studio:افتح "وحدة تحكّم المطوّرين" في المتصفّح وابحث عن رسالة الخطأ 200 التي ينشئها Cloud Firestore.

  2. اختبِر جميع مسارات المستخدمين داخل تطبيقك. قد يظهر خطأ يشبه "Error loading recipes. The query requires an index. You can إنشاؤه هنا:" مع رابط يؤدي إلى وحدة تحكّم Firebase.

  3. انقر على الرابط للانتقال إلى وحدة تحكّم Firebase، وسيظهر فهرس مقترَح.

  4. انقر على حفظ لقبول الفهرس المقترَح.

  5. ارجع إلى تطبيقك وأعِد تحميل الصفحة.

  6. واصِل اختبار جميع مسارات المستخدمين في تطبيقك لإضافة الفهارس عند الضرورة.

مزيد من المعلومات في المقالة إدارة الفهارس في Cloud Firestore.

عرض بيانات Cloud Firestore وFirebase Authentication في وحدة تحكّم Firebase

يمكنك عرض البيانات المباشرة من تطبيقك في وحدة تحكّم Firebase بعد النشر.

  • لعرض قاعدة بيانات Cloud Firestore المباشرة، افتح Firebase وحدة التحكّم واختر إنشاء > قاعدة بيانات Firestore من قائمة التنقّل.

    من هنا، يمكنك فحص البيانات المخزّنة وعرض قواعد الأمان واختبارها وإنشاء الفهارس. مزيد من المعلومات في المقالة Cloud Firestore.

  • لعرض بيانات Firebase Authentication المباشرة، افتح Firebase وحدة التحكّم واختَر إنشاء > المصادقة من قائمة التنقّل.

    من هنا، يمكنك فحص إعدادات المصادقة ومستخدمي التطبيق. مزيد من المعلومات في المقالة "Firebase Authentication".

اختبار قواعد Cloud Firestore في مرحلة الإنتاج

بعد نشر تطبيقك، عليك اختبار قواعد الأمان في Cloud Firestore مرة أخرى ، وذلك في بيئة التشغيل الفعلي. يساعد ذلك في ضمان إمكانية وصول المستخدمين المصرّح لهم إلى بياناتك وحمايتها من الوصول غير المصرّح به.

يمكنك اختبار قواعدك باستخدام كل الطرق التالية:

  • اختبار التطبيق: تفاعَل مع تطبيقك الذي تم نشره، ونفِّذ عمليات تؤدي إلى ظهور أنماط مختلفة للوصول إلى البيانات (القراءة، والكتابة، والحذف) لأدوار المستخدمين أو حالاتهم المختلفة. يساعد هذا الاختبار في العالم الحقيقي في التأكّد من تطبيق قواعدك بشكل صحيح في الممارسة العملية.

  • Rules Playground: لإجراء عمليات تحقّق مستهدَفة، استخدِم Rules Playground في وحدة تحكّم Firebase. تتيح لك هذه الأداة محاكاة الطلبات (القراءة والكتابة والحذف) على قاعدة بيانات Cloud Firestoreباستخدام قواعد الإنتاج. يمكنك تحديد حالة مصادقة المستخدم والمسار إلى البيانات ونوع العملية لمعرفة ما إذا كانت قواعدك تسمح بالوصول أو ترفضه على النحو المطلوب.

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

مراقبة تطبيقك باستخدام إمكانية تتبّع البيانات App Hosting

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

  • انقر على نشر لإصدار نسخة جديدة من تطبيقك.
  • يمكنك مشاركة رابط تطبيقك أو فتحه مباشرةً في زيارة تطبيقك.
  • يمكنك مراجعة ملخّص لأداء تطبيقك خلال آخر 7 أيام، بما في ذلك إجمالي عدد الطلبات وحالة آخر عملية طرح. انقر على عرض التفاصيل للوصول إلى مزيد من المعلومات في Firebase وحدة التحكّم.
  • يمكنك عرض رسم بياني لعدد الطلبات التي تلقّاها تطبيقك خلال آخر 24 ساعة، مقسّمة حسب رمز حالة HTTP.
  • يمكنك عرض حالة تفعيل خدمات Firebase، مثل Firebase Authentication و Cloud Firestore.

إذا أغلقت اللوحة "نظرة عامة على التطبيق"، يمكنك إعادة فتحها في أي وقت من خلال النقر على نشر.

مزيد من المعلومات عن إدارة عمليات طرح App Hosting ومراقبتها في المقالة إدارة عمليات الطرح والإصدارات.

الرجوع إلى الإصدار السابق من موقعك الإلكتروني على App Hosting

إذا نشرت إصدارات متتالية من تطبيقك على App Hosting، يمكنك الرجوع إلى أحد الإصدارات السابقة. ويمكنك أيضًا إزالتها.

  • للرجوع إلى الإصدار السابق من موقع إلكتروني منشور:

    1. افتح App Hosting في وحدة تحكّم Firebase.

    2. ابحث عن الواجهة الخلفية لتطبيقك، وانقر على عرض، ثم على عمليات الطرح.

    3. بجانب عملية النشر التي تريد الرجوع إليها، انقر على المزيد ، ثم اختَر الرجوع إلى هذا الإصدار، وأكِّد ذلك.

    مزيد من المعلومات في المقالة إدارة عمليات الطرح والإصدارات.

  • لإزالة نطاق App Hosting من الويب:

    1. من Firebase وحدة التحكّم، افتح App Hosting، وانقر على عرض في قسم تطبيق Firebase Studio.

    2. في قسم معلومات الواجهة الخلفية ، انقر على إدارة. يتم تحميل صفحة النطاقات.

    3. بجانب نطاقك، انقر على المزيد ، ثم اختَر إيقاف النطاق، وأكِّد ذلك.

    تؤدي هذه الخطوة إلى إزالة نطاقك من الويب. لإزالة الواجهة الخلفية لخدمة App Hosting بالكامل، اتّبِع التعليمات الواردة في المقالة حذف واجهة خلفية.

Firebase Hosting

يمكنك نشر تطبيقات الويب الثابتة والتطبيقات المكوّنة من صفحة واحدة على Firebase Hosting من مساحة عملك Firebase Studio.

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

النشر بمساعدة Gemini

  1. في المحادثة مع Gemini، أدخِل طلبًا مثل "نشر تطبيقي."

  2. يرشدك Gemini خلال الخطوات اللازمة. قد يشمل ذلك إنشاء مشروع Firebase وتسجيل تطبيقك إذا لم يسبق لك إجراء ذلك.

النشر من لوح Firebase Studio

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

  1. إذا لم يسبق لك إجراء ذلك، أنشئ مشروعًا على Firebase وسجِّل تطبيقك.

  2. افتح مساحة عملك Firebase Studio.

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

  3. في جزء التنقّل، انقر على رمز Firebase Studio لفتح اللوحة، ثم وسِّع قسم Firebase Hosting.

  4. انقر على المصادقة على Firebase واتّبِع التعليمات في نافذة "وحدة التحكّم" لمصادقة حسابك على Firebase.

  5. انقر على تهيئة Firebase Hosting واتّبِع التعليمات في نافذة "وحدة التحكّم" لإعداد إعدادات النشر.

  6. لنشر تطبيقك، انقر على النشر في مرحلة الإنتاج أو النشر في القناة من قسم Firebase Hosting في Firebase Studio لوحة.

Cloud Run

قبل النشر باستخدام Cloud Run، تأكَّد من إعداد Google Cloud مشروع وتفعيل Cloud Billing.

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

  2. انقر على رمز Firebase Studio في جزء التنقّل لفتح لوحة Firebase Studio، ثم انقر على النشر على Cloud Run.

  3. انقر على السماح لمساحة العمل هذه بالوصول إلى موارد Google Cloud باستخدام حساب Google ، ثم اختَر مشروعًا على Google Cloud تم تفعيل الفوترة فيه من نوافذ مربّع الحوار.

  4. انقر على المصادقة من قسم Cloud Run في لوحة Firebase Studio واتّبِع التعليمات للمصادقة.

  5. انقر على نشر واتّبِع التعليمات لإعداد إعدادات النشر ونشر تطبيقك.

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