מסגרות וכלים ל-App Hosting

Firebase App Hosting מיועד במיוחד לתמיכה בפיתוח של אפליקציות אינטרנט מודרניות שמבוססות על מסגרות. הדף הזה יכול לשמש כמקור מידע לגבי הכלים והמסגרות ש-App Hosting תומך בהם ישירות, וגם כנקודה ממנה אפשר להתחיל ללמוד על כלים ומסגרות קשורים.

מסגרות אינטרנט ו-App Hosting

App Hosting מספק שתי רמות תמיכה רחבות למסגרות אינטרנט מודרניות: תמיכה מוגדרת מראש לפיתוח ופריסה, ותמיכה ברמת הקהילה באמצעות תרומות בקוד פתוח שתואמות למפרט של חבילת הפלט. בשני המקרים, רכיב מתאם מסגרת מאפשר לשלב מסגרת ספציפית עם App Hosting.

Frameworks עם תמיכה מוגדרת מראש ב-build ובפריסה

כשמשתמשים בתמיכה מוגדרת מראש ל-build ולפריסה, מערכת Firebase מזהה את המסגרת שבה אתם משתמשים על ידי בדיקת הקובץ package-lock.json או קובץ נעילת אחר, ומבצעת אופטימיזציה של תהליכי ה-build והפריסה של האפליקציה. Google מחויבת לשמור על תמיכה במסגרות האלה, וצוות התמיכה של Firebase יכול לקבל דיווחים על בעיות ובקשות להוספת תכונות.

רמת התמיכה הזו ניתנת עבור:

  • Next.js
  • Angular

בלוחות הזמנים לתמיכה תוכלו לקרוא פרטים על גרסאות ספציפיות ועל רמות תמיכה ספציפיות.

אם תנסו לפרוס אפליקציית Node.js ללא קובץ נעילת (lock) App Hosting לא תצליח ליצור ולרוץ את האפליקציה. כדי ליצור את package-lock.json, מריצים את npm install בתיקיית השורש.

מסגרות שנתמכות על ידי הקהילה

בנוסף ל-Next.js ול-Angular, App Hosting תומך בכל מסגרת אינטרנט שיכולה לספק פלט build שתואם למפרט החבילה של הפלט. מחברי מסגרות יכולים להשתמש במפרט החבילה של הפלט כדי לוודא ש-App Hosting תומך במסגרת שלהם. לדוגמה, צוות Nitro תומך במסגרת Nuxt הפופולרית, ויצר מתאם Firebase כדי לאפשר פריסה של אפליקציות Nuxt ב-App Hosting.

אם אתם רוצים להוסיף frameworks שתומכים ב-App Hosting, תוכלו ליצור מתאם framework או לפנות למנהלי ה-framework כדי להמיר את הפלט של ה-build לפורמט App Hosting. מתאמי Next.js ו-Angular הם דוגמאות טובות לכל מי שיוצר מתאם.

מידע על מסגרות שתומכת בהן הקהילה זמין ב-Firebase Open Source. בעיות ובקשות לתכונות חדשות במסגרות שנתמכות על ידי קהילה צריכות להישלח לקהילת הקוד הפתוח או לכותבי המסגרות. במקרים מסוימים, Google עשויה לעזור, אבל הקהילה היא קו התמיכה הראשון למתאמים האלה.

App Hosting מתאמי מסגרת

ב-App Hosting, התמיכה במסגרות מוגדרות מראש ובמסגרות שנתמכות על ידי הקהילה ניתנת באמצעות מתאמי מסגרות. למתאמי המסגרת של App Hosting יש שני תפקידים מרכזיים:

  • הם מנתחים את קוד המקור ואת קובצי התצורה הספציפיים למסגרת (כמו next.config.js) ויוצרים חבילה של פלט שאפשר לעבד על ידי שאר התשתית של App Hosting.
  • הם מריצים את פקודת ה-build של האפליקציה כדי ליצור נכסים סטטיים וליצור גרסה אופטימיזציה של האפליקציה לסביבת הייצור.

מתאמי מסגרות מפתחים את אפליקציית Node.js באמצעות npm run build, והם פועלים בצורה הטובה ביותר עם סקריפטים ברירת המחדל ל-build לכל מסגרת: next build ל-Next.js ו-ng build ל-Angular. App Hosting ינסה לבצע גרסאות build באמצעות פקודות build בהתאמה אישית, אבל לא ניתן להבטיח שהן יפעלו. אפשר לשנות את הגדרות ה-build ולהריץ סקריפטים ב-apphosting.yaml.

המקור למתאמים של Next.js ו-Angular זמין ב-firebase-framework-tools.

