Catch up on everything announced at Firebase Summit, and learn how Firebase can help you accelerate app development and run your app with confidence. Learn More

Zainstaluj rozszerzenie Firebase

Zadbaj o dobrą organizację dzięki kolekcji Zapisuj i kategoryzuj treści zgodnie ze swoimi preferencjami.

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, mogą zostać naliczone opłaty za korzystanie z usług Firebase lub usług w chmurze, takich jak Cloud Secret Manager , jeśli wykorzystanie przekracza poziom bezpłatnych usług.

Zanim zaczniesz

  1. Jeśli jeszcze tego nie zrobiłeś, dodaj Firebase do swojego projektu .

  2. Jeśli jeszcze tego nie zrobiłeś, uaktualnij swój projekt do planu Blaze (płatność na bieżąco).

  3. Zainstaluj lub zaktualizuj do najnowszej wersji interfejsu wiersza polecenia Firebase.

  4. Zanotuj identyfikator projektu Firebase lub wcześniej skonfigurowany alias projektu.

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. Upewnij się, że masz skonfigurowane środowisko i wybrane rozszerzenie .

  2. Uruchom polecenie rozszerzenia informacji z dowolnego miejsca na komputerze:

    firebase ext:info publisher-id/extension-id

    Argumenty publisher-id extension-id są wymagane i można je znaleźć na stronie szczegółów przedinstalacyjnych rozszerzenia .

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. Upewnij się, że masz skonfigurowane środowisko i wybrane rozszerzenie .

  2. W lokalnym katalogu Firebase uruchom polecenie extension-install. Jeśli pojawi się monit, wprowadź wartości parametrów, aby dostosować wystąpienie rozszerzenia.

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

    Argumenty publisher-id extension-id są wymagane i można je znaleźć na stronie szczegółów przedinstalacyjnych rozszerzenia .

    Uruchomienie tego polecenia powoduje dodanie wystąpienia rozszerzenia do manifestu rozszerzeń .

  3. Następnie, aby wdrożyć rozszerzenia z manifestu w projekcie Firebase, uruchom:

    firebase deploy --only extensions --project=projectId-or-alias

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

  • Wyświetl szczegóły i konfigurację zainstalowanego rozszerzenia w konsoli Firebase.

  • Monitoruj aktywność zainstalowanego rozszerzenia, w tym sprawdzaj jego stan, użycie i dzienniki.

  • Za pomocą interfejsu Firebase CLI zarządzaj zainstalowanym rozszerzeniem. Możesz zmienić konfigurację lub odinstalować rozszerzenie, a także zaktualizować je do najnowszej wersji.

  • Za pomocą konsoli Firebase zarządzaj zainstalowanym rozszerzeniem. W przypadku oficjalnych rozszerzeń Firebase możesz ponownie skonfigurować lub odinstalować rozszerzenie, a także zaktualizować je do najnowszej wersji.

  • Najlepszym rozwiązaniem dla wszystkich projektów jest skonfigurowanie alertów budżetowych dla projektu i monitorowanie pulpitu nawigacyjnego użytkowania i rozliczeń w konsoli Firebase.