Расширения Firebase помогают сократить время, затрачиваемое на разработку, обслуживание и расширение вашего приложения.
Когда вы найдете расширение Firebase, которое удовлетворяет потребности вашего приложения или проекта, все, что вам нужно сделать, это установить и настроить расширение. Если вам нужно несколько конфигураций расширения, вы можете установить расширение несколько раз с разными конфигурациями для каждого устанавливаемого экземпляра.
С расширениями вы не тратите время на исследование, написание и отладку кода, реализующего функциональность или автоматизирующего задачу для вашего приложения или проекта.
Чтобы устанавливать расширения или управлять ими, вам должна быть назначена одна из следующих ролей: владелец, редактор или администратор Firebase .
Чтобы установить расширение, ваш проект должен быть включен в план Blaze (pay as you go). Хотя за установку расширения плата не взимается, с вас может взиматься плата за использование служб Firebase или облачных служб, таких как Cloud Secret Manager , если ваше использование превышает уровень бесплатного пользования службами.
Вы также можете оценить расширения перед их установкой в проекте с помощью эмулятора расширений, компонента Firebase Local Emulator Suite.
Официальные расширения Firebase
Официальные расширения Firebase разрабатываются и тестируются партнерскими службами Firebase и Firebase Extensions. Эти расширения надежны и безопасны.
Просмотрите официальные расширения Firebase
Просмотрите официальные расширения Firebase в Центре расширений .
Партнерские расширения раннего доступа
Партнерские расширения раннего доступа разрабатываются участниками программы раннего доступа издателей расширений. Они не создаются и не тестируются Google. Партнерские расширения с ранним доступом предоставляются «КАК ЕСТЬ» без каких-либо явных или подразумеваемых гарантий со стороны Google. Google отказывается от любой ответственности за любой ущерб, прямой или косвенный, в результате использования расширения.
Чтобы узнать больше о публикации собственного расширения, зарегистрируйтесь в программе раннего доступа издателей расширений .
Просмотр исходного кода расширения
Чтобы найти ссылку на исходный код одного из официальных расширений Firebase, нажмите «Подробнее» на карточке расширения в Центре расширений.
Чтобы найти ссылку на исходный код партнерского расширения с ранним доступом, запустите поток установки либо с помощью ссылки на установку консоли расширения, либо с помощью команды ext:install интерфейса командной строки. Ссылка на исходный код отображается вместе с другой информацией о расширении. Вы можете отменить установку, если хотите просто изучить исходный код.
Содержимое исходного кода расширения
Исходный каталог расширения включает:
файл extension.yaml — содержит метаданные расширения и определяет созданные ресурсы , API Google и роли доступа, необходимые для работы, а также любые настраиваемые пользователем параметры (переменные среды) для расширения.
каталог functions — Содержит файлы исходного кода для расширения
Файл README — содержит метаданные расширения (но в более удобочитаемом формате), а также содержимое файла PREINSTALL.
Файл PREINSTALL — описывает, как работает расширение, все необходимые задачи перед установкой, требования к конфигурации и сведения о расширении.
Файл POSTINSTALL — описывает конкретные инструкции по использованию и любые дополнительные требования к интеграции.
Ресурсы для расширения
Каждый проект Firebase содержит несколько типов «ресурсов». Ресурсы проекта могут включать такие вещи, как развернутые облачные функции, экземпляры базы данных, сегменты облачного хранилища, задания облачного планировщика и данные Cloud Secret Manager.
Когда вы устанавливаете расширение, Firebase создает в вашем проекте новые ресурсы , специфичные для экземпляра расширения . Эти ресурсы требуются расширению для работы.
Обратите внимание, что если вы удалите экземпляр расширения , все ресурсы, созданные Firebase специально для работы этого экземпляра расширения (например, набор функций), будут удалены. Однако не удаляются:
Любые артефакты, созданные расширением (например, сохраненные изображения).
Любые другие ресурсы в вашем проекте, такие как экземпляр базы данных или сегмент Cloud Storage. Даже если расширение взаимодействовало с этими другими ресурсами, они не зависят от расширения , поэтому они не удаляются при удалении расширения.
Использование консоли Firebase или интерфейса командной строки Firebase
Вы можете установить любое официальное расширение Firebase и управлять им с помощью консоли Firebase или интерфейса командной строки Firebase .
| Действие | Консоль Firebase | Интерфейс командной строки Firebase |
|---|---|---|
| Просмотр подробной информации (до установки) | ||
| Установить | ||
| Просмотр конфигурации (после установки) | ||
| Изменить конфигурацию | ||
| Обновить версию | ||
| Удалить |
Следующие шаги
Просмотрите подробную информацию о расширении перед его установкой ( Extensions Hub или Firebase CLI ).
Установите расширение в свой проект Firebase с помощью консоли Firebase или интерфейса командной строки Firebase .