Google is committed to advancing racial equity for Black communities. See how.
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 Platform (GCP)

Gdy tworzysz nowy projekt Firebase w konsoli Firebase, w rzeczywistości tworzysz projekt Google Cloud Platform (GCP) za kulisami. Możesz myśleć o projekcie GCP jako o wirtualnym kontenerze danych, kodu, konfiguracji i usług. Projekt Firebase to projekt GCP, który ma dodatkowe konfiguracje i usługi specyficzne dla Firebase. Możesz nawet najpierw utworzyć projekt GCP, a później dodać do niego Firebase.

Ponieważ projekt Firebase jest projektem GCP:

Konfigurowanie projektu Firebase i rejestrowanie aplikacji

Możesz skonfigurować projekt Firebase i zarejestrować aplikacje w konsoli Firebase (lub w zaawansowanych przypadkach użycia przez Firebase Management REST API lub Firebase CLI ). Konfigurując projekt i rejestrując aplikacje, musisz podjąć pewne decyzje organizacyjne i dodać informacje konfiguracyjne specyficzne dla Firebase do swoich projektów lokalnych.

Przed skonfigurowaniem projektu i zarejestrowaniem aplikacji należy zapoznać 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, konsoli GCP i interfejsie wiersza polecenia Firebase . Nazwa projektu nie jest ujawniana w żadnym publicznie widocznym produkcie, usłudze ani zasobie Firebase lub GCP; 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 panelu.

Numer projektu

Projekt Firebase (i powiązany z nim projekt GCP ) 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ń interfejsu API w usługach Firebase, Google lub innych firm.

Wywołania API i numer projektu

W przypadku wielu wywołań interfejsu API należy podać unikalny identyfikator 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 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 GCP ) ma identyfikator projektu . To jest zdefiniowany przez użytkownika unikalny identyfikator projektu we wszystkich Firebase i GCP. Gdy tworzysz projekt Firebase, Firebase automatycznie przypisuje do projektu unikalny identyfikator, ale możesz go edytować podczas konfigurowania projektu. Ten identyfikator powinien być ogólnie traktowany jako wygodny alias do odniesienia 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 .firebaseio.com
  • 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, podzielić 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ć unikalny identyfikator 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 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 panelu.

  • 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 dodaj 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 GCP. 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 na dane. Biorąc to pod uwagę, użyj reguł bezpieczeństwa, aby chronić swoje dane i pliki w bazie danych czasu rzeczywistego , Cloud Firestore i Cloud Storage .

W przypadku projektów typu open source zasadniczo nie zalecamy włączania pliku konfiguracyjnego lub obiektu Firebase aplikacji do 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ą mieć wpływ na sposób zarządzania projektem Firebase.

Narzędzia do zarządzania projektem

Konsola Firebase

Konsola Firebase oferuje najbogatsze środowisko do zarządzania produktami, aplikacjami Firebase i 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ą konfigurację przepływów pracy w celu zarejestrowania różnych typów aplikacji. Po rozpoczęciu korzystania z Firebase główny obszar konsoli zmienia się w pulpit nawigacyjny, który wyświetla statystyki dotyczące 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 Cloud Functions dla Firebase, oraz 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. Zalecane jest zarejestrowanie wersji tej samej aplikacji lub gry na iOS, Androida i wersję internetową w tym samym projekcie Firebase. Wszystkie aplikacje w projekcie na ogół współdzielą 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.

Chociaż nie ma ograniczeń co do liczby aplikacji w projekcie, zarejestrowanie aplikacji może utworzyć jeden lub więcej podstawowych identyfikatorów klienta OAuth 2.0. Istnieje limit około 30 identyfikatorów klientów, które można utworzyć w ramach jednego projektu.

Wielu najemców

Nie zaleca się łączenia kilku różnych logicznie niezależnych aplikacji i / lub witryn internetowych w jednym projekcie (często nazywanym „obsługą wielu podmiotów”). 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ą analiz, 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.

Zwróć uwagę na ogólne ograniczenia dotyczące 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ść programistó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

    Chociaż nie ma ograniczeń co do liczby aplikacji w projekcie, zarejestrowanie aplikacji może utworzyć jeden lub więcej podstawowych identyfikatorów klienta OAuth 2.0. Istnieje limit około 30 identyfikatorów klientów, które można utworzyć w ramach jednego projektu.

  • Liczba witryn hostingowych na projekt

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

Uruchamiam Twoją aplikację