Zainstaluj rozszerzenie Firebase

Możesz zainstalować dowolne z oficjalnych rozszerzeń Firebase (i zarządzać nimi ) za pomocą konsoli Firebase lub interfejsu wiersza poleceń Firebase .

Sprawdź różnice w obsługiwanych akcjach dla Firebase CLI i Firebase Console.


Aby instalować rozszerzenia lub nimi zarządzać, musisz mieć przypisaną jedną z tych ról: Właściciel, Edytor lub Administrator Firebase .

Aby zainstalować rozszerzenie, Twój projekt musi być objęty planem Blaze (płatność na bieżąco). Chociaż za instalowanie rozszerzenia nie jest pobierana opłata, możesz zostać obciążony opłatą za korzystanie z usług Firebase lub usług w chmurze, takich jak [Cloud Secret Manager][secret-price], jeśli wykorzystanie przekracza poziom bezpłatnych usług.

Zanim zaczniesz

Jeśli jeszcze tego nie zrobiłeś, dodaj Firebase do swojego projektu i uaktualnij swój projekt Firebase do planu Blaze (płatność w miarę korzystania).

Krok 1 : Wyświetl szczegółowe informacje o rozszerzeniu

Ten krok jest opcjonalny, ale zdecydowanie zalecany.

Przed zainstalowaniem rozszerzenia Firebase zalecamy zapoznanie się ze szczegółowymi informacjami o rozszerzeniu, w tym:

  • Jak działa rozszerzenie, wszelkie zadania przedinstalacyjne i szczegóły dotyczące rozszerzenia
  • Ogólne informacje identyfikujące i opis
  • Czy zadania rozszerzenia wymagają konta rozliczeniowego
  • Usługi Google (API) i role dostępu wymagane do działania
  • Zasoby utworzone dla rozszerzenia (np. funkcje)
  • Opisy parametrów konfigurowalnych przez użytkownika

Aby wyświetlić szczegółowe informacje o rozszerzeniu:

  1. Przeglądaj oficjalne rozszerzenia Firebase z następujących źródeł:

  2. Kliknij kartę rozszerzenia, aby:

Krok 2 : Zainstaluj rozszerzenie

Podczas procesu instalacji zostaniesz poproszony o sprawdzenie podstawowych specyfikacji rozszerzenia (takich jak włączone interfejsy API, utworzone zasoby , przyznany dostęp itp.). Otrzymasz powiadomienie o wszelkich wymaganiach dotyczących płatności, a także zostaniesz poproszony o określenie wartości konfigurowalnych parametrów rozszerzenia.

  1. Przeglądaj oficjalne rozszerzenia Firebase z następujących źródeł:

  2. Kliknij kartę rozszerzenia, a następnie przejrzyj szczegółowe informacje o rozszerzeniu, które mogą zawierać szczegółowe instrukcje użytkowania i wszelkie zadania przedinstalacyjne.

  3. Kliknij Zainstaluj , a następnie postępuj zgodnie z instrukcjami wyświetlanymi na ekranie, aby zainstalować rozszerzenie.

Krok 3 : Zakończ konfigurację po instalacji

Niektóre rozszerzenia mają wymagane lub opcjonalne czynności, które należy wykonać przed ich użyciem. Instrukcje te można znaleźć na stronie szczegółów poinstalacyjnych rozszerzenia w panelu rozszerzeń konsoli Firebase (konkretny link do panelu jest wyświetlany w terminalu po instalacji).

Instrukcje te można również znaleźć w pliku POSTINSTALL.md znajdującym się w katalogu źródłowym rozszerzenia .

Utwórz zasoby Firebase

Jeśli skonfigurowałeś rozszerzenie do korzystania z zasobów Firebase (kolekcje Cloud Firestore, ścieżki Bazy danych czasu rzeczywistego, zasobniki Cloud Storage), które jeszcze nie istnieją, utwórz je przed użyciem rozszerzenia.

Utwórz obsługę zdarzeń Eventarc

Niektóre rozszerzenia publikują w Eventarc , gdy podczas wykonywania wydarzą się ważne zdarzenia. Jeśli rozszerzenie publikuje zdarzenia, a zdarzenia zostały włączone podczas instalacji, możesz napisać funkcje, które reagują na te zdarzenia za pomocą własnej niestandardowej logiki. Może to być przydatne na przykład do powiadamiania użytkowników o zakończeniu długotrwałych zadań lub do przetwarzania końcowego danych wyjściowych funkcji rozszerzenia.

Zapoznaj się z dokumentacją rozszerzenia, aby uzyskać listę zdarzeń (jeśli istnieją), które publikuje.

Następnie zobacz Niestandardowe wyzwalacze zdarzeń, aby uzyskać informacje na temat pisania programów obsługi zdarzeń Eventarc.

Zainstaluj wiele instancji rozszerzeń

Możesz zainstalować to samo rozszerzenie więcej niż raz w tym samym projekcie. Każde zainstalowane wystąpienie może mieć własną dostosowaną konfigurację i własne zasoby rozszerzeń. Identyfikujesz każdą zainstalowaną instancję i odwołujesz się do niej za pomocą jej identyfikatora , który jest unikalny w ramach Twojego projektu. Zostaniesz poproszony o potwierdzenie lub zmianę identyfikatora wystąpienia każdego dodatkowego wystąpienia instalowanego rozszerzenia.

Następne kroki