Poznaj projekty Firebase

Ta strona zawiera krótki przegląd kilku ważnych koncepcji dotyczących projektów Firebase. Jeśli są dostępne, skorzystaj z łączy, aby znaleźć bardziej szczegółowe informacje na temat funkcji, usług, narzędzi i najlepszych praktyk.

Związek między projektami, aplikacjami i produktami Firebase

Projekt Firebase jest jednostką najwyższego poziomu w Firebase. W projekcie możesz zarejestrować aplikacje Apple, Android lub internetowe. Po zarejestrowaniu aplikacji w Firebase możesz dodać zestawy SDK Firebase dla dowolnej liczby produktów Firebase , takich jak Analytics, Cloud Firestore, Monitorowanie wydajności lub Zdalna konfiguracja.

Więcej szczegółowych informacji na temat tego procesu znajdziesz w przewodniku wprowadzającym dla Twojej platformy:
iOS+ | Androida | sieć | Jedność | C++ | Trzepotanie .

Zrozumienie hierarchii projektów Firebase

Diagram przedstawiający podstawową hierarchię projektu Firebase, w tym projekt, zarejestrowane w nim aplikacje oraz udostępnione zasoby i usługi Ten diagram przedstawia podstawową hierarchię projektu Firebase. Oto kluczowe zależności:

  • Projekt Firebase jest jak kontener dla wszystkich aplikacji oraz wszelkich zasobów i usług udostępnionych dla projektu.

  • W projekcie Firebase może być zarejestrowana jedna lub więcej aplikacji Firebase (na przykład zarówno wersja aplikacji na iOS, jak i Androida lub zarówno bezpłatna, jak i płatna wersja aplikacji).

  • Wszystkie aplikacje Firebase zarejestrowane w tym samym projekcie Firebase mają dostęp do tych samych zasobów i usług udostępnionych dla projektu . Oto kilka przykładów:

    • Wszystkie aplikacje Firebase zarejestrowane w tym samym projekcie Firebase korzystają z tych samych backendów, takich jak hosting Firebase, uwierzytelnianie, baza danych w czasie rzeczywistym, Cloud Firestore, Cloud Storage i Cloud Functions.

    • Wszystkie aplikacje Firebase zarejestrowane w tym samym projekcie Firebase są powiązane z tą samą usługą Google Analytics, przy czym każda aplikacja Firebase stanowi oddzielny strumień danych w tej usłudze.

Związek pomiędzy projektami Firebase i Google Cloud

Tworząc nowy projekt Firebase, tak naprawdę tworzysz za kulisami projekt Google Cloud . Możesz nawet najpierw utworzyć projekt Google Cloud, a później dodać do projektu Firebase. Możesz myśleć o projekcie Google Cloud jako o wirtualnym kontenerze na dane, kod, konfigurację i usługi.

Pamiętaj, że w przypadku wszystkich projektów Firebase Firebase automatycznie dodaje etykietę firebase:enabled na stronie Etykiety Twojego projektu w konsoli Google Cloud. Dowiedz się więcej o tej etykiecie w naszym FAQ .

Ponieważ projekt Firebase jest projektem Google Cloud:

Konfigurowanie projektu Firebase i rejestrowanie aplikacji

Możesz skonfigurować projekt Firebase i zarejestrować aplikacje w konsoli Firebase (lub, w przypadku zaawansowanych zastosowań, za pośrednictwem interfejsu API REST zarządzania Firebase lub interfejsu CLI Firebase ). Konfigurując projekt i rejestrując aplikacje, musisz podjąć pewne decyzje organizacyjne i dodać informacje konfiguracyjne specyficzne dla Firebase do swoich lokalnych projektów.

W przypadku aplikacji produkcyjnych należy skonfigurować przejrzysty przepływ pracy programistycznej, który zwykle obejmuje korzystanie z wielu środowisk. Przejrzyj naszą dokumentację dotyczącą przepływów pracy dla programistów , w tym ogólne najlepsze praktyki i ogólne wytyczne dotyczące bezpieczeństwa dotyczące konfigurowania projektów Firebase i rejestrowania aplikacji w celu tworzenia przepływu pracy programistycznej.

Interakcja z projektem Firebase

Oprócz pakietów SDK produktów możesz bezpośrednio wchodzić w interakcję z projektem Firebase, korzystając z kilku różnych narzędzi i interfejsów.

Konsola Firebase

Konsola Firebase oferuje najbogatsze środowisko do zarządzania produktami, aplikacjami i ustawieniami Firebase na poziomie projektu.

