Save the date - Google I/O returns May 18-20. Register to get the most out of the digital experience: Build your schedule, reserve space, participate in Q&As, earn Google Developer profile badges, and more. Register now
Ta strona została przetłumaczona przez Cloud Translation API.
Switch to English

Poznaj projekty Firebase

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, a nawet innych platformach. U dołu tej strony znajduje się lista ogólnych sprawdzonych metod dotyczących projektów Firebase.

Relacje między projektami, aplikacjami i produktami Firebase

Projekt Firebase to jednostka najwyższego poziomu w Firebase. W projekcie tworzysz aplikacje Firebase, rejestrując aplikacje na iOS, Androida lub aplikacje 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 lub Zdalna konfiguracja.

Więcej szczegółowych informacji na temat tego procesu można znaleźć w przewodnikach dla początkujących ( iOS | Android | web | Unity | C ++ ).

Związek między projektami Firebase a Google Cloud

Tworząc nowy projekt Firebase w konsoli Firebase, tak naprawdę tworzysz projekt Google Cloud za kulisami. Możesz myśleć o projekcie Google Cloud jak o wirtualnym kontenerze na dane, kod, konfigurację i usługi. Projekt Firebase to projekt Google Cloud, który ma dodatkowe konfiguracje i usługi specyficzne dla Firebase. Możesz nawet najpierw utworzyć projekt Google Cloud, a później dodać do projektu Firebase.

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ń, przez Firebase Management REST API lub Firebase CLI ). Podczas konfigurowania projektu i rejestrowania aplikacji musisz podjąć pewne decyzje organizacyjne i dodać informacje konfiguracyjne specyficzne dla Firebase do swoich projektów lokalnych.

Przed skonfigurowaniem projektu i zarejestrowaniem aplikacji zapoznaj się z ogólnymi najlepszymi praktykami na poziomie projektu (na dole tej strony).

Nazwa projektu

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

Nazwę projektu możesz edytować 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 unikatowy, globalny identyfikator kanoniczny projektu. Użyj tego identyfikatora podczas konfigurowania integracji i / lub wykonywania wywołań API do usług Firebase, Google lub innych firm.

Wywołania API i numer projektu

W przypadku wielu wywołań interfejsu API należy podać unikatowy identyfikator projektu. Chociaż wiele interfejsów API akceptuje identyfikator projektu , zaleca się używanie numeru projektu do wykonywania wywołań interfejsu API do usług Firebase, Google lub innych firm.

Dowiedz się więcej o używaniu identyfikatorów projektów, zwłaszcza numeru projektu, w standardzie Google AIP 2510 .

Znajdź numer projektu

  • Konsola Firebase: kliknij projektu . Numer projektu jest wyświetlany w górnym okienku.

  • Interfejs wiersza polecenia Firebase: uruchom firebase projects:list . Numer projektu jest wyświetlany wraz ze wszystkimi projektami Firebase powiązanymi z Twoim kontem.

  • Firebase Management REST API: Call projects.list . Treść odpowiedzi zawiera numer projektu w obiekcie FirebaseProject .

Identyfikator projektu

Projekt Firebase (i powiązany z nim projekt Google Cloud ) ma identyfikator projektu . To jest zdefiniowany przez użytkownika unikalny identyfikator projektu we wszystkich Firebase i Google Cloud. Gdy tworzysz projekt Firebase, Firebase automatycznie przypisuje do projektu unikalny identyfikator, ale możesz go edytować podczas konfiguracji projektu. Ten identyfikator powinien być ogólnie traktowany jako wygodny alias do odwoływania się do projektu.

Jeśli usuniesz projekt, identyfikator projektu również zostanie usunięty i nie będzie można go już nigdy użyć w żadnym innym projekcie.

Zasoby Firebase i identyfikator projektu

Identyfikator projektu jest wyświetlany w publicznie widocznych zasobach Firebase, na przykład:

  • Domyślna subdomena hostingu - PROJECT_ID .web.app i PROJECT_ID .firebaseapp.com
  • Domyślny adres URL bazy danych czasu rzeczywistego - PROJECT_ID -default-rtdb.firebaseio.com lub PROJECT_ID -default-rtdb. REGION_CODE .firebasedatabase.app
  • Domyślna nazwa PROJECT_ID .appspot.com Cloud Storage - PROJECT_ID .appspot.com

