Check out what’s new from Firebase at Google I/O 2022. Learn more

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

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

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


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

Чтобы установить расширение, ваш проект должен быть включен в план Blaze (pay as you go). Хотя за установку расширения плата не взимается, с вас может взиматься плата за использование служб Firebase или облачных служб, таких как [Cloud Secret Manager][secret-pricing], если ваше использование превышает уровень бесплатного пользования службами.

Прежде чем вы начнете

  1. Если вы еще этого не сделали, добавьте Firebase в свой проект .

  2. Если вы еще этого не сделали, обновите свой проект до плана Blaze (pay as you go).

  3. Установите или обновите Firebase CLI до последней версии.

  4. Обратите внимание на идентификатор вашего проекта Firebase или ранее настроенный псевдоним проекта.

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

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

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

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

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

  1. Убедитесь, что вы настроили свою среду и выбрали расширение .

  2. Запустите команду extension-info из любого места на вашем компьютере:

    firebase ext:info publisher-id/extension-id

    Аргументы идентификатора publisher-id extension-id являются обязательными, и их можно найти на странице сведений о предварительной установке расширения .

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

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

  1. Убедитесь, что вы настроили свою среду и выбрали расширение .

  2. Запустите команду установки расширения. При появлении запроса введите значения параметров, чтобы настроить экземпляр расширения.

    firebase ext:install publisher-id/extension-id --project=projectId-or-alias

    Аргументы идентификатора publisher-id extension-id являются обязательными, и их можно найти на странице сведений о предварительной установке расширения .

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

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

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

Создать ресурсы Firebase

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

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

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

См. документацию расширения для списка событий (если таковые имеются), которые оно публикует.

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

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

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

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