Zainstaluj rozszerzenie Firebase

Możesz instalować (i zarządzać) dowolnymi oficjalnymi rozszerzeniami Firebase za pomocą konsoli Firebase, wiersza poleceń Firebase (interfejsu wiersza poleceń) lub automatycznie wygenerowanego pakietu SDK.

Sprawdź różnice w obsługiwanych działaniach w przypadku każdej metody instalacji.



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

Aby zainstalować rozszerzenie, projekt musi być objęty abonamentem Blaze (płatność według zużycia). Chociaż zainstalowanie rozszerzenia jest bezpłatne, możesz zostać obciążony opłatami za korzystanie z usług Firebase lub usług w chmurze, takich jak Cloud Secret Manager, jeśli przekroczysz bezpłatny poziom tych usług.

Zanim zaczniesz

Dodaj Firebase do swojego projektu, a następnie przejdź na abonament Blaze (płatność według wykorzystania) – chyba że masz to już za sobą.

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

Ten krok jest opcjonalny, ale zdecydowanie zalecany.

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

  • jak działa rozszerzenie, jakie zadania należy wykonać przed jego zainstalowaniem oraz szczegółowe informacje o rozszerzeniu.
  • Ogólne informacje identyfikacyjne i opis
  • czy zadania rozszerzenia wymagają konta rozliczeniowego.
  • Usługi Google (interfejsy 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 w Extensions Hub.

  2. Kliknij kartę rozszerzenia, aby:

    • Wyświetl szczegółowe informacje o rozszerzeniu.

    • Znajdź link do kodu źródłowego rozszerzenia w repozytorium źródłowym Firebase Extensions.

      W katalogu rozszerzeń możesz wyświetlić te szczegółowe informacje w README.

Krok 2. Zainstaluj rozszerzenie

Podczas instalacji pojawi się prośba o zapoznanie się z podstawowymi wymaganiami rozszerzenia (takimi jak włączone interfejsy API, utworzone zasoby czy przyznany dostęp). Otrzymasz powiadomienie o wymaganiach dotyczących płatności. Pojawi się też prośba o podanie wartości parametrów konfigurowalnych rozszerzenia.

  1. Przeglądaj oficjalne rozszerzenia Firebase w sklepie Extensions Hub.

  2. Kliknij kartę rozszerzenia, a następnie zapoznaj się ze szczegółowymi informacjami o rozszerzeniu, które mogą zawierać instrukcje dotyczące jego używania oraz czynności do wykonania przed instalacją.

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

Krok 3. Dokończ konfigurowanie po instalacji

Niektóre rozszerzenia wymagają wykonania określonych czynności przed ich użyciem. Instrukcje te znajdziesz na stronie z informacjami o rozszerzeniu po jego zainstalowaniu w panelu Extensions konsoli Firebase (link do panelu wyświetla się w terminalu po instalacji).

Instrukcje te znajdziesz też w pliku POSTINSTALL.md, który znajduje się w katalogu źródłowym rozszerzenia.

Tworzenie zasobów Firebase

Jeśli skonfigurujesz rozszerzenie tak, aby używało zasobów Firebase (Cloud Firestorekolekcji, Realtime Databaseścieżek i Cloud Storagepojemników), które jeszcze nie istnieją, utwórz je przed użyciem rozszerzenia.

Tworzenie modułów obsługi zdarzeń Eventarc

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

W dokumentacji rozszerzenia znajdziesz listę publikowanych przez nie zdarzeń (jeśli w ogóle są publikowane). Zobacz np. typy zdarzeń w przypadku rozszerzenia Uruchamianie płatności za pomocą Stripe.

Następnie zapoznaj się z artykułem [GA4] Zdarzenia niestandardowe, aby dowiedzieć się więcej o tworzeniu w usłudze Eventarc obsługi zdarzeń.

Instalowanie wielu instancji rozszerzeń

To samo rozszerzenie możesz zainstalować więcej niż raz w tym samym projekcie. Każde zainstalowane wystąpienie może mieć własną konfigurację i własne zasoby rozszerzenia. Każdą zainstalowaną instancję możesz identyfikować i odwoływać się do niej za pomocą jej identyfikatora instancji, który jest niepowtarzalny w ramach projektu.

Pojawi się prośba o potwierdzenie lub zmianę identyfikatora każdej dodatkowej instancji instalowanego rozszerzenia.

Następne kroki