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

إذا كان لديك تطبيق حالي Next.js أو Angular (الإصدارات 13.5.x+ من Next.js أو 18.2.x+ من Angular) في مستودع GitHub، يمكن أن تكون عملية البدء باستخدام App Hosting بسيطة جدًا، إذ يمكنك إنشاء خلفية App Hosting ثم بدء طرحها من خلال إرسالها إلى فرعك المباشر. إذا لم يكن لديك تطبيق، استخدِم أحد تطبيقاتنا النموذجية لتنفيذ الخطوات الموضّحة في هذا الدليل.

قبل البدء

قبل إعداد Firebase App Hosting، عليك إنشاء مشروع على Firebase (إذا لم يكن لديك مشروع) والترقية إلى خطة Blaze.

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

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

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

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

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

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

  4. (اختياري) يمكنك إعداد Google Analytics لمشروعك، ما يتيح تجربة مثالية باستخدام منتجات Firebase التالية: Firebase A/B Testing وCloud Messaging وCrashlytics وIn-App Messaging وRemote Config (بما في ذلك التخصيص).

    اختَر حسابًا حاليًا Google Analytics أو أنشِئ حسابًا جديدًا. في حال إنشاء حساب جديد، اختَر Analytics الموقع الجغرافي لإعداد التقارير، ثم اقبل إعدادات مشاركة البيانات وبنود Google Analytics مشروعك.

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

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

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

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

npm init @apphosting

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

الخطوة 1: إنشاء App Hosting خلفية

App Hosting الخلفية هي مجموعة من الموارد المُدارة التي App Hosting يتم إنشاؤها لإنشاء تطبيق الويب وتشغيله.

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

واجهة سطر الأوامر: (الإصدار 13.15.4 أو إصدار أحدث) لإنشاء خلفية، شغِّل الأمر التالي من جذر دليل المشروع المحلي، مع توفير projectID كمعلَمة:

firebase apphosting:backends:create --project PROJECT_ID

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

  • اضبط دليل الجذر لتطبيقك (يكون / هو الإعداد التلقائي).

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

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

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

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

    تكون عمليات الطرح التلقائي مفعّلة تلقائيًا. بعد اكتمال عملية إنشاء الخلفية، يمكنك اختيار نشر تطبيقك على App Hosting على الفور.

  • امنح الخلفية اسمًا.

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

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

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

firebase apphosting:backends:get --project PROJECT_ID {BACKEND_ID}

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

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

  1. في GitHub، أرسِل تغييرًا إلى الفرع المباشر لتطبيق الويب.
  2. افتح علامة التبويب App Hosting في وحدة تحكّم Firebase، ثم انقر على عرض لوحة البيانات للخادم الخلفي. تعرض قائمة الجدول عملية الدمج المحدّدة المرتبطة بعملية الطرح التي تم تشغيلها بسبب التغيير الذي أجريته.

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