Na tej stronie znajdziesz krótkie omówienie kilku ważnych pojęć związanych z projektami Firebase. Jeśli są dostępne, kliknij linki, aby uzyskać bardziej szczegółowe informacje o funkcjach, usługach, narzędziach i sprawdzonych metodach.
Relacje między projektami w Firebase, aplikacjami i usługami
Projekt w Firebase to element najwyższego poziomu w Firebase. W projekcie możesz zarejestrować aplikacje na Apple, Androida lub 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 w Firebase
Ten diagram przedstawia podstawową hierarchię projektu w Firebase. Oto najważniejsze relacje:
Projekt w Firebase jest jak kontener na wszystkie aplikacje oraz zasoby i usługi udostępnione dla projektu.
Projekt w Firebase może mieć zarejestrowaną co najmniej 1 aplikację w Firebase (np. wersje aplikacji na iOS i Androida lub wersje bezpłatną i płatną).
Wszystkie aplikacje w Firebase zarejestrowane w tym samym projekcie w Firebase udostępniają i mają dostęp do tych samych zasobów i usług udostępnionych dla projektu. Oto przykłady:
Wszystkie aplikacje w Firebase zarejestrowane w tym samym projekcie w Firebase korzystają z tych samych backendów, takich jak Firebase Hosting, Authentication, Realtime Database, Cloud Firestore, Cloud Storage i Cloud Functions.
Wszystkie aplikacje w Firebase zarejestrowane w tym samym projekcie w Firebase są powiązane z tą samą usługą w Google Analytics, w której każda aplikacja w Firebase jest osobnym strumieniem danych.
Zależność między projektami w Firebase a Google Cloud
Gdy tworzysz nowy projekt w Firebase, w rzeczywistości tworzysz za kulisami projekt Google Cloud. Możesz nawet najpierw utworzyć projekt Google Cloud, a potem dodać do niego Firebase. Projekt Google Cloud możesz traktować jako wirtualny kontener na dane, kod, konfigurację i usługi.
Pamiętaj, że w przypadku wszystkich projektów w Firebase usługa Firebase automatycznie dodaje do projektu etykietę firebase:enabled na stronie Uprawnienia i administracja > Etykiety w konsoli Google Cloud. Więcej informacji o tej etykiecie znajdziesz w najczęstszych pytaniach.
Projekt Firebase jest projektem Google Cloud, więc:
Możesz uzyskać dostęp do projektu i korzystać z niego w konsoli Firebase, a także w konsoli Google Cloud i konsoli interfejsów API Google.
Możesz korzystać z projektu za pomocą interfejsu wiersza poleceń Firebase, gcloud CLI i dowolnego zasobu Terraform od Google.
W projekcie możesz używać usług i interfejsów API zarówno z Firebase, jak i z Google Cloud.
Uprawnienia i role uprawnień w projekcie są współdzielone między Firebase i Google Cloud. Każdy dostęp, jaki członek projektu (czyli podmiot zabezpieczeń) ma do projektu Google Cloud, będzie też obowiązywać w projekcie Firebase (i na odwrót).
Płatności za projekt są współdzielone przez Firebase i Google Cloud. Jeśli w projekcie Google Cloud są włączone płatności, Twój projekt w Firebase będzie objęty abonamentem Blaze Firebase z płatnością według wykorzystania.
Unikalne identyfikatory projektu (takie jak numer projektu i identyfikator projektu) są udostępniane Firebase i Google Cloud.
Każda hierarchia zasobów zastosowana do projektu Google Cloud (np. organizacja, foldery itp.) będzie też stosowana do projektu w Firebase.
Usunięcie projektu spowoduje usunięcie go z Firebase i Google Cloud.
Usunięcie lub zmodyfikowanie zasobu lub danych w projekcie ma zastosowanie zarówno w Firebase, jak i w Google Cloud.
Konfigurowanie projektu w Firebase i rejestrowanie aplikacji
Projekt w Firebase możesz skonfigurować i zarejestrować aplikacje w konsoli Firebase (lub w przypadku zaawansowanych zastosowań za pomocą interfejsu Firebase Management REST API lub interfejsu wiersza poleceń Firebase). Podczas konfigurowania projektu i rejestrowania aplikacji musisz podjąć pewne decyzje organizacyjne i dodać do projektów lokalnych informacje o konfiguracji Firebase.
W przypadku aplikacji produkcyjnych musisz skonfigurować przejrzysty proces programowania, który zwykle obejmuje korzystanie z kilku środowisk. Zapoznaj się z naszą dokumentacją na temat procesów deweloperskich, w tym z ogólnymi sprawdzonymi metodami i ogólnymi wytycznymi dotyczącymi bezpieczeństwa, aby dowiedzieć się, jak skonfigurować projekty w Firebase i zarejestrować aplikacje w celu utworzenia procesu deweloperskiego.
Interakcja z projektem w Firebase
Oprócz pakietów SDK usług możesz bezpośrednio korzystać z projektu w Firebase za pomocą różnych narzędzi i interfejsów.
Konsola Firebase
Konsola Firebase zapewnia najbardziej rozbudowane środowisko do zarządzania usługami, aplikacjami i ustawieniami na poziomie projektu Firebase.
W panelu po lewej stronie konsoli znajdziesz listę usług Firebase uporządkowanych według kategorii najwyższego poziomu. U góry panelu po lewej stronie kliknij
Na środku konsoli wyświetlane są przyciski, które uruchamiają przepływy pracy konfiguracji umożliwiające rejestrowanie różnych typów aplikacji. Gdy zaczniesz korzystać z Firebase, główny obszar konsoli zmieni się w panel, na którym będą wyświetlane statystyki dotyczące używanych przez Ciebie usług.
Pamiętaj, że projekt w Firebase jest też projektem Google Cloud, więc może się okazać, że różne zadania lub usługi wymagają użycia konsoli Google Cloud zamiast konsoli Firebase.
Interfejs wiersza poleceń Firebase (narzędzie wiersza poleceń)
Firebase oferuje też Firebase CLI do konfigurowania konkretnych usług Firebase i zarządzania nimi, takich jak Firebase Hosting, Cloud Functions for Firebase i Firebase Extensions.
Po zainstalowaniu interfejsu wiersza poleceń Firebase masz dostęp do globalnego polecenia firebase. Użyj interfejsu wiersza poleceń Firebase, aby połączyć lokalny katalog aplikacji z projektem w Firebase, a następnie wdrażać nowe wersje treści hostowanych w Hosting Firebase lub aktualizacje Funkcji.
Interfejs Firebase Management REST API
Za pomocą interfejsu Firebase Management REST API możesz automatycznie zarządzać projektem w Firebase. Możesz na przykład automatycznie zarejestrować aplikację w projekcie lub wyświetlić listę aplikacji, które są już zarejestrowane (iOS+ | Android | sieć).
Identyfikatory projektów w Firebase
Projekt w Firebase można zidentyfikować w backendzie Firebase i w różnych interfejsach dla deweloperów za pomocą różnych identyfikatorów, takich jak nazwa projektu, numer projektu i identyfikator projektu.
Nazwa projektu
Podczas tworzenia projektu podajesz jego nazwę. Ten identyfikator to nazwa wewnętrzna projektu w konsoli Firebase, konsoli Google Cloud i interfejsie wiersza poleceń Firebase. Nazwa projektu nie jest widoczna w żadnej publicznie dostępnej usłudze, zasobie ani produkcie Firebase lub Google Cloud. Służy jedynie do łatwiejszego rozróżniania wielu projektów.
Nazwę projektu możesz w każdej chwili zmienić w górnym panelu
Numer projektu
Projekt w Firebase (i powiązany z nim projekt Google Cloud) ma numer projektu. Jest to globalnie unikalny identyfikator kanoniczny przypisany przez Google do projektu. Używaj tego identyfikatora podczas konfigurowania integracji lub wywoływania interfejsów API Firebase, Google lub usług innych firm.
Nie możesz edytować numeru projektu. Jeśli usuniesz projekt, usunięty zostanie również jego numer, którego nie będzie można ponownie użyć w żadnym innym projekcie.
Identyfikator projektu
Projekt w Firebase (i powiązany z nim projekt Google Cloud) ma identyfikator projektu. Jest to zdefiniowany przez użytkownika unikalny identyfikator projektu w Firebase i Google Cloud. Gdy tworzysz projekt w Firebase, Firebase automatycznie przypisuje mu unikalny identyfikator, ale możesz go zmienić podczas konfigurowania projektu. Ten identyfikator powinien być traktowany jako wygodny alias do odwoływania się do projektu.
Pliki i obiekty konfiguracji Firebase
Gdy zarejestrujesz aplikację w projekcie Firebase, konsola Firebase udostępni plik konfiguracji Firebase (aplikacje na Apple/Androida) lub obiekt konfiguracji (aplikacje internetowe), który dodasz bezpośrednio do lokalnego katalogu aplikacji.
- W przypadku aplikacji Apple dodaj plik konfiguracji
GoogleService-Info.plist. - W przypadku aplikacji na Androida dodajesz plik konfiguracji
google-services.json. - W przypadku aplikacji internetowych dodajesz obiekt konfiguracji Firebase.
W każdej chwili możesz pobrać plik lub obiekt konfiguracji Firebase aplikacji.
Plik lub obiekt konfiguracji Firebase wiąże aplikację z konkretnym projektem Firebase i jego zasobami (bazami danych, zasobnikami na dane itp.). Konfiguracja obejmuje „opcje Firebase”, czyli parametry wymagane przez Firebase i usługi Google do komunikacji z interfejsami API serwera Firebase oraz do powiązania danych klienta z projektem w Firebase i aplikacją w Firebase.
Oto minimalne wymagane „opcje Firebase”:
Klucz interfejsu API Firebase: unikalny ciąg znaków używany do kierowania żądań do projektu w Firebase. Ten klucz interfejsu API powinien być ograniczony do użycia tylko z interfejsami API związanymi z Firebase. (przykładowa wartość:
AIzaSyDOCAbC123dEf456GhI789jKl012-MnO)Identyfikator projektu Firebase: zdefiniowany przez użytkownika globalnie unikalny identyfikator projektu w Firebase i Google Cloud. Ten identyfikator może pojawiać się w adresach URL lub nazwach niektórych zasobów Firebase, ale ogólnie należy go traktować jako wygodny alias do odwoływania się do projektu. (przykładowa wartość:
myapp-project-123)Identyfikator aplikacji Firebase („Identyfikator aplikacji”): unikalny identyfikator aplikacji w Firebase w całym Firebase i Google Cloud w formacie zależnym od platformy:
- Aplikacje Firebase na urządzenia Apple:
GOOGLE_APP_ID(przykładowa wartość:1:1234567890:ios:321abc456def7890)
Nie jest to identyfikator pakietu Apple. - Aplikacje Firebase na Androida:
mobilesdk_app_id(przykładowa wartość:1:1234567890:android:321abc456def7890)
Nie jest to nazwa pakietu na Androida ani identyfikator aplikacji na Androida. - Aplikacje internetowe Firebase:
appId(przykładowa wartość:1:65211879909:web:3ae38ef1cdcb2e01fe5f0c)
- Aplikacje Firebase na urządzenia Apple:
Zawartość pliku konfiguracyjnego lub obiektu konfiguracji Firebase jest uważana za publiczną, w tym identyfikator aplikacji na danej platformie (identyfikator pakietu Apple lub nazwa pakietu na Androida) oraz wartości dotyczące projektu w Firebase, takie jak klucz interfejsu API, identyfikator projektu, adres URL Realtime Database i nazwa zasobnika Cloud Storage. W związku z tym używaj Firebase Security Rules do ochrony swoich danych i plików w Realtime Database, Cloud Firestore i Cloud Storage.
W przypadku projektów open source zwykle nie zalecamy dołączania pliku lub obiektu konfiguracji Firebase aplikacji do systemu kontroli wersji, ponieważ w większości przypadków użytkownicy powinni tworzyć własne projekty w Firebase i kierować swoje aplikacje do własnych zasobów Firebase (za pomocą własnego pliku lub obiektu konfiguracji Firebase).
Ogólne limity dotyczące projektów w Firebase, aplikacji i witryn
Oto kilka ogólnych limitów dotyczących projektów w Firebase, aplikacji i witryn:
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 zostać zwiększony po połączeniu z kontem Cloud Billing o dobrej opinii.
Pamiętaj o tych kwestiach dotyczących limitu tworzenia projektów:
- Ten limit nie dotyczy tylko Firebase. Limity Firebase dotyczące projektów są takie same jak w przypadku Google Cloud.
- W rzadkich przypadkach, gdy jest to konieczne, możesz poprosić o zwiększenie limitu projektów.
- Całkowite usunięcie projektu trwa 30 dni i do tego czasu projekt jest wliczany do limitu projektów.
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 w Firebase w projekcie w Firebase do 30.
Upewnij się, że wszystkie aplikacje w Firebase w jednym projekcie w Firebase są z perspektywy użytkownika wariantami tej samej aplikacji na różne platformy. Więcej informacji o wielu najemcach znajdziesz w dokumentacji dotyczącej sprawdzonych metod.
Więcej informacji o limicie aplikacji na projekt znajdziesz w odpowiedziach na najczęstsze pytania.
Liczba witryn Hosting na projekt
Funkcja wielu witryn Firebase Hosting obsługuje maksymalnie 36 witryn na projekt.
Uruchamianie aplikacji
- Skonfiguruj alerty dotyczące budżetu dla projektu w konsoli Google Cloud.
- Monitoruj panel Korzystanie i rozliczenia w konsoli Firebase, aby uzyskać ogólny obraz wykorzystania projektu w różnych usługach Firebase.
- Zapoznaj się z listą kontrolną dotyczącą uruchamiania Firebase.