סביבות זמן ריצה ל-App Hosting

אחרי שהאפליקציה ב-Node.js נוצרת ומשוחררת על ידי App Hosting, היא פועלת בגרסה Cloud Run. לכן, גרסת סביבת זמן הריצה של האפליקציה צריכה להיות בטווח הנתמך של Cloud Run ובטווח של מסגרת האינטרנט שבחרתם. בתמיכה המוגדרת מראש ב-Angular וב-Next.js, המשמעות היא שגרסאות Node.js הבאות נתמכות:

  • Next.js מגרסה 13.5.x ואילך
  • Angular מגרסה 18.2.x ואילך
  • Node.js מגרסה 18 ואילך

App Hosting לא מספק תמיכה פעילה באופן אוטומטי בגרסאות של המסגרת שפורסמו לאחרונה. גרסאות חדשות יותר מהגרסה הנוכחית שסומנה כ 'פעילה' ייחשבו כגרסאות 'בטא' עד שיסומנו באופן רשמי כ'פעילות' ב-App Hosting.

App Hosting תומך בתמיכה לטווח ארוך (LTS) לגרסה המשנית האחרונה של גרסה ראשית למשך שנה אחת מתקופת התמיכה הפעילה שלה, בתנאי שמתעדכנים באופן קבוע לגרסאות התיקון האחרונות בגרסה המשנית הזו. בטבלאות הבאות מפורטים פרטים לגבי Next.js ו-Angular.

לוח הזמנים של תמיכה ב-Next.js

גרסה סטטוס הפסקת תמיכה
13.5.x lts 2026-10-9
14.2.x lts 2026-10-9
15.0.x פעיל לא לפני 9 באוקטובר 2025
15.1.x פעיל לא לפני 9 באוקטובר 2025
15.2.x פעיל -

לוח הזמנים לתמיכה ב-Angular

גרסה סטטוס הפסקת תמיכה
‎18.2.x lts 2026-10-9
19.0.x פעיל לא לפני 9 באוקטובר 2025
19.1.x פעיל לא לפני 9 באוקטובר 2025
19.2.x פעיל -

מנהלי חבילות

App Hosting משתמש ב-Cloud Native Buildpacks כדי לבצע את התקנת יחסי התלות ולפתח את האפליקציה באמצעות npm,‏ yarn או pnpm. אין תמיכה במנהלי חבילות אחרים, כמו JSR.

NPM

  • ‏NPM הוא מנהל החבילות שמוגדר כברירת מחדל.
  • יחסי התלות שאינם בסביבת הייצור נחתכים אחרי שה-build מסתיים בהצלחה.
  • תוכלו לציין את הקטע של גרסת ה-NPM באמצעות השדה engines.npm בקובץ package.json.

כדור צמר

  • אם כוללים את הקובץ yarn.lock בפרויקט, משתמשים ב-Yarn במקום זאת.
  • תוכלו לציין את גרסת ה-Yarn שבה צריך להשתמש בשדה engines.yarn או packageManager בקובץ package.json.
  • ב-App Hosting יש תמיכה במצב Yarn2 PnP.

Pnpm

  • אם כוללים את הקובץ pnpm-lock.yaml בפרויקט, משתמשים ב-Pnpm במקום זאת.
  • תוכלו לציין את גרסת ה-Pnpm שבה צריך להשתמש בשדה engines.pnpm או packageManager בקובץ package.json.
  • תוכלו לראות דוגמה שעובדת באפליקציה sample-node-pnpm. אפליקציה.

מונוריפו ל-App Hosting

App Hosting תומך באפליקציות מבוססות Nx. הוראות מפורטות מפורטות במאמר שימוש במאגרים מונוליתיים עם App Hosting.

יש תמיכה בגרסאות Nx הבאות:

גרסה סטטוס הפסקת תמיכה
19.5.x תחזוקה 2025-10-9
19.6.x תחזוקה 2025-10-9
19.7.x תחזוקה 2025-10-9
19.8.x lts 2026-10-9
‎20.0.x פעיל לא לפני 9 באוקטובר 2025
20.1.x פעיל לא לפני 9 באוקטובר 2025
20.2.x פעיל לא לפני 9 באוקטובר 2025
20.3.x פעיל לא לפני 9 באוקטובר 2025
20.4.x פעיל לא לפני 9 באוקטובר 2025
20.5.x פעיל לא לפני 9 באוקטובר 2025
20.6.x פעיל לא לפני 9 באוקטובר 2025
20.7.x פעיל

אם אתם זקוקים לתמיכה בסוגים אחרים של סביבות עבודה של מקור יחיד, תוכלו לעדכן אותנו ב-UserVoice של Firebase.