Dla wszystkich wyżej wymienionych zasobów można tworzyć instancje inne niż domyślne. Publicznie widoczne nazwy wartości innych niż domyślne można w pełni dostosować. Możesz połączyć domeny niestandardowe z witryną hostowaną przez Firebase, odłamać bazę danych czasu rzeczywistego i utworzyć wiele zasobników Cloud Storage (odwiedź stronę Wprowadzenie do konkretnej platformy).

Interfejs wiersza polecenia Firebase i identyfikator projektu

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 , trzeba zdać --project flagę z firebase poleceń do komunikowania który Firebase projekt chcesz współpracować z.

Możesz także skonfigurować alias projektu dla każdego projektu Firebase, aby nie trzeba było pamiętać identyfikatorów projektów.

Wywołania API i identyfikator projektu

W przypadku wielu wywołań interfejsu API należy podać unikatowy identyfikator projektu. Chociaż wiele interfejsów API akceptuje identyfikator projektu, zaleca się używanie numeru projektu do wykonywania wywołań interfejsu API do usług Firebase, Google lub innych firm.

Dowiedz się więcej o używaniu identyfikatorów projektów, zwłaszcza numeru projektu, w standardzie Google AIP 2510 .

Znajdź identyfikator projektu

  • Konsola Firebase: kliknij projektu . Identyfikator projektu jest wyświetlany w górnym okienku.

  • Interfejs wiersza polecenia Firebase: uruchom firebase projects:list . Identyfikator projektu jest wyświetlany wraz ze wszystkimi projektami Firebase powiązanymi z Twoim kontem.

  • Firebase Management REST API: Call projects.list . Treść odpowiedzi zawiera identyfikator projektu w obiekcie FirebaseProject .

Pliki konfiguracyjne i obiekty Firebase

Gdy rejestrujesz aplikację w projekcie Firebase, konsola Firebase udostępnia plik konfiguracyjny Firebase (aplikacje na iOS / Androida) lub obiekt konfiguracyjny (aplikacje internetowe), który dodajesz 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 dowolnym momencie możesz pobrać plik konfiguracyjny lub obiekt Firebase aplikacji .

Plik konfiguracyjny lub obiekt Firebase wiąże 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 kojarzenia 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 generalnie powinien być traktowany jako wygodny alias do odwoływania się 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 na iOS: GOOGLE_APP_ID (przykładowa wartość: 1:1234567890:ios:321abc456def7890 )
      To nie jest identyfikator pakietu Apple.
    • Aplikacje mobilesdk_app_id Androida: mobilesdk_app_id (przykładowa wartość: 1:1234567890:android:321abc456def7890 )
      To nie jest nazwa pakietu na Androida ani identyfikator aplikacji na Androida.
    • Aplikacje internetowe appId : appId (przykładowa wartość: 1:65211879909:web:3ae38ef1cdcb2e01fe5f0c )

Zawartość pliku konfiguracyjnego lub obiektu Firebase jest uznawana za publiczną, w tym identyfikator aplikacji (identyfikator pakietu iOS lub nazwa pakietu Androida) i 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 Realtime Database , Cloud Firestore i Cloud Storage .

W przypadku projektów typu open source zasadniczo nie zalecamy umieszczania pliku konfiguracyjnego lub obiektu Firebase aplikacji w 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łasnej konfiguracji Firebase plik lub obiekt).

Zarządzanie projektem Firebase

Zapoznaj się z ogólnymi sprawdzonymi metodami na poziomie projektu (na dole tej strony), aby poznać kwestie, które mogą wpłynąć na sposób zarządzania projektem Firebase.

Narzędzia do zarządzania projektem

Konsola Firebase

Konsola Firebase oferuje najbogatsze środowisko do zarządzania produktami i aplikacjami Firebase oraz ustawieniami 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. U góry panelu po lewej stronie uzyskaj dostęp do ustawień projektu, klikając . Ustawienia projektu obejmują integracje , uprawnienia dostępu i rozliczenia .

