Ta strona zawiera krótkie omówienie kilku ważnych koncepcji dotyczących projektów Firebase. Jeśli są dostępne, skorzystaj z łączy, aby znaleźć bardziej szczegółowe informacje o funkcjach, usługach, narzędziach i najlepszych praktykach.
Relacje między projektami, aplikacjami i produktami Firebase
Projekt Firebase jest jednostką najwyższego poziomu w Firebase. W projekcie możesz zarejestrować swoje aplikacje Apple, Android lub internetowe. Po zarejestrowaniu aplikacji w Firebase możesz dodać pakiety SDK Firebase dla dowolnej liczby produktów Firebase , takich jak Analytics, Cloud Firestore, monitorowanie wydajności czy zdalna konfiguracja.
Więcej szczegółowych informacji na temat tego procesu można znaleźć w przewodniku Pierwsze kroki dla Twojej platformy:
iOS+ | Androida | sieć | Jedność | C++ | Trzepotanie .
Zrozumienie hierarchii projektów Firebase
Ten diagram przedstawia podstawową hierarchię projektu Firebase. Oto kluczowe zależności:
Projekt Firebase jest jak kontener dla wszystkich Twoich aplikacji oraz wszelkich zasobów i usług udostępnionych dla projektu.
Projekt Firebase może mieć zarejestrowaną co najmniej jedną aplikację Firebase (na przykład zarówno wersję aplikacji na iOS, jak i Androida lub zarówno bezpłatną, jak i płatną wersję aplikacji).
Wszystkie aplikacje Firebase zarejestrowane w tym samym projekcie Firebase współużytkują i mają dostęp do wszystkich 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 współdzielą te same backendy, takie jak Hosting Firebase, Uwierzytelnianie, Baza danych czasu rzeczywistego, 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, gdzie każda aplikacja Firebase jest osobnym strumieniem danych w tej usłudze.
Związek między projektami Firebase a Google Cloud
Kiedy tworzysz nowy projekt Firebase, w rzeczywistości tworzysz projekt Google Cloud za kulisami. Możesz nawet najpierw utworzyć projekt Google Cloud, a później dodać Firebase do projektu. Możesz myśleć o projekcie Google Cloud jako o wirtualnym kontenerze danych, kodu, konfiguracji i usług.
Pamiętaj, że w przypadku wszystkich projektów Firebase Firebase automatycznie dodaje etykietę firebase:enabled
na stronie Etykiety Twojego projektu w Google Cloud Console. Dowiedz się więcej o tej etykiecie w naszym FAQ .
Ponieważ projekt Firebase jest projektem Google Cloud:
Możesz wchodzić w interakcje z projektem w konsoli Firebase , jak również w Google Cloud Console i konsoli Google APIs .
W projekcie możesz używać produktów i interfejsów API z Firebase i Google Cloud.
Rozliczenia i uprawnienia do projektu są wspólne dla Firebase i Google Cloud.
Unikalne identyfikatory projektu (takie jak numer projektu i identyfikator projektu ) są udostępniane w Firebase i Google Cloud.
Usunięcie projektu powoduje usunięcie go z Firebase i 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 Firebase CLI ). Podczas konfigurowania projektu i rejestrowania aplikacji należy podjąć pewne decyzje organizacyjne i dodać do lokalnych projektów informacje o konfiguracji specyficzne dla Firebase.
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 sprawdzone metody i ogólne wytyczne dotyczące bezpieczeństwa dotyczące konfigurowania projektów Firebase i rejestrowania aplikacji w celu utworzenia przepływu pracy dla programistów.
Interakcja z projektem Firebase
Oprócz zestawów SDK produktu możesz bezpośrednio wchodzić w interakcje z projektem Firebase przy użyciu 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.
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 przejdź do ustawień projektu, klikając integracje , uprawnienia dostępu i rozliczenia .
. Ustawienia projektu obejmująNa środku konsoli wyświetlane są przyciski, które uruchamiają przepływy pracy konfiguracji w celu zarejestrowania różnych typów aplikacji. Gdy zaczniesz korzystać z Firebase, główny obszar konsoli zmieni się w pulpit nawigacyjny, który wyświetla statystyki produktów, z których korzystasz.
Pamiętaj, że ponieważ projekt Firebase jest również projektem Google Cloud, może się okazać, że różne zadania lub produkty wymagają użycia konsoli Google Cloud zamiast konsoli Firebase.
Firebase CLI (narzędzie wiersza poleceń)
Firebase oferuje również Firebase CLI do konfigurowania i zarządzania określonymi produktami Firebase, takimi jak Firebase Hosting, Cloud Functions for Firebase i Firebase Extensions.
Po zainstalowaniu CLI masz dostęp do globalnej komendy 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 przez 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 projektów Firebase
Projekt Firebase można zidentyfikować w zapleczu Firebase i w różnych interfejsach programistów za pomocą różnych identyfikatorów, w tym nazwy projektu , numeru projektu i identyfikatora projektu .
Nazwa projektu
Podczas tworzenia projektu podajesz nazwę projektu . Ten identyfikator to wewnętrzna nazwa projektu w konsoli Firebase , Google Cloud Console i Firebase CLI . Nazwa projektu nie jest widoczna w żadnym publicznie widocznym produkcie, usłudze lub zasobie Firebase lub Google Cloud; służy po prostu do ułatwienia rozróżniania wielu projektów.
Możesz edytować nazwę projektu w dowolnym momencie w projektu w konsoli Firebase. Nazwa projektu jest wyświetlana w górnym okienku.
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 innych firm.
Nie możesz edytować numeru projektu. Jeśli usuniesz projekt, numer projektu również zostanie usunięty i nigdy nie będzie mógł być ponownie użyty w żadnym innym projekcie.
Znajdź numer projektu swojego projektu Firebase, korzystając z jednej z tych opcji:
Używając konsoli Firebase : Kliknij projektu . Numer projektu jest wyświetlany w górnym okienku.
Korzystanie z Firebase CLI : Uruchom
firebase projects:list
. Numer projektu jest wyświetlany wraz ze wszystkimi projektami Firebase powiązanymi z Twoim kontem.Korzystanie z interfejsu API REST zarządzania Firebase : Wywołaj
projects.list
. Treść odpowiedzi zawiera numer projektu w obiekcieFirebaseProject
.
W przypadku wielu wywołań interfejsu API konieczne jest podanie unikalnego identyfikatora projektu. Chociaż wiele interfejsów API akceptuje identyfikator projektu , zaleca się używanie numeru projektu do nawiązywania wywołań interfejsu API do Firebase, Google lub usług innych firm.
Dowiedz się więcej o korzystaniu z identyfikatorów projektów, zwłaszcza numeru projektu, w standardzie Google AIP 2510 .
Identyfikator projektu
Projekt Firebase (i powiązany z nim projekt Google Cloud ) ma identyfikator projektu . Jest to zdefiniowany przez użytkownika unikalny identyfikator projektu we wszystkich Firebase i Google Cloud. Kiedy tworzysz projekt Firebase, Firebase automatycznie przypisuje mu unikalny identyfikator, ale możesz go edytować podczas konfigurowania projektu. Ten identyfikator powinien być ogólnie traktowany jako wygodny alias odnoszący się do projektu.
Znajdź identyfikator projektu Firebase, korzystając z jednej z tych opcji:
Używając konsoli Firebase : Kliknij projektu . Identyfikator projektu jest wyświetlany w górnym okienku.
Korzystanie z Firebase CLI : Uruchom
firebase projects:list
. Identyfikator projektu jest wyświetlany wraz ze wszystkimi projektami Firebase powiązanymi z Twoim kontem.Korzystanie z interfejsu API REST zarządzania Firebase : Wywołaj
projects.list
. Treść odpowiedzi zawiera identyfikator projektu w obiekcieFirebaseProject
.
Identyfikator projektu jest wyświetlany w publicznie widocznych zasobach Firebase, na przykład:
- Domyślna subdomena hostingu —
PROJECT_ID .web.app
iPROJECT_ID .firebaseapp.com
- Adres URL domyślnej bazy danych czasu rzeczywistego —
PROJECT_ID -default-rtdb.firebaseio.com
lubPROJECT_ID -default-rtdb. REGION_CODE .firebasedatabase.app
- Domyślna nazwa zasobnika Cloud Storage —
PROJECT_ID .appspot.com
Dla wszystkich wyżej wymienionych zasobów można utworzyć instancje inne niż domyślne. Publicznie widoczne nazwy elementów niedomyślnych można w pełni dostosować. Możesz łączyć domeny niestandardowe z witryną hostowaną przez Firebase, udostępniać bazę danych czasu rzeczywistego i tworzyć wiele zasobników Cloud Storage (odwiedź stronę Pierwsze kroki dla poszczególnych platform).
W niektórych przypadkach możesz mieć wiele projektów Firebase powiązanych z tym samym lokalnym katalogiem aplikacji. W takich sytuacjach, gdy używasz Firebase CLI , musisz przekazać flagę --project
z poleceniami firebase
, aby poinformować, z którym projektem Firebase chcesz wchodzić w interakcje.
Możesz także skonfigurować alias projektu dla każdego projektu Firebase, aby nie musieć zapamiętywać identyfikatorów projektów.
W przypadku wielu wywołań interfejsu API konieczne jest podanie unikalnego identyfikatora projektu. Chociaż wiele interfejsów API akceptuje identyfikator projektu, zaleca się używanie numeru projektu do wykonywania wywołań interfejsu API do Firebase, Google lub usług innych firm.
Dowiedz się więcej o korzystaniu z identyfikatorów projektów, zwłaszcza numeru projektu, w standardzie Google AIP 2510 .
Pliki konfiguracyjne i obiekty Firebase
Gdy zarejestrujesz 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 firmy Apple należy dodać 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 konfiguracyjny lub obiekt Firebase wiąże aplikację z określonym projektem Firebase i jego zasobami (bazy danych, zasobniki pamięci itp.). Konfiguracja obejmuje „opcje Firebase”, które są parametrami wymaganymi 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 używany podczas wywoływania niektórych interfejsów API, które nie potrzebują dostępu do prywatnych danych użytkownika (przykładowa wartość:
AIzaSyDOCAbC123dEf456GhI789jKl012-MnO
)Identyfikator projektu : zdefiniowany przez użytkownika unikalny identyfikator projektu we wszystkich Firebase i Google Cloud. Ten identyfikator może pojawiać się w adresach URL lub nazwach niektórych zasobów Firebase, ale ogólnie powinien być traktowany jako wygodny alias odnoszący się do projektu. (przykładowa wartość:
myapp-project-123
)Identyfikator aplikacji („AppID”) : unikalny identyfikator aplikacji Firebase w całym 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 Androida. - Aplikacje internetowe Firebase:
appId
(przykładowa wartość:1:65211879909:web:3ae38ef1cdcb2e01fe5f0c
)
- Aplikacje Firebase Apple:
Treść pliku konfiguracyjnego lub obiektu Firebase jest uważana za publiczną, w tym identyfikator 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. Biorąc to pod uwagę, użyj Reguł bezpieczeństwa Firebase , aby chronić swoje dane i pliki w Bazie danych czasu rzeczywistego , Cloud Firestore i Cloud Storage .
W przypadku projektów open source generalnie nie zalecamy uwzględniania pliku konfiguracyjnego ani obiektu Firebase aplikacji w kontroli źródła, ponieważ w większości przypadków użytkownicy powinni tworzyć własne projekty Firebase i wskazywać swoim aplikacjom własne zasoby Firebase (poprzez własną konfigurację Firebase plik lub obiekt).
Ogólne ograniczenia 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 Cloud Billing ma dobrą opinię.
Limit przydziału tworzenia projektów rzadko stanowi problem dla większości programistów, ale w razie potrzeby można poprosić o zwiększenie przydziału projektu .
Pamiętaj, że całkowite usunięcie projektu wymaga 30 dni i wlicza się do limitu projektu, dopóki projekt nie zostanie całkowicie usunięty.
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 platformy tej samej aplikacji z perspektywy użytkownika końcowego. Przeczytaj więcej o wielu dzierżawcach w naszych dokumentach dotyczących najlepszych praktyk.
Dowiedz się więcej o limicie aplikacji na projekt w często zadawanych pytaniach.
Liczba witryn hostingowych na projekt
Funkcja wielostanowiskowa Hostingu Firebase obsługuje maksymalnie 36 witryn na projekt.
Uruchamianie aplikacji
- Skonfiguruj alerty dotyczące budżetu dla swojego projektu w Google Cloud Console.
- Monitoruj pulpit nawigacyjny Wykorzystanie i rozliczenia w konsoli Firebase, aby uzyskać ogólny obraz wykorzystania projektu w wielu usługach Firebase.
- Przejrzyj listę kontrolną uruchamiania Firebase .