بدء استخدام "استضافة التطبيقات"

باستخدام تطبيق Next.js أو Angular حالي (إصدار Next.js بالإصدار 13 أو أحدث أو إصدار Angular 17.2 أو أحدث) في مستودع GitHub، يمكن أن يكون بدء استخدام "استضافة التطبيقات" مباشرًا مثل إنشاء واجهة خلفية لـ "استضافة التطبيقات" ثم بدء طرح المنتج بالضغط على الفرع المباشر لديك. إذا لم يكن لديك تطبيق، فاستخدم أحد نماذج التطبيقات التي نقدمها لتصفح الخطوات الموضحة في هذا الدليل.

قبل البدء

قبل أن تتمكّن من إعداد "استضافة التطبيقات في Firebase"، عليك إنشاء مشروع في Firebase (إذا لم يكن لديك مشروع) والترقية إلى خطة Blaze.

لإنشاء مشروع، اتّبِع الخطوات التالية:

  1. في وحدة تحكُّم Firebase، انقر على إضافة مشروع.

    • لإضافة موارد Firebase إلى مشروع حالي على Google Cloud، أدخِل اسم مشروعه أو اختَره من القائمة المنسدلة.

    • لإنشاء مشروع جديد، أدخِل اسم المشروع المطلوب. يمكنك أيضًا تعديل رقم تعريف المشروع المعروض أسفل اسم المشروع اختياريًا.

  2. راجِع بنود Firebase واقبلها إذا طُلب منك ذلك.

  3. انقر على متابعة.

  4. (اختياري) يمكنك إعداد "إحصاءات Google" لمشروعك، ما يتيح لك الحصول على تجربة مثالية باستخدام أي من منتجات Firebase التالية:

    اختَر حسابًا حاليًا على "إحصاءات Google" أو أنشئ حسابًا جديدًا.

    إذا أنشأت حسابًا جديدًا، اختَر موقع إعداد تقارير "إحصاءات Google"، ثم اقبل إعدادات مشاركة البيانات وبنود "إحصاءات Google" لمشروعك.

  5. انقر على إنشاء مشروع (أو إضافة Firebase إذا كنت تستخدم مشروعًا حاليًا على Google Cloud).

يوفّر Firebase تلقائيًا الموارد لمشروعك على Firebase. عند اكتمال العملية، سيتم نقلك إلى صفحة النظرة العامة لمشروع Firebase في "وحدة تحكُّم Firebase".

الخطوة 0 (اختيارية): إنشاء تطبيق ويب ومستودع GitHub

إذا لم يكن لديك تطبيق ويب في مستودع GitHub، أو إذا كنت تريد تجربة التدفق باستخدام نموذج تطبيق، ابدأ بتهيئة إحدى النماذج لدينا، إما لـ Next.js أو Angular:

npm init @apphosting

يمكنك تشغيل نموذج التطبيق محليًا باستخدام next dev أو ng start. للمتابعة، يمكنك إنشاء مستودع GitHub جديد وإرسال رمز النموذج الذي تم إعداده حديثًا إليه.

الخطوة 1: إنشاء واجهة خلفية لاستضافة التطبيقات

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

وحدة تحكُّم Firebase: من قائمة إنشاء، اختَر استضافة التطبيق ثم انقر على البدء.

CLI: (الإصدار 3.9 أو إصدار أحدث) لإنشاء واجهة خلفية، شغِّل الأمر التالي من جذر دليل المشروع المحلي، مع تقديم رقم تعريف المشروع كوسيطة (للمعاينة، يتم دعم منطقة us-central1 فقط):

firebase apphosting:backends:create --project PROJECT_ID --location us-central1

بالنسبة إلى كل من وحدة التحكم أو واجهة سطر الأوامر، اتّبِع التعليمات لتعيين اسم للواجهة الخلفية، لإعداد اتصال GitHub، وضبط إعدادات النشر الأساسية هذه:

  • ضبط الدليل الجذر لتطبيقك (القيمة التلقائية على /)

    وعادةً ما يكون هذا هو المكان الذي يتم وضع ملف package.json فيه.

  • ضبط الفرع المباشر

    وهذا هو فرع مستودع جيت هب الذي يتم نشره على عنوان URL المباشر. غالبًا ما يكون الفرع الذي يتم دمج فروع الخصائص أو فروع النمو فيه.

  • قبول عمليات الطرح التلقائي أو رفضها

    تكون عمليات الطرح التلقائية مفعَّلة تلقائيًا. عند الانتهاء من إنشاء الخلفية، يمكنك اختيار نشر تطبيقك على "استضافة التطبيقات" على الفور.

الخطوة 2: عرض التطبيق الذي تم نشره

عند إنشاء واجهة خلفية، يمنحك Firebase نطاقًا فرعيًا بدون تكلفة يمكن للمستخدمين النهائيين فيه زيارة تطبيق الويب الخاص بك. ويكون بالتنسيق backend-id--project-id.us-central1.hosted.app.

لعرض عنوان URL لتطبيق الويب، راجِع وحدة تحكُّم Firebase أو نفِّذ أمر CLI التالي:

firebase apphosting:backends:get --project PROJECT_ID {BACKEND_ID} --location us-central1

الخطوة 3: بدء عملية طرح من خلال إجراء تغيير

بمجرد إنشاء الخلفية والحصول على عنوان URL مباشر، يمكنك بدء طرح إصدار جديد من تطبيق الويب الخاص بك كلما قمت بدفع التغييرات إلى الفرع المباشر لمستودع جيت هب الخاص بك. لإجراء اختبار لإعداد "استضافة التطبيقات":

  1. في GitHub، ادفع التغيير إلى الفرع المباشر لتطبيق الويب.
  2. افتح علامة التبويب "استضافة التطبيق" في وحدة تحكم Firebase واختَر عرض لوحة البيانات للخلفية. تعرض قائمة الجدول مدة الالتزام المحددة المرتبطة بالطرح التي أدت إلى نتيجة التغيير الذي أجريته.

الخطوات اللاحقة