Konsola Firebase - ekran przeglądu projektu

Panel po lewej stronie konsoli zawiera listę produktów Firebase uporządkowanych według kategorii najwyższego poziomu. W górnej części panelu po lewej stronie uzyskaj dostęp do ustawień projektu, klikając . Ustawienia projektu obejmują integracje , uprawnienia dostępu i rozliczenia .

Na środku konsoli znajdują się przyciski uruchamiające konfiguracje w celu rejestracji różnych typów aplikacji. Po rozpoczęciu korzystania z Firebase główny obszar konsoli zmienia się w dashboard, na którym wyświetlane są statystyki dotyczące używanych produktów.

Pamiętaj, że ponieważ projekt Firebase jest także projektem Google Cloud, może się okazać, że różne zadania lub produkty będą wymagały użycia konsoli Google Cloud zamiast konsoli Firebase.

Firebase CLI (narzędzie wiersza poleceń)

Firebase oferuje także interfejs CLI Firebase do konfigurowania i zarządzania określonymi produktami Firebase, takimi jak Hosting Firebase, Cloud Functions dla Firebase i Rozszerzenia Firebase.

Po zainstalowaniu interfejsu CLI masz dostęp do globalnego polecenia firebase . Użyj interfejsu wiersza polecenia, aby połączyć lokalny katalog aplikacji z projektem Firebase , a następnie wdrażaj nowe wersje treści hostowanych w Firebase lub aktualizacje funkcji.

Interfejs API REST zarządzania Firebase

Korzystając z interfejsu API REST zarządzania Firebase , możesz programowo zarządzać projektem Firebase. Na przykład możesz programowo zarejestrować aplikację w projekcie lub wyświetlić listę aplikacji, które są już zarejestrowane ( iOS+ | Android | web ).

Identyfikatory projektu Firebase

Projekt Firebase można zidentyfikować w zapleczu Firebase oraz w różnych interfejsach programistów przy użyciu różnych identyfikatorów, w tym nazwy projektu , numeru projektu i identyfikatora projektu .

Nazwa projektu

Tworząc projekt, podajesz nazwę projektu . Ten identyfikator jest wewnętrzną nazwą projektu w konsoli Firebase , konsoli Google Cloud i interfejsie wiersza polecenia Firebase . Nazwa projektu nie jest ujawniana w żadnym publicznie widocznym produkcie, usłudze ani zasobie Firebase ani Google Cloud; służy po prostu do łatwiejszego rozróżniania wielu projektów.

Nazwę projektu możesz w każdej chwili edytować w Ustawienia projektu konsoli Firebase. Nazwa projektu zostanie wyświetlona w górnym panelu.

Numer projektu

Projekt Firebase (i powiązany z nim projekt Google Cloud ) ma numer projektu . Jest to przypisany przez Google, globalnie unikalny identyfikator kanoniczny projektu. Użyj tego identyfikatora podczas konfigurowania integracji i/lub wykonywania wywołań API do Firebase, Google lub usług stron trzecich.

Nie można edytować numeru projektu. Jeśli usuniesz projekt, numer projektu również zostanie usunięty i nie będzie mógł już nigdy zostać użyty w żadnym innym projekcie.

Identyfikator projektu

Projekt Firebase (i powiązany z nim projekt Google Cloud ) ma identyfikator projektu . Jest to unikalny identyfikator projektu zdefiniowany przez użytkownika we wszystkich Firebase i Google Cloud. Kiedy tworzysz projekt Firebase, Firebase automatycznie przypisuje projektowi unikalny identyfikator, ale możesz go edytować podczas konfiguracji projektu. Identyfikator ten należy ogólnie traktować jako wygodny alias odniesienia do projektu.

Pliki konfiguracyjne i obiekty Firebase

Kiedy rejestrujesz aplikację w projekcie Firebase, konsola Firebase udostępnia plik konfiguracyjny Firebase (aplikacje Apple/Android) lub obiekt konfiguracyjny (aplikacje internetowe), który dodajesz bezpośrednio do lokalnego katalogu aplikacji.

  • W przypadku aplikacji Apple dodajesz plik konfiguracyjny GoogleService-Info.plist .
  • W przypadku aplikacji na Androida dodajesz plik konfiguracyjny google-services.json .
  • W przypadku aplikacji internetowych dodajesz obiekt konfiguracyjny Firebase.

