Ta strona zawiera 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.
Związek między projektami, aplikacjami i usługami Firebase
Projekt Firebase jest najwyższym elementem w Firebase. W projekcie możesz zarejestrować aplikacje na urządzenia z systemem Apple, Android lub aplikacje internetowe. Po zarejestrowaniu aplikacji w Firebase możesz dodać pakiety SDK Firebase dla 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 na danej platformie:
iOS+ | Android |
sieć | Unity | C++ |
Flutter.
Hierarchia projektów Firebase
Ten diagram przedstawia podstawową hierarchię projektu Firebase. Oto najważniejsze relacje:
Projekt Firebase to kontener na wszystkie aplikacje oraz zasoby i usługi udostępnione w ramach projektu.
W projekcie Firebase może być zarejestrowanych co najmniej 1 aplikacja Firebase (np. wersja na iOS i Androida lub bezpłatna 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 tego projektu. Oto przykłady:
Wszystkie aplikacje Firebase zarejestrowane w tym samym projekcie Firebase korzystają z tych samych backendów: 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ą w Google Analytics, a każda aplikacja Firebase to osobny strumień danych w tej usłudze.
Związek między projektami Firebase a Google Cloud
Gdy tworzysz nowy projekt Firebase, faktycznie tworzysz w tle 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 Firebase Firebase automatycznie dodaje etykietę firebase:enabled na stronie Etykiety projektu w konsoli Google Cloud. Więcej informacji o tej etykiecie znajdziesz w najczęstszych pytaniach.
Ponieważ projekt Firebase jest projektem Google Cloud:
Dostęp do projektu i możliwość interakcji z nim masz w konsoli Firebase, a także w konsoli Google Cloud i Konsoli interfejsów API Google.
Możesz wchodzić w interakcje z projektem za pomocą interfejsu wiersza poleceń Firebase, gcloud CLIoraz dowolnego zasobu Terraform od Google.
W projekcie możesz używać usług i interfejsów API zarówno Firebase, jak i Google Cloud.
Uprawnienia i role w usłudze IAM dotyczące projektu są udostępniane w Firebase i Google Cloud. Dostęp członka projektu (czyli głównego użytkownika) do projektu Google Cloud będzie również dotyczył Twojego projektu Firebase (i odwrotnie).
Płatności za projekt są wspólne dla Firebase i Google Cloud. Jeśli w projekcie Google Cloud płatności są włączone, projekt Firebase będzie korzystać z abonamentu Blaze (płatność według zużycia zasobów).
Unikalne identyfikatory projektu (np. numer projektu i identyfikator projektu) są wspólne dla Firebase i Google Cloud.
Każda hierarchia zasobów zastosowana w projekcie Google Cloud (np. organizacja, foldery itp.) będzie też obowiązywać w Twoim projekcie Firebase.
Usunięcie projektu spowoduje jego usunięcie z Firebase i Google Cloud.
Usunięcie lub zmodyfikowanie zasobu lub danych w projekcie ma zastosowanie w Firebase i Google Cloud.
Konfigurowanie projektu Firebase i rejestrowanie aplikacji
Projekt Firebase i aplikacje możesz skonfigurować w konsoli Firebase (lub w zaawansowanych zastosowaniach za pomocą interfejsu Firebase Management API REST lub Firebase wiersza poleceń). Podczas konfigurowania projektu i rejestrowania aplikacji musisz podjąć pewne decyzje organizacyjne i dodać do projektów lokalnych informacje o konfiguracji dotyczące Firebase.
W przypadku aplikacji produkcyjnych musisz skonfigurować przejrzysty proces programowania, który zwykle wymaga korzystania z kilku środowisk. Zapoznaj się z naszą dokumentacją na temat procesów dewelopera, w tym ogólnych sprawdzonych metod i ogólnych wytycznych dotyczących bezpieczeństwa dotyczących konfigurowania projektów Firebase i rejestrowania aplikacji w celu tworzenia procesu programowania.
Interakcja z projektem Firebase
Oprócz pakietów SDK usług możesz bezpośrednio wchodzić w interakcje z projektem Firebase za pomocą różnych narzędzi i interfejsów.
Konsola Firebase
Konsola Firebase zapewnia najbogatsze środowisko do zarządzania usługami, aplikacjami i ustawieniami na poziomie projektu w Firebase.
W panelu po lewej stronie konsoli znajdziesz listę usług Firebase uporządkowaną według kategorii najwyższego poziomu. Aby otworzyć ustawienia projektu, w górnej części panelu po lewej stronie kliknij . Ustawienia projektu obejmują integracje, uprawnienia dostępu i rozliczenia.
W środku konsoli znajdują się przyciski, które umożliwiają uruchamianie procesów konfiguracji służących do rejestrowania różnych typów aplikacji. Gdy zaczniesz korzystać z Firebase, główna część konsoli zmieni się w panel, który wyświetla statystyki dotyczące używanych przez Ciebie usług.
Pamiętaj, że projekt Firebase jest też projektem Google Cloud, więc do wykonywania niektórych zadań lub korzystania z różnych usług może być wymagana konsola Google Cloud zamiast konsoli Firebase.
Firebase interfejs wiersza poleceń (narzędzie wiersza poleceń)
Firebase udostępnia też wiersz poleceń Firebase do konfigurowania i zarządzania konkretnymi usługami Firebase, takimi jak Firebase Hosting, Cloud Functions for Firebase i Firebase Extensions.
Po zainstalowaniu interfejsu wiersza poleceń masz dostęp do globalnego polecenia firebase. Użyj wiersza poleceń, aby połączyć lokalny katalog aplikacji z projektem Firebase, a potem wdróż nowe wersje treści hostowanych w Firebase lub aktualizacje funkcji.
Firebase Management REST API
Za pomocą interfejsu Firebase Management API REST możesz zarządzać projektem Firebase za pomocą kodu. Możesz na przykład zarejestrować aplikację w projekcie za pomocą kodu lub wyświetlić listę zarejestrowanych już aplikacji (iOS+ | Android | sieć).
Identyfikatory projektu Firebase
Projekt Firebase można zidentyfikować w backendzie Firebase i w różnych interfejsach dla programistów za pomocą różnych identyfikatorów, takich jak nazwa projektu, numer projektu i identyfikator projektu.
Nazwa projektu
Podczas tworzenia projektu musisz podać jego nazwę. Jest to nazwa wewnętrzna projektu w Firebase konsoli, Google Cloud konsoli i Firebase interfejsu wiersza poleceń. Nazwa projektu nie jest widoczna w żadnym publicznym produkcie, usłudze ani zasobie Firebase ani Google Cloud. Służy ona tylko do ułatwienia rozróżniania wielu projektów.
Nazwę projektu możesz edytować w każdej chwili w ustawieniach projektu w konsoli Firebase. Nazwa projektu jest wyświetlana w górnym panelu.
Numer projektu
Projekt Firebase (i powiązany z nim projektGoogle Cloud) ma numer projektu. Jest to przypisany przez Google unikalny kanoniczny identyfikator projektu na całym świecie. Wykorzystuj ten identyfikator przy konfigurowaniu integracji lub wywołaniach interfejsu API do Firebase, Google lub usług innych firm.
Nie możesz edytować numeru projektu. Jeśli usuniesz projekt, jego numer zostanie również usunięty i nie będzie można go użyć w żadnym innym projekcie.
Identyfikator projektu
Projekt Firebase (i jego powiązany projekt Google Cloud) ma identyfikator projektu. To zdefiniowany przez użytkownika unikalny identyfikator projektu w całym Firebase i Google Cloud. Gdy tworzysz projekt Firebase, Firebase automatycznie przypisuje mu unikalny identyfikator, ale możesz go zmienić podczas konfigurowania projektu. Ten identyfikator powinien być traktowany głównie jako praktyczny alias używany w odniesieniu do projektu.
Pliki i obiekty konfiguracji Firebase
Gdy zarejestrujesz aplikację w projekcie Firebase, konsola Firebase udostępni plik konfiguracji Firebase (aplikacje na urządzenia z systemem Apple lub Android) lub obiekt konfiguracji (aplikacje internetowe), który możesz dodać bezpośrednio do lokalnego katalogu aplikacji.
- W przypadku aplikacji Apple dodaj plik konfiguracji
GoogleService-Info.plist. - W przypadku aplikacji na Androida dodaj plik konfiguracji
google-services.json. - W przypadku aplikacji internetowych dodaj obiekt konfiguracji Firebase.
W każdej chwili możesz pobrać plik konfiguracji lub obiekt Firebase aplikacji.
Plik lub obiekt konfiguracji Firebase łączy aplikację z określonym projektem Firebase i jego zasobami (bazami danych, kontenerami magazynu itp.). Konfiguracja obejmuje „opcje Firebase”, czyli parametry wymagane przez usługi Firebase i Google do komunikacji z interfejsami API serwera Firebase oraz do kojarzenia danych klienta z projektem i aplikacją Firebase. Oto wymagane minimalne „opcje Firebase”:
Klucz interfejsu API: prosty zaszyfrowany ciąg znaków używany w przypadku wywoływania określonych interfejsów API, które nie wymagają dostępu do prywatnych danych użytkownika (wartość przykładowa:
AIzaSyDOCAbC123dEf456GhI789jKl012-MnO).Identyfikator projektu: zdefiniowany przez użytkownika unikalny identyfikator projektu we wszystkich usługach 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. (wartość przykładowa:
myapp-project-123)Identyfikator aplikacji („AppID”): unikalny identyfikator aplikacji Firebase w całym Firebase w formacie odpowiednim dla danej platformy:
- Aplikacje Firebase na urządzenia Apple:
GOOGLE_APP_ID(wartość przykładowa:1:1234567890:ios:321abc456def7890)
To nie jest identyfikatorem pakietu Apple. - Aplikacje Firebase na Androida:
mobilesdk_app_id(wartość przykładowa:1:1234567890:android:321abc456def7890)
To nie jest nazwa pakietu ani identyfikator aplikacji na Androida. - Aplikacje internetowe Firebase:
appId(wartość przykładowa:1:65211879909:web:3ae38ef1cdcb2e01fe5f0c)
- Aplikacje Firebase na urządzenia Apple:
Treści pliku lub obiektu konfiguracji Firebase są uważane za publiczne, w tym identyfikator aplikacji na danej platformie (identyfikator pakietu Apple lub nazwa pakietu na Androida) oraz wartości specyficzne dla projektu Firebase, takie jak klucz interfejsu API, identyfikator projektu, URL Realtime Database i nazwa zasobnika Cloud Storage. W związku z tym użyj aplikacji Firebase Security Rules, aby chronić dane i pliki w Realtime Database, Cloud Firestore i Cloud Storage.
W przypadku projektów open source nie zalecamy umieszczania w kontroli wersji pliku konfiguracji Firebase ani obiektu Firebase aplikacji, ponieważ w większości przypadków użytkownicy powinni tworzyć własne projekty Firebase i kierować swoje aplikacje na własne zasoby Firebase (za pomocą własnego pliku konfiguracji Firebase lub obiektu).
Ogólne limity dotyczące projektów, aplikacji i witryn Firebase
Oto kilka ogólnych limitów dotyczących projektów, aplikacji i witryn Firebase:
Liczba projektów na konto
- Plan cen Spark – limit tworzenia projektów jest ograniczony do mniejszej liczby projektów (zwykle 5–10).
- Plan Blaze – limit tworzenia projektów na konto zwiększa się znacznie, dopóki powiązane konto Cloud Billing ma dobrą reputację.
Limit dotyczący limitu tworzenia projektów rzadko stanowi problem dla większości deweloperów, ale w razie potrzeby możesz poprosić o zwiększenie limitu projektów.
Pamiętaj, że całkowite usunięcie projektu wymaga 30 dni i wlicza się do limitu projektów do momentu jego całkowitego usunięcia.
Liczba aplikacji na projekt
Firebase ogranicza łączną liczbę aplikacji Firebase w projekcie Firebase do 30.
Upewnij się, że wszystkie aplikacje Firebase w ramach jednego projektu Firebase są z perspektywy użytkownika wariantami tej samej aplikacji na różne platformy. Więcej informacji o wielodzierżawstwie znajdziesz w naszych sprawdzonych metodach.
Więcej informacji o limieniu aplikacji na projekt znajdziesz w odpowiedziach na najczęstsze pytania.
Liczba witryn Hosting na projekt
Funkcja Firebase Hostingwitryn obsługuje maksymalnie 36 witryn na projekt.
Uruchamianie aplikacji
- W konsoli Google Cloud skonfiguruj alerty dotyczące budżetu dla swojego projektu.
- Aby uzyskać ogólny obraz wykorzystania projektu w różnych usługach Firebase, monitoruj panel Dane i rozliczenia w konsoli Firebase.
- Przejrzyj listę kontrolną przed wdrożeniem Firebase.