Ta strona zawiera krótkie omówienie kilku ważnych pojęć związanych z projektami Firebase. Jeśli to możliwe, kliknij linki, aby uzyskać bardziej szczegółowe informacje o funkcjach, usługach, narzędziach i sprawdzonych metodach.
Zależności między projektami, aplikacjami i usługami Firebase
Projekt Firebase to jednostka najwyższego poziomu w Firebase. W projekcie możesz zarejestrować aplikacje na iOS, Androida i aplikacje internetowe. Po zarejestrowaniu aplikacji w Firebase możesz dodać pakiety SDK Firebase do dowolnej liczby usług Firebase, takich jak Analytics, Cloud Firestore, Performance Monitoring, czy Remote Config.
Więcej informacji o tym procesie znajdziesz w przewodniku dla początkujących
dotyczącym Twojej platformy:
iOS+ | Android |
sieć | Unity | C++ |
Flutter.
Hierarchia projektów Firebase
Ten diagram przedstawia podstawową hierarchię projektu Firebase. Oto najważniejsze zależności:
Projekt Firebase to kontener na wszystkie Twoje aplikacje oraz zasoby i usługi udostępnione w projekcie.
Projekt Firebase może mieć zarejestrowaną co najmniej 1 aplikację Firebase (np. wersję aplikacji na iOS i Androida lub wersję bezpłatną i płatną).
Wszystkie aplikacje Firebase zarejestrowane w tym samym projekcie Firebase mają dostęp do tych samych zasobów i usług udostępnionych w projekcie. Przykłady:
Wszystkie aplikacje Firebase zarejestrowane w tym samym projekcie Firebase korzystają z tych samych backendów, takich jak Firebase Hosting, Authentication, Realtime Database, 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, w której każda aplikacja Firebase jest osobnym strumieniem danych.
Zależności między projektami Firebase a Google Cloud
Gdy tworzysz nowy projekt Firebase, faktycznie tworzysz w tle projekt Google Cloud. Możesz nawet najpier0 utworzyć projekt, a potem dodać do niego Firebase.Google Cloud Projekt Google Cloud można traktować jako wirtualny kontener na dane, kod, konfigurację i usługi.
Pamiętaj, że w przypadku wszystkich projektów Firebase usługa ta automatycznie dodaje do projektu
etykietę firebase:enabled na stronie IAM i administracja >
Etykiety
w konsoli Google Cloud. Więcej informacji o tej etykiecie znajdziesz w naszych
najczęstszych pytaniach.
Projekt Firebase jest projektem Google Cloud, dlatego:
możesz uzyskiwać dostęp do projektu i wchodzić z nim w interakcje w konsoli Firebase a także w Google Cloud i konsoli interfejsów API Google.
możesz wchodzić w interakcje z projektem za pomocą Firebase wiersza poleceń, the gcloud CLI, i dowolnego zasobu Terraform od Google;
w projekcie możesz używać usług i interfejsów API zarówno Firebase, jak i Google Cloud w ;
role i uprawnienia IAM w projekcie są wspólne dla Firebase i Google Cloud; każdy dostęp, jaki członek projektu (czyli podmiot) ma do Twojego Google Cloud projektu, będzie też dotyczyć Twojego projektu Firebase (i odwrotnie);
Płatności za projekt są wspólne dla Firebase i Google Cloud. jeśli w Twoim projekcie Google Cloud włączono płatności, w projekcie Firebase będziesz korzystać z abonamentu Blaze (płatność według wykorzystania);
unikalne identyfikatory projektu (takie jak numer projektu i identyfikator projektu) są wspólne dla Firebase i Google Cloud;
każda hierarchia zasobów zastosowana w Twoim Google Cloud projekcie (np. organizacja, foldery, itp.) będzie też dotyczyć Twojego projektu Firebase;
usunięcie projektu spowoduje jego usunięcie zarówno w Firebase, jak i w Google Cloud;
usunięcie lub zmodyfikowanie zasobu albo danych w projekcie spowoduje zmiany zarówno w Firebase, jak i w Google Cloud.
Konfigurowanie projektu Firebase i rejestrowanie aplikacji
Projekt Firebase możesz skonfigurować i zarejestrować aplikacje w Firebase konsoli (lub w bardziej zaawansowanych przypadkach za pomocą interfejsu Firebase Management REST API albo Firebase wiersza poleceń). Gdy konfigurujesz projekt i rejestrujesz aplikacje, musisz podjąć pewne decyzje organizacyjne i dodać do lokalnych projektów informacje konfiguracyjne specyficzne dla Firebase.
W przypadku aplikacji produkcyjnych musisz skonfigurować jasny proces tworzenia, który zwykle obejmuje korzystanie z wielu środowisk. Aby utworzyć proces tworzenia , zapoznaj się z naszą dokumentacją dotyczącą procesów deweloperskich , w tym ze sprawdzonymi metodami i ogólnymi wytycznymi dotyczącymi bezpieczeństwa w zakresie konfigurowania projektów Firebase i rejestrowania aplikacji.
Interakcje z projektem Firebase
Oprócz pakietów SDK usług możesz bezpośrednio wchodzić w interakcje z projektem Firebase za pomocą kilku różnych narzędzi i interfejsów.
Firebase konsola
Konsola FirebaseFirebase oferuje najbogatsze środowisko do zarządzania usługami, aplikacjami i ustawieniami na poziomie projektu.
W panelu po lewej stronie konsoli znajdują się usługi Firebase uporządkowane według kategorii najwyższego poziomu. U góry panelu po lewej stronie kliknij
Na środku konsoli znajdują się przyciski, które uruchamiają procesy konfiguracji umożliwiające rejestrowanie różnych typów aplikacji. Gdy zaczniesz korzystać z Firebase, główny obszar konsoli zmieni się w panel informacyjny, który wyświetla statystyki dotyczące używanych usług.
Pamiętaj, że projekt Firebase jest też projektem Google Cloud, dlatego w przypadku różnych zadań lub usług może być konieczne użycie konsoli Google Cloud zamiast konsoli Firebase.
Firebase wiersza poleceń (narzędzie wiersza poleceń)
Firebase oferuje też Firebase CLI do konfigurowania i zarządzania określonymi usługami Firebase, takimi jak Firebase Hosting, Cloud Functions for Firebase, i Firebase Extensions.
Po zainstalowaniu wiersza poleceń Firebase masz dostęp do
globalnego polecenia firebase. Użyj wiersza poleceń Firebase, aby połączyć lokalny katalog aplikacji z projektem Firebase, a następnie wdrożyć nowe wersje treści hostowanych w Firebase lub aktualizacje funkcji.Firebase
Interfejs Firebase Management REST API
Za pomocą interfejsu Firebase Management REST API możesz programowo zarządzać projektem Firebase. Możesz na przykład programowo zarejestrować aplikację w projekcie lub wyświetlić listę aplikacji, które są już zarejestrowane (iOS+ | Android | sieć).
Identyfikatory projektu Firebase
Projekt Firebase można zidentyfikować w backendzie Firebase i w różnych interfejsach deweloperskich za pomocą różnych identyfikatorów, w tym nazwy projektu, numeru projektu i identyfikatora projektu.
Nazwa projektu
Podczas tworzenia projektu podajesz jego nazwę. Ten identyfikator to nazwa wewnętrzna projektu w Firebase konsoli, w Google Cloud konsoli, i w Firebase CLI. Nazwa projektu nie jest widoczna w żadnej publicznie dostępnej usłudze ani zasobie Firebase lub Google Cloud . Służy tylko do łatwiejszego rozróżniania projektów.
Nazwę projektu możesz w każdej chwili edytować w górnym panelu ustawień
Numer projektu
Projekt Firebase (i powiązany z nim projekt Google Cloud) ma numer projektu. Jest to globalnie unikalny identyfikator kanoniczny projektu przypisany przez Google. Wykorzystuj ten identyfikator przy konfigurowaniu integracji lub wywołaniach API do Firebase, Google albo usług innych firm.
Numeru projektu nie można edytować. Jeśli usuniesz projekt, numer projektu też zostanie usunięty i nigdy nie będzie można go użyć w 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 w Firebase i Google Cloud. Gdy tworzysz projekt Firebase, usługa ta automatycznie przypisuje mu unikalny identyfikator, ale możesz go edytować podczas konfigurowania projektu. Ten identyfikator powinien być traktowany głównie jako praktyczny alias używany w odniesieniu do projektu.
Pliki i obiekty konfiguracyjne Firebase
Gdy zarejestrujesz aplikację w projekcie Firebase, konsola Firebaseudostępni plik konfiguracyjny Firebase (aplikacje na iOS/Androida) lub obiekt konfiguracyjny (aplikacje internetowe), który dodasz bezpośrednio do lokalnego katalogu aplikacji.
- W przypadku aplikacji na iOS 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 każdej chwili możesz pobrać plik lub obiekt konfiguracyjny Firebase aplikacji.
Plik lub obiekt konfiguracyjny Firebase łączy aplikację z określonym 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 komunikowania się z interfejsami API serwera Firebase oraz do powiązania danych klienta z projektem i aplikacją Firebase. Oto wymagane minimalne „opcje Firebase”:
Klucz interfejsu API: prosty zaszyfrowany ciąg znaków używany do wywoływania określonych 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 w Firebase i Google Cloud. Może się on wyświetlać w adresach URL lub nazwach niektórych zasobów Firebase, ale powinien być traktowany głównie jako praktyczny alias używany w odniesieniu do projektu. (przykładowa wartość:
myapp-project-123)Identyfikator aplikacji („AppID”): unikalny identyfikator aplikacji Firebase w Firebase w formacie specyficznym dla platformy:
- Aplikacje Firebase na iOS:
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 ani identyfikator aplikacji na Androida. - Aplikacje Firebase w sieci:
appId(przykładowa wartość:1:65211879909:web:3ae38ef1cdcb2e01fe5f0c).
- Aplikacje Firebase na iOS:
Zawartość pliku lub obiektu konfiguracyjnego Firebase jest uważana za publiczną, w tym identyfikator specyficzny dla platformy aplikacji (identyfikator pakietu Apple lub nazwa pakietu na Androida) oraz wartości specyficzne dla projektu Firebase, takie jak klucz interfejsu API, identyfikator projektu, Realtime Database adres URL i nazwa zasobnika Cloud Storage. W związku z tym, używaj Firebase Security Rules , aby chronić dane i pliki w Realtime Database, Cloud Firestore, i Cloud Storage.
W przypadku projektów open source na ogół nie zalecamy umieszczania pliku ani obiektu konfiguracyjnego Firebase aplikacji w systemie 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 (za pomocą własnego pliku lub obiektu konfiguracyjnego Firebase).
Ogólne limity projektów, aplikacji i witryn Firebase
Oto kilka ogólnych limitów projektów, aplikacji i witryn Firebase:
Liczba projektów na konto Google (adres e-mail)
- Abonament Spark: limit tworzenia projektów jest ograniczony do niewielkiej liczby projektów (zwykle około 5–10).
- Abonament Blaze: limit tworzenia projektów jest nadal ograniczony, ale może się zwiększyć po połączeniu Cloud Billing konta, które jest w dobrej kondycji.
Pamiętaj o tych ograniczeniach dotyczących limitu tworzenia projektów:
- Ten limit nie jest specyficzny dla Firebase. Limity Firebase dotyczące liczby projektów są takie same jak w Google Cloud.
- W rzadkich przypadkach możesz poprosić o zwiększenie limitu projektów.
- Całkowite usunięcie projektu wymaga 30 dni i jest wliczane do limitu projektów do momentu całkowitego usunięcia projektu.
Dowiedz się więcej o zalecanych przez Firebase ogólnych sprawdzonych metodach konfigurowania projektów Firebase.
Liczba aplikacji na projekt
Firebase ogranicza łączną liczbę aplikacji Firebase w projekcie Firebase do 30.
Upewnij się, że wszystkie aplikacje Firebase w jednym projekcie Firebase są wariantami platformy tej samej aplikacji z perspektywy użytkownika. Więcej informacji o obsłudze wielu najemców znajdziesz w naszych dokumentach dotyczących sprawdzonych metod.
Więcej informacji o limicie aplikacji na projekt znajdziesz w najczęstszych pytaniach.
Liczba witryn na projektHosting
Funkcja obsługi wielu witryn w Hostingu Firebase obsługuje maksymalnie 36 witryn na projekt.Firebase Hosting
Uruchamianie aplikacji
- W konsoli Google Cloud skonfiguruj budżetowe alerty dla swojego projektu.
- Monitoruj panel informacyjny Wykorzystanie i płatności w konsoli Firebase aby uzyskać ogólny obraz wykorzystania projektu w różnych usługach Firebase.
- Zapoznaj się z listą kontrolną uruchamiania Firebase.