Установите расширение Firebase

Вы можете установить (и управлять ) любым официальным расширением Firebase используя либо консоль Firebase , либо Firebase CLI (интерфейс командной строки).

Обязательно ознакомьтесь с различиями в поддерживаемых действиях для интерфейса командной строки Firebase и консоли Firebase .



Чтобы устанавливать расширения или управлять ими, вам должна быть назначена одна из этих ролей: владелец, редактор или администратор Firebase .

Чтобы установить расширение, ваш проект должен находиться в плане Blaze (оплата по мере использования). Хотя за установку расширения плата не взимается, с вас может взиматься плата за использование служб Firebase или облачных служб, таких как Cloud Secret Manager , если ваше использование превышает уровень бесплатного пользования службами.

Прежде чем начать

Если вы еще этого не сделали, добавьте Firebase в свой проект и обновите свой проект Firebase до плана Blaze (оплата по мере использования).

Шаг 1. Просмотрите подробную информацию о расширении.

Этот шаг не является обязательным, но настоятельно рекомендуется.

Перед установкой Firebase Extension мы рекомендуем вам просмотреть подробную информацию о расширении, включая:

  • Как работает расширение, какие задачи перед установкой и подробности о расширении
  • Общая идентификационная информация и описание
  • Требуется ли для задач расширения учетная запись для выставления счетов
  • Сервисы Google (API) и роли доступа , необходимые для работы
  • Ресурсы , созданные для расширения (например, функции).
  • Описания настраиваемых пользователем параметров

Чтобы просмотреть подробную информацию о расширении:

  1. Просмотрите официальные расширения Firebase в Extensions Hub .

  2. Нажмите на карточку расширения, чтобы:

Шаг 2. Установите расширение.

В процессе установки вам будет предложено просмотреть основные характеристики расширения (например, включенные API, созданные ресурсы , предоставленный доступ и т. д.). Вы будете уведомлены о любых требованиях к выставлению счетов, а также вам будет предложено указать значения настраиваемых параметров расширения.

  1. Просмотрите официальные расширения Firebase в Extensions Hub .

  2. Нажмите карточку расширения, затем просмотрите подробную информацию о расширении, которая может содержать конкретные инструкции по использованию и любые задачи перед установкой.

  3. Нажмите «Установить» и следуйте инструкциям на экране, чтобы установить расширение.

Шаг 3. Завершите настройку после установки.

Некоторые расширения содержат обязательные или дополнительные действия, которые необходимо выполнить перед их использованием. Эти инструкции можно найти на странице сведений о вашем расширении после установки на панели Extensions консоли Firebase (конкретная ссылка на панель мониторинга отображается в терминале после установки).

Вы также можете найти эти инструкции в файле POSTINSTALL.md , включенном в исходный каталог расширения .

Создание ресурсов Firebase

Если вы настроили расширение для использования ресурсов Firebase (коллекций Cloud Firestore , путей Realtime Database , сегментов Cloud Storage ), которые еще не существуют, создайте их перед использованием расширения.

Создание обработчиков событий Eventarc

Некоторые расширения публикуют информацию в Eventarc , когда во время выполнения происходят важные события. Если расширение публикует события и вы включили события во время установки, вы можете написать функции, реагирующие на эти события, с помощью собственной логики. Это может быть полезно, например, для уведомления пользователей о завершении длительных задач или для последующей обработки вывода функции расширения.

Список событий (если таковые имеются), которые оно публикует, см. в документации расширения. Например, см. типы событий для расширения «Выполнение платежей с помощью Stripe» .

Затем см. раздел Пользовательские триггеры событий для получения информации о написании обработчиков событий Eventarc.

Установите несколько экземпляров расширения

Вы можете установить одно и то же расширение несколько раз в одном проекте. Каждый установленный экземпляр может иметь собственную настроенную конфигурацию и собственные ресурсы расширения. Вы идентифицируете каждый установленный экземпляр и ссылаетесь на него, используя его идентификатор экземпляра , который уникален в рамках вашего проекта. Вам будет предложено подтвердить или изменить идентификатор экземпляра каждого дополнительного экземпляра устанавливаемого вами расширения.

Следующие шаги