Firebase App Hosting разработан специально для поддержки разработки современных веб-приложений, ориентированных на фреймворк. Используйте эту страницу как справочник по инструментам и фреймворкам, которые App Hosting поддерживает напрямую, а также как отправную точку для изучения связанных фреймворков и инструментов.
Веб-фреймворки и App Hosting
App Hosting предоставляет два широких уровня поддержки для современных веб-фреймворков: предварительно настроенная поддержка сборки и развертывания, а также поддержка на уровне сообщества посредством вкладов с открытым исходным кодом, соответствующих спецификации выходного пакета. В обоих случаях компонент адаптера фреймворка обеспечивает интеграцию определенного фреймворка с App Hosting .
Фреймворки с предварительно настроенной поддержкой сборки и развертывания
Благодаря предварительно настроенной поддержке сборки и развертывания Firebase определяет, какой фреймворк вы используете, проверяя файл package-lock.json или другой файл блокировки, и оптимизирует процессы сборки и развертывания для вашего приложения. Google стремится поддерживать эти фреймворки, а команда поддержки Firebase может принимать отчеты о проблемах и запросы на функции.
Этот уровень поддержки предоставляется:
- Следующий.js
- Угловой
Подробную информацию о конкретных версиях и уровнях поддержки см. в графиках поддержки .
Если вы попытаетесь развернуть приложение Node.js, в котором отсутствует файл блокировки, App Hosting не сможет собрать и запустить ваше приложение. Вы можете создать package-lock.json , запустив npm install в корневом каталоге.
Поддерживаемые сообществом фреймворки
В дополнение к Next.js и Angular, App Hosting также поддерживает любой веб-фреймворк, который может предоставить вывод сборки, соответствующий нашей спецификации выходного пакета . Авторы фреймворка могут воспользоваться спецификацией выходного пакета, чтобы гарантировать, что их фреймворк поддерживается App Hosting . Например, популярный фреймворк Nuxt поддерживается командой Nitro, которая создала адаптер Firebase для включения развертывания приложения Nuxt на App Hosting .
Если вы хотите увидеть дополнительные фреймворки, поддерживаемые App Hosting , вы можете создать адаптер фреймворка или обратиться к сопровождающим фреймворка, чтобы преобразовать выходные данные сборки в формат App Hosting . Адаптеры Next.js и Angular являются хорошими справочными примерами для тех, кто создает адаптер.
Информацию о поддерживаемых сообществом фреймворках можно найти на Firebase Open Source . Проблемы и запросы функций для поддерживаемых сообществом фреймворков следует направлять сообществу с открытым исходным кодом или авторам фреймворков. В некоторых случаях Google может помочь, но сообщество является первой линией поддержки для этих адаптеров.
Адаптеры фреймворка App Hosting
В App Hosting поддержка как предварительно настроенных, так и поддерживаемых сообществом фреймворков обеспечивается через адаптеры фреймворков . Адаптеры фреймворков App Hosting выполняют две ключевые роли:
- Они анализируют ваш исходный код и любые файлы конфигурации, специфичные для фреймворка (например,
next.config.js), и генерируют выходной пакет, который может быть обработан остальной инфраструктурой App Hosting . - Они запускают команду сборки вашего приложения, чтобы сгенерировать статические ресурсы и создать оптимизированную версию вашего приложения для производства.
Адаптеры фреймворка собирают ваше приложение Node.js с помощью npm run build , лучше всего работая со скриптами сборки по умолчанию для каждого фреймворка: next build для Next.js и ng build для Angular. App Hosting попытается выполнить сборки с помощью пользовательских команд сборки, но не может гарантировать надежный успех. Вы можете переопределить скрипты сборки и запуска в apphosting.yaml .
Исходный код адаптеров Next.js и Angular доступен в firebase-framework-tools .
Среды выполнения для App Hosting
После сборки и развертывания App Hosting ваше приложение Node.js запускается в версии 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.х | lts | 2026-10-9 |
| 14.2.х | lts | 2026-10-9 |
| 15.0.х | активный | не раньше 2025-10-9 |
| 15.1.х | активный | не раньше 2025-10-9 |
| 15.2.х | активный | - |
График угловой поддержки
| Версия | Статус | Устаревание |
|---|---|---|
| 18.2.х | lts | 2026-10-9 |
| 19.0.х | активный | не раньше 2025-10-9 |
| 19.1.х | активный | не раньше 2025-10-9 |
| 19.2.х | активный | - |
Менеджеры пакетов
App Hosting использует Cloud Native Buildpacks для выполнения установки зависимостей и сборки приложения с помощью npm, yarn или pnpm. Другие менеджеры пакетов, такие как JSR, не поддерживаются.
НПМ
- NPM — менеджер пакетов по умолчанию.
- Непроизводственные зависимости удаляются после успешной сборки.
- Раздел версии npm можно указать с помощью поля
engines.npmв файлеpackage.json.
пряжа
- Вместо этого используется Yarn, когда вы включаете файл
yarn.lockв свой проект. - Вы можете указать версию yarn, которую будете использовать, в поле
engines.yarnилиpackageManagerвашего файлаpackage.json. - App Hosting поддерживает режим Yarn2 PnP.
ПНПМ
- Вместо этого используется Pnpm, когда вы включаете файл
pnpm-lock.yamlв свой проект. - Вы можете указать версию pnpm в поле
engines.pnpmилиpackageManagerвашего файлаpackage.json. - Рабочий пример см. в приложении sample-node-pnpm .
Монорепозитории для App Hosting
App Hosting поддерживает приложения на базе Nx. Подробное руководство см. в разделе Использование монорепозиториев с App Hosting .
Поддерживаются следующие версии Nx:
| Версия | Статус | Устаревание |
|---|---|---|
| 19.5.х | обслуживание | 2025-10-9 |
| 19.6.х | обслуживание | 2025-10-9 |
| 19.7.х | обслуживание | 2025-10-9 |
| 19.8.х | lts | 2026-10-9 |
| 20.0.x | активный | не раньше 2025-10-9 |
| 20.1.х | активный | не раньше 2025-10-9 |
| 20.2.х | активный | не раньше 2025-10-9 |
| 20.3.х | активный | не раньше 2025-10-9 |
| 20.4.х | активный | не раньше 2025-10-9 |
| 20.5.x | активный | не раньше 2025-10-9 |
| 20.6.х | активный | не раньше 2025-10-9 |
| 20.7.х | активный | — |
Если вам нужна поддержка для других типов рабочих пространств monorepo, сообщите нам об этом на Firebase UserVoice .
,Firebase App Hosting разработан специально для поддержки разработки современных веб-приложений, ориентированных на фреймворк. Используйте эту страницу как справочник по инструментам и фреймворкам, которые App Hosting поддерживает напрямую, а также как отправную точку для изучения связанных фреймворков и инструментов.
Веб-фреймворки и App Hosting
App Hosting предоставляет два широких уровня поддержки для современных веб-фреймворков: предварительно настроенная поддержка сборки и развертывания, а также поддержка на уровне сообщества посредством вкладов с открытым исходным кодом, соответствующих спецификации выходного пакета. В обоих случаях компонент адаптера фреймворка обеспечивает интеграцию определенного фреймворка с App Hosting .
Фреймворки с предварительно настроенной поддержкой сборки и развертывания
Благодаря предварительно настроенной поддержке сборки и развертывания Firebase определяет, какой фреймворк вы используете, проверяя файл package-lock.json или другой файл блокировки, и оптимизирует процессы сборки и развертывания для вашего приложения. Google стремится поддерживать эти фреймворки, а команда поддержки Firebase может принимать отчеты о проблемах и запросы на функции.
Этот уровень поддержки предоставляется:
- Следующий.js
- Угловой
Подробную информацию о конкретных версиях и уровнях поддержки см. в графиках поддержки .
Если вы попытаетесь развернуть приложение Node.js, в котором отсутствует файл блокировки, App Hosting не сможет собрать и запустить ваше приложение. Вы можете создать package-lock.json , запустив npm install в корневом каталоге.
Поддерживаемые сообществом фреймворки
В дополнение к Next.js и Angular, App Hosting также поддерживает любой веб-фреймворк, который может предоставить вывод сборки, соответствующий нашей спецификации выходного пакета . Авторы фреймворка могут воспользоваться спецификацией выходного пакета, чтобы гарантировать, что их фреймворк поддерживается App Hosting . Например, популярный фреймворк Nuxt поддерживается командой Nitro, которая создала адаптер Firebase для включения развертывания приложения Nuxt на App Hosting .
Если вы хотите увидеть дополнительные фреймворки, поддерживаемые App Hosting , вы можете создать адаптер фреймворка или обратиться к сопровождающим фреймворка, чтобы преобразовать выходные данные сборки в формат App Hosting . Адаптеры Next.js и Angular являются хорошими справочными примерами для тех, кто создает адаптер.
Информацию о поддерживаемых сообществом фреймворках можно найти на Firebase Open Source . Проблемы и запросы функций для поддерживаемых сообществом фреймворков следует направлять сообществу с открытым исходным кодом или авторам фреймворков. В некоторых случаях Google может помочь, но сообщество является первой линией поддержки для этих адаптеров.
Адаптеры фреймворка App Hosting
В App Hosting поддержка как предварительно настроенных, так и поддерживаемых сообществом фреймворков обеспечивается через адаптеры фреймворков . Адаптеры фреймворков App Hosting выполняют две ключевые роли:
- Они анализируют ваш исходный код и любые файлы конфигурации, специфичные для фреймворка (например,
next.config.js), и генерируют выходной пакет, который может быть обработан остальной инфраструктурой App Hosting . - Они запускают команду сборки вашего приложения, чтобы сгенерировать статические ресурсы и создать оптимизированную версию вашего приложения для производства.
Адаптеры фреймворка собирают ваше приложение Node.js с помощью npm run build , лучше всего работая со скриптами сборки по умолчанию для каждого фреймворка: next build для Next.js и ng build для Angular. App Hosting попытается выполнить сборки с помощью пользовательских команд сборки, но не может гарантировать надежный успех. Вы можете переопределить скрипты сборки и запуска в apphosting.yaml .
Исходный код адаптеров Next.js и Angular доступен в firebase-framework-tools .
Среды выполнения для App Hosting
После сборки и развертывания App Hosting ваше приложение Node.js запускается в версии 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.х | lts | 2026-10-9 |
| 14.2.х | lts | 2026-10-9 |
| 15.0.х | активный | не раньше 2025-10-9 |
| 15.1.х | активный | не раньше 2025-10-9 |
| 15.2.х | активный | - |
График угловой поддержки
| Версия | Статус | Устаревание |
|---|---|---|
| 18.2.х | lts | 2026-10-9 |
| 19.0.х | активный | не раньше 2025-10-9 |
| 19.1.х | активный | не раньше 2025-10-9 |
| 19.2.х | активный | - |
Менеджеры пакетов
App Hosting использует Cloud Native Buildpacks для выполнения установки зависимостей и сборки приложения с помощью npm, yarn или pnpm. Другие менеджеры пакетов, такие как JSR, не поддерживаются.
НПМ
- NPM — менеджер пакетов по умолчанию.
- Непроизводственные зависимости удаляются после успешной сборки.
- Раздел версии npm можно указать с помощью поля
engines.npmв файлеpackage.json.
пряжа
- Вместо этого используется Yarn, когда вы включаете файл
yarn.lockв свой проект. - Вы можете указать версию yarn, которую будете использовать, в поле
engines.yarnилиpackageManagerвашего файлаpackage.json. - App Hosting поддерживает режим Yarn2 PnP.
ПНПМ
- Вместо этого используется Pnpm, когда вы включаете файл
pnpm-lock.yamlв свой проект. - Вы можете указать версию pnpm в поле
engines.pnpmилиpackageManagerвашего файлаpackage.json. - Рабочий пример см. в приложении sample-node-pnpm .
Монорепозитории для App Hosting
App Hosting поддерживает приложения на базе Nx. Подробное руководство см. в разделе Использование монорепозиториев с App Hosting .
Поддерживаются следующие версии Nx:
| Версия | Статус | Устаревание |
|---|---|---|
| 19.5.х | обслуживание | 2025-10-9 |
| 19.6.х | обслуживание | 2025-10-9 |
| 19.7.х | обслуживание | 2025-10-9 |
| 19.8.х | lts | 2026-10-9 |
| 20.0.x | активный | не раньше 2025-10-9 |
| 20.1.х | активный | не раньше 2025-10-9 |
| 20.2.х | активный | не раньше 2025-10-9 |
| 20.3.х | активный | не раньше 2025-10-9 |
| 20.4.х | активный | не раньше 2025-10-9 |
| 20.5.x | активный | не раньше 2025-10-9 |
| 20.6.х | активный | не раньше 2025-10-9 |
| 20.7.х | активный | — |
Если вам нужна поддержка для других типов рабочих пространств monorepo, сообщите нам об этом на Firebase UserVoice .