Обзор издателя расширений

Расширение Firebase выполняет определенную задачу или набор задач в ответ на HTTP-запросы или запускает события из других продуктов Firebase и Google, таких как Firebase Cloud Messaging, Cloud Firestore или Pub/Sub.

Вы можете создать собственное расширение для личного использования или поделиться им с миром в Firebase Extensions Hub. Например, ваше расширение может выполнять определенную задачу, которая регулярно требуется вашему приложению, или может упростить доступ к одному из API вашей компании. После создания расширения вы можете поделиться им с другими. Эти пользователи могут установить и настроить расширение для использования в своих собственных проектах Firebase.

Структура расширения

Расширение можно представить как состоящее из трех основных компонентов:

  • Код облачных функций на JavaScript или TypeScript
  • Метаданные, описывающие ваше расширение
  • Документация, которая поможет вашим пользователям настроить и использовать ваше расширение

Для разработки расширения вы собираете эти компоненты в следующую структуру:

example-extension
├── functions
│   ├── integration-tests
│   │   ├── extensions
│   │   │   └── example-extension.env
│   │   ├── firebase.json
│   │   └── integration-test.spec.js
│   ├── index.js
│   └── package.json
├── README.md
├── PREINSTALL.md
├── POSTINSTALL.md
├── CHANGELOG.md
├── icon.png
└── extension.yaml
  • Каталог functions содержит ваш код Cloud Functions на JavaScript или TypeScript. Это код, который выполняет задачи расширения в ответ на события, вызванные Firebase и службами Google.
  • Файл extension.yaml содержит метаданные о вашем расширении, такие как его триггеры и роли доступа IAM, а также любые параметры, которые вы хотите сделать настраиваемыми пользователем.
  • Файлы PREINSTALL , POSTINSTALL и CHANGELOG — это минимальная документация, которая должна быть у вашего расширения. Эти файлы помогают вашим пользователям узнать, что делает ваше расширение, как его использовать и какие обновления вы сделали. Вы также должны предоставить значок, чтобы помочь пользователям распознать ваше расширение. Консоль Firebase, Firebase CLI и Extensions Hub отображают содержимое этих файлов, когда пользователи изучают, устанавливают и управляют вашим расширением.

После создания расширения вы можете использовать Firebase CLI для его установки в проект или опубликовать его в Extensions Hub, где любой желающий сможет найти его и установить в свои проекты.

С какими продуктами может взаимодействовать мое расширение?

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

Поддерживаемые функции триггеров

Ручные триггеры

Прежде всего, вы можете вручную запустить функцию. Firebase Extensions и Cloud Functions поддерживают два способа ручного запуска функций:

  • HTTP-триггеры: развертывание функции в конечной точке HTTP
  • Вызываемые функции: вызывайте облачные функции непосредственно из кода iOS, Android или веб-клиента, используя клиентские SDK Firebase.

Открывая конечные точки HTTP из вашего расширения, ваше расширение может потенциально интегрироваться с любой веб-службой, поддерживающей веб-перехватчики. С вызываемыми функциями пользователи, устанавливающие ваше расширение, могут использовать Firebase SDK в качестве клиентской библиотеки для доступа к API, реализуемому вашим расширением.

Триггеры службы Firebase

Большинство продуктов Firebase генерируют события, которые могут активировать облачные функции расширения.

  • Аналитика: активация функций, когда Analytics регистрирует событие
  • App Distribution: активирует функции, когда App Distribution активирует оповещение
  • Аутентификация: активация функций, когда пользователи создают и удаляют учетные записи.
  • Cloud Firestore: активирует функции при создании, обновлении или удалении страниц
  • Облачное хранилище : активирует функции при загрузке, архивации или удалении объектов из контейнеров.
  • Crashlytics: активирует функции, когда Crashlytics активирует оповещение
  • Мониторинг производительности: активация функций, когда мониторинг производительности активирует оповещение
  • База данных в реальном времени: активирует функции при создании, обновлении или удалении данных.
  • Удаленная настройка: запуск функций при обновлении параметра
  • Test Lab: активирует функции, когда Test Lab активирует оповещение

Триггеры сервиса Google Cloud

Расширение также может включать функции, которые запускают несколько не-Firebase-сервисов Google Cloud:

  • Cloud Pub/Sub : расширение может включать функции, которые срабатывают при публикации событий в настраиваемой теме Pub/Sub.
  • Планировщик облака : расширение может включать функции, которые запускаются по заданному расписанию.
  • Cloud Tasks : расширение может включать функции, которые можно поставить в очередь с помощью Cloud Tasks. Firebase Extensions использует эту возможность, чтобы позволить вам, как автору расширения, писать функции, которые реагируют на события «жизненного цикла» расширения: первая установка в проекте, обновление до новой версии и перенастройка.
  • Eventarc : расширение может включать функции, которые запускаются при публикации событий в настраиваемом канале Eventarc; и наоборот, расширение может публиковать собственные события в канале Eventarc, чтобы пользователи могли определять собственные функции, которые запускаются при возникновении событий расширения .

Поддерживается функциями

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

  • Чтение, запись и иное взаимодействие с любой службой Firebase или Google Cloud , использующей поддерживаемую роль IAM .
  • Работайте с любым сторонним сервисом , предоставляющим веб-API.
  • Работайте со своими пользовательскими сервисами, если вы предоставляете веб-API.
  • Запускать большинство библиотек JavaScript, включая TensorFlow.js , Express.js и т. д.

Как построить расширение

Учебное пособие « Начало работы» проведет вас через процесс создания, тестирования и публикации полноценного расширения и является рекомендуемым способом научиться его создавать.

Начать

После того, как вы один раз ознакомитесь с руководством по началу работы, вы можете обратиться к отдельным тематическим руководствам, в которых объясняется каждая из задач, связанных с созданием вашего собственного расширения: