Możesz instalować dowolne aplikacje (i zarządzać nimi) oficjalnych rozszerzeń Firebase za pomocą konsoli Firebase lub interfejs wiersza poleceń Firebase (interfejs wiersza poleceń).
Zapoznaj się z różnic w obsługiwane działania w interfejsie wiersza poleceń Firebase i konsoli Firebase.
Aby instalować rozszerzenia i nimi zarządzać, musisz mieć przypisaną jedną z tych ról: Właściciel lub Edytujący lub Administrator Firebase.
Aby można było zainstalować rozszerzenie, projekt musi być połączony z usługą Blaze (płatność według idź). Chociaż nie ma żadnych opłat za instalowanie rozszerzenia, może się okazać, że opłat za korzystanie z usług Firebase i usług Cloud, takich jak Cloud Secret Manager, jeśli wykorzystanie usług przekracza bezpłatnie .
Zanim zaczniesz
Dodaj Firebase do swojego projektu, a potem przejdź na wyższą wersję (chyba że masz to już za sobą). z projektu Firebase na abonament Blaze (płatność według wykorzystania).
Krok 1. Wyświetl szczegółowe informacje o rozszerzeniu
Ten krok jest opcjonalny, ale zdecydowanie zalecany.
Przed zainstalowaniem Firebase Extension zalecamy zawierają szczegółowe informacje o rozszerzeniu, w tym:
- Sposób działania rozszerzenia, zadania wstępne rozszerzenie
- Ogólne informacje umożliwiające identyfikację i opis
- tego, czy zadania rozszerzenia wymagają konta rozliczeniowego.
- usług Google (interfejsy API) oraz role dostępu wymagane przez operacja
- Zasoby utworzone na potrzeby rozszerzenia (takie jak funkcje)
- Opisy parametrów konfigurowanych przez użytkownika
Aby wyświetlić szczegółowe informacje o rozszerzeniu:
Przeglądaj oficjalne rozszerzenia Firebase w Extensions Hub.
Kliknij kartę rozszerzenia, aby:
Wyświetl szczegółowe informacje o rozszerzeniu.
Znajdź link do kodu źródłowego rozszerzenia w Firebase Extensions repozytorium źródłowe.
W sekcji katalogu rozszerzeń, możesz wyświetlić te szczegółowe informacje w
README
.
Krok 2. Zainstaluj rozszerzenie
W trakcie instalacji pojawi się prośba o zapoznanie się z podstawowymi specyfikacje rozszerzenia (takie jak włączone interfejsy API, utworzone zasoby, dostęp przyznany itp.). Powiadomimy Cię o wszystkich wymaganiach dotyczących płatności oraz z prośbą o określać wartości konfigurowalnych parametrów rozszerzenia.
Przeglądaj oficjalne rozszerzenia Firebase w Extensions Hub.
Kliknij kartę rozszerzenia, a następnie sprawdź szczegółowe informacje o które może udostępnić szczegółowe instrukcje użytkowania zadań preinstalacyjnych.
Kliknij Zainstaluj i postępuj zgodnie z instrukcjami wyświetlanymi na ekranie, aby zainstalować aplikację. z takim rozszerzeniem.
Krok 3. Zakończ konfigurację po instalacji
W przypadku niektórych rozszerzeń wymagane lub opcjonalne czynności, które należy wykonać przed użyciem . Instrukcje znajdziesz na stronie z informacjami po instalacji rozszerzenia w: panelu Extensions w konsoli Firebase (konkretny link do po instalacji wyświetli się panel informacyjny w terminalu).
Te instrukcje możesz również znaleźć w pliku POSTINSTALL.md
zawartym w
katalogu źródłowego rozszerzenia.
Tworzenie zasobów Firebase
Jeśli rozszerzenie zostało skonfigurowane do korzystania z zasobów Firebase (Cloud Firestore) kolekcji, Realtime Database ścieżek, Cloud Storage zasobników), które jeszcze nie istnieją, utworzyć je przed użyciem tego rozszerzenia.
Tworzenie modułów obsługi zdarzeń Eventarc
Niektóre rozszerzenia są publikowane w Eventarc gdy podczas jej wykonywania mają miejsce ważne zdarzenia. Jeśli rozszerzenie publikuje zdarzenia a w trakcie instalacji zostały włączone zdarzenia, możesz napisać funkcje, które reagują na zdarzenia do tych zdarzeń za pomocą Twojej własnej logiki. Jest to przydatne na przykład do: powiadamiać użytkowników o zakończeniu długo trwających zadań lub o przetwarzaniu danych wyjściowych z funkcją rozszerzenia.
Listę zdarzeń publikowanych przez rozszerzenie (jeśli takie są) znajdziesz w dokumentacji. Na przykład zobacz typy zdarzeń w rozszerzeniu Run Payments with Stripe.
Następnie przeczytaj artykuł Reguły zdarzeń niestandardowych w przypadku: informacje o tworzeniu modułów obsługi zdarzeń Eventarc.
Zainstaluj wiele instancji rozszerzeń
To samo rozszerzenie możesz zainstalować więcej niż raz w tym samym projekcie. Każda zainstalowana instancja może mieć własną konfigurację niestandardową i własną z rozszerzeniami. Możesz zidentyfikować każdą zainstalowaną instancję i odwoływać się do niej za pomocą identyfikator instancji, który jest unikalny w obrębie projektu. Za pojawi się prośba o potwierdzenie lub edycję identyfikatora każdej dodatkowej instancji zainstalowane rozszerzenie.
Następne kroki
Wyświetl szczegóły oraz zainstalowanego rozszerzenia w konsoli Firebase.
Monitorowanie aktywności zainstalowanego rozszerzenia, w tym kontrole jego stanu, użycia i logów.
Korzystając z konsoli Firebase, zarządzaj zainstalowane rozszerzenie. W przypadku oficjalnych rozszerzeń Firebase możesz zmienić konfigurację lub odinstaluj rozszerzenie, a następnie zaktualizuj je do najnowszej wersji wersji.
Sprawdzoną metodą we wszystkich projektach jest konfiguracja alerty dotyczące budżetu w projekcie oraz monitoruj wykorzystanie i płatności panel w konsoli Firebase.