Вы можете установить (и управлять ) любым официальным расширением 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.
Установить несколько экземпляров расширения
Вы можете установить одно и то же расширение несколько раз в одном проекте. Каждый установленный экземпляр может иметь собственную настроенную конфигурацию и собственные ресурсы расширения. Для идентификации и обращения к каждому установленному экземпляру используется его идентификатор (ID) , уникальный для вашего проекта.
Вам будет предложено подтвердить или отредактировать идентификатор каждого дополнительного экземпляра расширения, который вы устанавливаете.
Следующие шаги
Просмотрите сведения и конфигурацию установленного расширения в консоли Firebase .
Контролируйте активность установленного расширения, включая проверки его работоспособности, использования и журналов.
Управляйте установленным расширением через консоль Firebase . Официальные расширения Firebase можно перенастроить, удалить, а также обновить до последней версии.
Рекомендуется для всех проектов настраивать оповещения о бюджете и отслеживать панель управления использованием и выставлением счетов в консоли Firebase .