Вы можете установить (и управлять ) любым официальным расширением Firebase , используя консоль Firebase , Firebase CLI (интерфейс командной строки) или используя автоматически сгенерированный SDK.
Обязательно ознакомьтесь с различиями в поддерживаемых действиях для каждого метода установки.
Для установки или управления расширениями вам должна быть назначена одна из следующих ролей: Владелец, Редактор или Администратор Firebase .
Для установки расширения ваш проект должен быть на плане Blaze (оплата по мере использования). Хотя плата за установку расширения не взимается, с вас может взиматься плата за использование служб Firebase или облачных служб, таких как Cloud Secret Manager , если ваше использование превышает бесплатный уровень служб.
Прежде чем начать
Если вы еще этого не сделали, добавьте Firebase в свой проект и обновите свой проект Firebase до плана Blaze (оплата по мере использования).
Шаг 1 : Просмотр подробной информации о расширении
Этот шаг необязателен, но настоятельно рекомендуется.
Перед установкой Firebase Extension мы рекомендуем вам ознакомиться с подробной информацией о расширении, включая:
- Как работает расширение, какие задачи необходимо выполнить перед установкой и подробности о расширении
- Общая идентификационная информация и описание
- Требуют ли задачи расширения наличия платежного аккаунта
- Службы Google (API) и роли доступа , необходимые для работы
- Ресурсы, созданные для расширения (например, функции)
- Описания настраиваемых пользователем параметров
Чтобы просмотреть подробную информацию о расширении:
Просмотрите официальные расширения Firebase в Extensions Hub .
Нажмите на карточку расширения, чтобы:
Отобразить подробную информацию о расширении.
Ссылку на исходный код расширения можно найти в репозитории исходного кода Firebase Extensions .
Подробную информацию можно просмотреть в
READMEв каталоге расширений расширения.
Шаг 2 : Установите расширение
В процессе установки вам будет предложено просмотреть основные характеристики расширения (такие как включенные API, созданные ресурсы , предоставленный доступ и т. д.). Вам сообщат о любых требованиях к выставлению счетов, а также вам будет предложено указать значения для настраиваемых параметров расширения.
Просмотрите официальные расширения Firebase в Extensions Hub .
Нажмите на карточку расширения, затем просмотрите подробную информацию о расширении, которая может содержать конкретные инструкции по использованию и любые предустановочные задачи.
Нажмите «Установить» , затем следуйте инструкциям на экране, чтобы установить расширение.
Шаг 3 : Завершите настройку после установки
Некоторые расширения имеют обязательные или необязательные шаги, которые вам необходимо выполнить перед их использованием. Найдите эти инструкции на странице сведений о вашем расширении после установки в панели управления Extensions консоли Firebase (конкретная ссылка на панель управления отображается в терминале после установки).
Эти инструкции вы также можете найти в файле POSTINSTALL.md , включенном в исходный каталог расширения .
Создать ресурсы Firebase
Если вы настроили расширение для использования ресурсов Firebase (коллекции Cloud Firestore , пути Realtime Database , контейнеры Cloud Storage ), которые еще не существуют, создайте их перед использованием расширения.
Создание обработчиков событий Eventarc
Некоторые расширения публикуются в Eventarc , когда во время выполнения происходят важные события. Если расширение публикует события, и вы включили события во время установки, вы можете написать функции, которые реагируют на эти события с помощью вашей собственной пользовательской логики. Это может быть полезно, например, для уведомления пользователей о завершении длительных задач или для постобработки выходных данных функции расширения.
Список событий (если таковые имеются) см. в документации расширения. Например, см. типы событий для расширения Run Payments with Stripe .
Затем ознакомьтесь с разделом Пользовательские триггеры событий для получения информации о написании обработчиков событий Eventarc.
Установить несколько экземпляров расширения
Вы можете установить одно и то же расширение несколько раз в одном проекте. Каждый установленный экземпляр может иметь собственную настроенную конфигурацию и собственные ресурсы расширения. Вы идентифицируете и ссылаетесь на каждый установленный экземпляр, используя его идентификатор экземпляра , который является уникальным в пределах вашего проекта.
Вам будет предложено подтвердить или изменить идентификатор экземпляра каждого дополнительного экземпляра расширения, который вы устанавливаете.
Следующие шаги
Просмотрите сведения и конфигурацию установленного расширения в консоли Firebase .
Отслеживайте активность установленного расширения, включая проверки его работоспособности, использования и журналов.
Используя консоль Firebase , управляйте установленным расширением. Для официальных расширений Firebase вы можете перенастроить или удалить расширение, а также обновить расширение до последней версии.
В качестве наилучшей практики для всех проектов обязательно настройте оповещения о бюджете для вашего проекта и следите за панелью управления использованием и выставлением счетов в консоли Firebase .