W dowolnym momencie możesz uzyskać plik konfiguracyjny lub obiekt Firebase aplikacji .

Plik lub obiekt konfiguracyjny Firebase wiąże aplikację z konkretnym projektem Firebase i jego zasobami (bazami danych, zasobnikami pamięci itp.). Konfiguracja obejmuje „opcje Firebase”, czyli parametry wymagane przez usługi Firebase i Google do komunikacji z interfejsami API serwera Firebase oraz do powiązania danych klienta z projektem Firebase i aplikacją Firebase. Oto wymagane, minimalne „opcje Firebase”:

  • Klucz API : prosty zaszyfrowany ciąg znaków używany podczas wywoływania niektórych interfejsów API, które nie wymagają dostępu do prywatnych danych użytkownika (przykładowa wartość: AIzaSyDOCAbC123dEf456GhI789jKl012-MnO )

  • Identyfikator projektu : unikalny identyfikator projektu zdefiniowany przez użytkownika we wszystkich Firebase i Google Cloud. Identyfikator ten może pojawiać się w adresach URL lub nazwach niektórych zasobów Firebase, ale ogólnie należy go traktować jako wygodny alias umożliwiający odniesienie do projektu. (przykładowa wartość: myapp-project-123 )

  • Identyfikator aplikacji („AppID”) : unikalny identyfikator aplikacji Firebase w całej Firebase w formacie specyficznym dla platformy:

    • Aplikacje Firebase Apple: GOOGLE_APP_ID (przykładowa wartość: 1:1234567890:ios:321abc456def7890 )
      To nie jest identyfikator pakietu Apple.
    • Aplikacje Firebase na Androida: mobilesdk_app_id (przykładowa wartość: 1:1234567890:android:321abc456def7890 )
      To nie jest nazwa pakietu Androida ani identyfikator aplikacji Android.
    • Aplikacje internetowe Firebase: appId (przykładowa wartość: 1:65211879909:web:3ae38ef1cdcb2e01fe5f0c )

Zawartość pliku konfiguracyjnego lub obiektu Firebase jest uważana za publiczną, w tym identyfikator specyficzny dla platformy aplikacji (identyfikator pakietu Apple lub nazwa pakietu Android) oraz wartości specyficzne dla projektu Firebase, takie jak klucz API, identyfikator projektu, adres URL bazy danych czasu rzeczywistego i Nazwa zasobnika Cloud Storage. Mając to na uwadze, użyj reguł bezpieczeństwa Firebase, aby chronić swoje dane i pliki w bazach danych Realtime Database , Cloud Firestore i Cloud Storage .

W przypadku projektów typu open source generalnie nie zalecamy dołączania pliku konfiguracyjnego Firebase aplikacji lub obiektu do kontroli źródła, ponieważ w większości przypadków użytkownicy powinni tworzyć własne projekty Firebase i kierować swoje aplikacje do własnych zasobów Firebase (poprzez własną konfigurację Firebase plik lub obiekt).

Ogólne limity dotyczące projektów, aplikacji i witryn Firebase

Oto kilka ogólnych ograniczeń dotyczących projektów, aplikacji i witryn Firebase:

  • Liczba projektów na konto

    • Plan cenowy Spark — Limit tworzenia projektów jest ograniczony do mniejszej liczby projektów (zwykle około 5-10).
    • Plan cenowy Blaze — limit tworzenia projektów na konto znacznie wzrasta, o ile powiązane konto rozliczeniowe Cloud ma dobrą opinię.

    Limit limitu tworzenia projektów rzadko budzi obawy większości programistów, ale w razie potrzeby możesz poprosić o zwiększenie limitu projektu .

    Należy pamiętać, że całkowite usunięcie projektu zajmuje 30 dni i wlicza się do limitu projektu do czasu całkowitego usunięcia projektu.

  • Liczba aplikacji na projekt

    Firebase ogranicza całkowitą liczbę aplikacji Firebase w projekcie Firebase do 30.

    Należy upewnić się, że wszystkie aplikacje Firebase w ramach jednego projektu Firebase są wariantami platformowymi tej samej aplikacji z punktu widzenia użytkownika końcowego. Przeczytaj więcej o wielodostępności w naszych dokumentach najlepszych praktyk.

    Dowiedz się więcej o limicie aplikacji na projekt w często zadawanych pytaniach.

  • Liczba witryn hostingowych na projekt

    Funkcja wielu witryn Firebase Hosting obsługuje maksymalnie 36 witryn na projekt.

Uruchamiam aplikację