Firebase App Hosting разработан специально для поддержки разработки современных веб-приложений на основе фреймворков. Используйте эту страницу как справочник по инструментам и фреймворкам, которые App Hosting поддерживает напрямую, а также как отправную точку для изучения связанных фреймворков и инструментов.
Веб-фреймворки и App Hosting
App Hosting предоставляет два основных уровня поддержки современных веб-фреймворков: преднастроенную поддержку сборки и развёртывания, а также поддержку на уровне сообщества посредством открытого исходного кода, соответствующего спецификации выходного пакета. В обоих случаях компонент- адаптер фреймворка обеспечивает интеграцию конкретного фреймворка с App Hosting .
Фреймворки с преднастроенной поддержкой сборки и развертывания
Благодаря преднастроенной поддержке сборки и развёртывания Firebase определяет используемый вами фреймворк, проверяя файл package-lock.json или другой файл блокировки, и оптимизирует процессы сборки и развёртывания вашего приложения. Google стремится поддерживать эти фреймворки, а служба поддержки Firebase принимает сообщения о проблемах и запросы на новые функции.
Этот уровень поддержки предоставляется:
- Next.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.x | лтс | 2026-10-9 |
| 14.2.x | лтс | 2026-10-9 |
| 15.0.x | активный | не раньше 9 октября 2025 г. |
| 15.1.x | активный | не раньше 9 октября 2025 г. |
| 15.2.x | активный | - |
График поддержки Angular
| Версия | Статус | Устаревание |
|---|---|---|
| 18.2.x | лтс | 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 можно указать с помощью поля
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 .
Монорепозитории для 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 | лтс | 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 | активный | — |
Если вам нужна поддержка других типов рабочих пространств monorepo, сообщите нам об этом на Firebase UserVoice .