Środek konsoli wyświetla przyciski, które uruchamiają konfiguracyjne przepływy pracy, aby zarejestrować różne typy aplikacji. Po rozpoczęciu korzystania z Firebase główny obszar konsoli zmienia się w pulpit nawigacyjny, który wyświetla statystyki używanych produktów.

Firebase CLI (narzędzie wiersza poleceń)

Firebase oferuje również interfejs wiersza polecenia Firebase do konfigurowania określonych produktów Firebase, takich jak Hosting Firebase i Funkcje w chmurze dla Firebase, oraz do zarządzania nimi.

Po zainstalowaniu 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 wdróż nowe wersje zawartości hostowanej przez Firebase lub aktualizacje funkcji.

Firebase Management REST API

Korzystając z interfejsu Firebase Management REST API , 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 | sieć ).

Ogólne najlepsze praktyki

Dodawanie aplikacji do projektu

Upewnij się, że wszystkie aplikacje w projekcie są wariantami platformy tej samej aplikacji z perspektywy użytkownika końcowego. Zaleca się zarejestrowanie wersji tej samej aplikacji lub gry na iOS, Androida i wersję internetową w tym samym projekcie Firebase. Wszystkie aplikacje w projekcie zazwyczaj współużytkują te same zasoby Firebase (baza danych, zasobniki pamięci itp.).

Jeśli masz wiele wariantów kompilacji z różnymi identyfikatorami pakietów na iOS lub zdefiniowanymi nazwami pakietów na Androida, możesz zarejestrować każdy wariant w osobnym projekcie Firebase. Jeśli jednak masz warianty, które współużytkują te same zasoby Firebase, zarejestruj je w tym samym projekcie Firebase.

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

  • Liczba projektów na konto

    • Darmowy plan Spark - limit tworzenia projektów jest ograniczony do mniejszej liczby projektów (zwykle około 5-10).
    • Płatne plany - limit tworzenia projektów na konto rozliczeniowe znacznie wzrasta, o ile powiązane konto rozliczeniowe w chmurze ma dobrą opinię.

    Większość deweloperów rzadko martwi się limitem tworzenia projektów, ale w razie potrzeby możesz poprosić o zwiększenie limitu projektów .

    Należy pamiętać, że całkowite usunięcie projektu zajmuje 30 dni i wlicza się do limitu projektu, dopóki projekt nie zostanie całkowicie usunięty.

  • Liczba aplikacji na projekt

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

    Należy upewnić się, że wszystkie aplikacje Firebase w jednym projekcie Firebase są wariantami platformy tej samej aplikacji z punktu widzenia użytkownika końcowego. Na przykład, jeśli tworzysz aplikację typu white label, każda niezależnie oznaczona aplikacja powinna mieć własny projekt Firebase.

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

  • Liczba witryn hostingowych na projekt

    Funkcja hostingu wielostanowiskowego Firebase obsługuje maksymalnie 36 witryn na projekt.

Wielu najemców

Nie zaleca się łączenia kilku różnych logicznie niezależnych aplikacji i / lub witryn internetowych z jednym projektem Firebase (często nazywanym „wieloma dzierżawcami”). Wielodostępność może prowadzić do poważnych problemów związanych z konfiguracją i prywatnością danych, w tym niezamierzonych problemów z agregacją danych analitycznych, współużytkowanym uwierzytelnianiem, nadmiernie złożonymi strukturami baz danych i trudnościami z regułami bezpieczeństwa.

Ogólnie rzecz biorąc, jeśli zestaw aplikacji nie udostępnia tych samych danych i konfiguracji, zdecydowanie rozważ zarejestrowanie każdej aplikacji w innym projekcie Firebase.

Na przykład, jeśli tworzysz aplikację typu white label, każda niezależnie oznaczona aplikacja powinna mieć własny projekt Firebase. Każda aplikacja nie może i nie powinna (ze względu na ochronę prywatności) udostępniać innym dane.

Uruchamiam Twoją aplikację