Google 致力于为黑人社区推动种族平等。查看具体举措

Poznaj projekty Firebase

Ta strona zawiera krótkie omówienie kilku ważnych pojęć dotyczących projektów Firebase. Jeśli to możliwe, skorzystaj z łączy, aby znaleźć bardziej szczegółowe informacje o funkcjach, usługach, a nawet innych platformach. Na dole tej stronie znajdziesz listę ogólnych najlepszych praktyk dotyczących projektów Firebase.

Relacje między projektami, aplikacjami i produktami Firebase

Projekt Firebase to element najwyższego poziomu w Firebase. W projekcie tworzysz aplikacje Firebase, rejestrując aplikacje na iOS, Androida lub aplikacje internetowe. Po zarejestrowaniu swoje aplikacje z Firebase, można dodać Firebase SDK dla dowolnej liczby produktów Firebase , jak Analytics, chmura FireStore, monitoringu wydajności lub Remote Config.

Więcej szczegółowych informacji na temat tego procesu w PRZYGOTOWANIA prowadnic ( iOS | Android | WWW | Unity | C ++ ).

Związek między projektami Firebase a Google Cloud

Podczas tworzenia nowego Firebase projekt w konsoli Firebase, jesteś rzeczywiście tworząc projekt Google Cloud za kulisy. Możesz myśleć o projekcie Google Cloud jako o wirtualnym kontenerze na dane, kod, konfigurację i usługi. Projekt Firebase to projekt Google Cloud, który ma dodatkowe konfiguracje i usługi związane z Firebase. Możesz nawet najpierw utworzyć projekt Google Cloud, a później dodać do niego Firebase.

Od projektu Firebase to projekt Google Cloud:

  • Projekty, które pojawiają się w konsoli Firebase pojawiają się również w Google Cloud Console i konsoli Google API .

  • Billing i uprawnienia dla projektów są współużytkowane przez Firebase i Google Cloud.

  • Unikalne identyfikatory dla projektu (jak numer projektu oraz ID projektu ) są współużytkowane przez Firebase i Google Cloud.

  • W projekcie możesz używać produktów i interfejsów API z Firebase i Google Cloud.

  • Usunięcie projektu powoduje usunięcie go w Firebase i Google Cloud.

Konfigurowanie projektu Firebase i rejestrowanie aplikacji

Można skonfigurować projekt Firebase i zarejestrować aplikacje w konsoli Firebase (lub dla zaawansowanych przypadków użycia, poprzez Firebase Zarządzania REST API lub Firebase CLI ). Podczas konfigurowania projektu i rejestrowania aplikacji musisz podjąć pewne decyzje organizacyjne i dodać informacje o konfiguracji związane z Firebase do swoich projektów lokalnych.

Upewnij się przeglądu niektórych najlepszych praktyk ogólny projekt poziomu (na dole tej strony) przed uruchomieniem projektu i rejestracji aplikacji.

Nazwa projektu

Podczas tworzenia projektu, należy podać nazwę projektu. Ten identyfikator jest tylko wewnętrzna nazwa projektu w konsoli Firebase , w konsoli Google Cloud oraz Firebase CLI . Nazwa projektu nie jest widoczna w żadnym publicznie widocznym produkcie, usłudze lub zasobie Firebase lub Google Cloud; służy po prostu do łatwiejszego rozróżniania wielu projektów.

Można edytować nazwę projektu w dowolnym momencie w Ustawienia projektu z konsoli Firebase. Nazwa projektu jest wyświetlana w górnym panelu.

Numer projektu

Projekt Firebase (i jego skojarzony projekt Google Cloud ) ma numer projektu. Jest to globalnie unikalny identyfikator kanoniczny przypisany do projektu przez Google. Użyj tego identyfikatora podczas konfigurowania integracji i/lub wywoływania interfejsu API do Firebase, Google lub usług innych firm.

Wywołania API i numer projektu

W przypadku wielu wywołań API musisz dołączyć unikalny identyfikator projektu. Chociaż wiele API zaakceptować identyfikator projektu , zaleca się użycie numer projektu do wykonywania połączeń do Firebase API, Google lub usług osób trzecich.

Dowiedz się więcej o korzystaniu identyfikatory projektu, w szczególności numer projektu w Google standardzie AIP 2510 .

Znajdź numer projektu

  • Firebase konsola: Kliknij Ustawienia projektu . Numer projektu jest wyświetlany w górnym okienku.

  • Firebase CLI: Run firebase projects:list . Numer projektu jest wyświetlany wraz ze wszystkimi projektami Firebase powiązanymi z Twoim kontem.

  • Firebase Zarządzanie REST API: Zaproszenie projects.list . Ciało odpowiedź zawiera numer projektu w FirebaseProject obiektu.

Identyfikator projektu

Projekt Firebase (i jego skojarzony projekt Google Cloud ) ma identyfikator projektu. Jest to zdefiniowany przez użytkownika unikalny identyfikator projektu we wszystkich usługach Firebase i Google Cloud. Gdy tworzysz projekt Firebase, Firebase automatycznie przypisuje mu 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 nigdy nie może być ponownie użyty przez żaden inny projekt.

Zasoby Firebase i identyfikator projektu

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

  • Domyślna subdomena Hosting - PROJECT_ID .web.app i PROJECT_ID .firebaseapp.com
  • Domyślny URL bazy danych w czasie rzeczywistym - PROJECT_ID -default-rtdb.firebaseio.com lub PROJECT_ID -default-rtdb. REGION_CODE .firebasedatabase.app
  • Domyślna nazwa Cloud Storage wiadro - PROJECT_ID .appspot.com

Dla wszystkich wyżej wymienionych zasobów możesz tworzyć instancje inne niż domyślne. Widoczne publicznie nazwy wartości innych niż domyślne są w pełni konfigurowalne. Można połączyć niestandardowych domen do Firebase-hosted miejscu, shard bazy danych w czasie rzeczywistym oraz tworzenie wielu wiadra Cloud Storage (wizyta platformy specyficzne Get Started strona).

Firebase CLI 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żna również założyć alias projektu dla każdego projektu Firebase, dzięki czemu nie trzeba pamiętać identyfikatory projektu.

Wywołania API i identyfikator projektu

W przypadku wielu wywołań API musisz dołączyć unikalny identyfikator projektu. Chociaż wiele API akceptuje identyfikator projektu, zaleca się użycie numer projektu do wykonywania połączeń do Firebase API, Google lub usług osób trzecich.

Dowiedz się więcej o korzystaniu identyfikatory projektu, w szczególności numer projektu w Google standardzie AIP 2510 .

Znajdź identyfikator projektu

  • Firebase konsola: Kliknij Ustawienia projektu . Identyfikator projektu jest wyświetlany w górnym panelu.

  • Firebase CLI: Run firebase projects:list . Identyfikator projektu jest wyświetlany wraz ze wszystkimi projektami Firebase powiązanymi z Twoim kontem.

  • Firebase Zarządzanie REST API: Zaproszenie projects.list . Ciało odpowiedź zawiera identyfikator projektu w FirebaseProject obiektu.

Pliki i obiekty konfiguracyjne Firebase

Gdy rejestrujesz aplikację w projekcie Firebase, konsola Firebase udostępnia plik konfiguracyjny Firebase (aplikacje na iOS/Android) lub obiekt konfiguracyjny (aplikacje internetowe), który dodajesz bezpośrednio do lokalnego katalogu aplikacji.

  • Dla iOS, dodasz GoogleService-Info.plist plik konfiguracyjny.
  • Dla aplikacji Android, dodać google-services.json plik konfiguracyjny.
  • W przypadku aplikacji internetowych dodajesz obiekt konfiguracyjny Firebase.

W każdej chwili można uzyskać aplikacji Firebase plik konfiguracyjny lub obiektu .

Plik lub obiekt konfiguracji Firebase kojarzy 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 komunikacji z interfejsami API serwera Firebase oraz do powiązania danych klienta z projektem Firebase i aplikacją Firebase. Oto wymagane minimalne „Opcje Firebase”:

  • Klucz API : prosty zaszyfrowany ciąg używany podczas wywoływania pewnych funkcji API, które nie potrzebują dostępu do danych prywatnych użytkowników (przykład wartość: AIzaSyDOCAbC123dEf456GhI789jKl012-MnO )

  • Projekt ID : zdefiniowana przez użytkownika unikalny identyfikator dla projektu całej wszystkie Firebase i Google Cloud. Ten identyfikator może pojawiać się w adresach URL lub nazwach niektórych zasobów Firebase, ale ogólnie powinien być traktowany jako wygodny alias do odwoływania się do projektu. (przykład wartość: myapp-project-123 ),

  • Identyfikator aplikacji ( „AppID”): unikalny identyfikator aplikacji Firebase całej wszystkie Firebase z formatem danej platformy:

    • Firebase iOS aplikacji: GOOGLE_APP_ID (przykład wartość: 1:1234567890:ios:321abc456def7890 )
      Nie jest to pakiet Apple ID.
    • Firebase Android aplikacji: mobilesdk_app_id (przykład wartość: 1:1234567890:android:321abc456def7890 )
      Nie jest to nazwa pakietu Android lub Android ID.
    • Firebase Web Apps: appId (przykład wartość: 1:65211879909:web:3ae38ef1cdcb2e01fe5f0c )

Zawartość pliku konfiguracyjnego lub obiektu Firebase jest uznawana za publiczną, w tym identyfikator platformy aplikacji (identyfikator pakietu iOS lub nazwa pakietu Android) oraz wartości specyficzne dla projektu Firebase, takie jak klucz API, identyfikator projektu, adres URL bazy danych czasu rzeczywistego oraz Nazwa zasobnika Cloud Storage. Biorąc pod uwagę to, stosowaniu reguł Firebase bezpieczeństwa w celu ochrony danych i plików w czasie rzeczywistym Danych , Chmura FireStore i Cloud Storage .

W przypadku projektów typu open source generalnie nie zalecamy uwzględniania 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 wskazywać swoim aplikacjom własne zasoby Firebase (za pomocą własnej konfiguracji Firebase plik lub obiekt).

Zarządzanie projektem Firebase

Upewnij się, aby dokonać przeglądu najlepszych praktyk ogólny projekt poziomu (na dole tej strony) dla rozważań, które mogłyby mieć wpływ na sposób zarządzania projektem Firebase.

Narzędzia do zarządzania projektem

Konsola Firebase

Firebase konsola oferuje najbogatszy środowisko dla zarządzanie produktami Firebase, aplikacje i ustawienia na poziomie projektów.

Konsola Firebase — ekran przeglądu projektu

Panel po lewej stronie konsoli zawiera listę produktów Firebase uporządkowaną według kategorii najwyższego poziomu. W górnej części panelu po lewej stronie, dostęp do ustawień projektu, klikając . Ustawienia projektu obejmują integracje , uprawnienia dostępu i rozliczania .

Na środku konsoli wyświetlane są przyciski uruchamiające przepływy pracy konfiguracji w celu rejestrowania różnych typów aplikacji. Po rozpoczęciu korzystania z Firebase główny obszar konsoli zmienia się w pulpit nawigacyjny, na którym wyświetlane są statystyki dotyczące używanych produktów.

Firebase CLI (narzędzie wiersza poleceń)

Firebase oferuje również Firebase CLI do konfigurowania i zarządzania konkretnych produktów Firebase, jak i funkcje Firebase Hosting Chmura Firebase.

Po zainstalowaniu CLI, masz dostęp do globalnej firebase polecenia . Użyj CLI, aby połączyć się z lokalnym katalogu aplikacji do projektu Firebase , a następnie wdrożyć nowe wersje Firebase-hosted treści lub aktualizacje do funkcji.

Interfejs API REST zarządzania Firebase

Korzystanie z API Firebase Zarządzanie REST , można programowo zarządzać projektem Firebase. Na przykład, można programowo zarejestrować aplikację z projektem lub listę aplikacji, które są już zarejestrowane ( iOS | Android | WWW ).

Ogólne najlepsze praktyki

Dodawanie aplikacji do projektu

Upewnić się, że wszystkie aplikacje w ramach projektu są warianty platformie tej samej aplikacji z perspektywy użytkownika końcowego. Zaleca się zarejestrowanie wersji tej samej aplikacji lub gry na systemy iOS, Android i internetowe w tym samym projekcie Firebase. Wszystkie aplikacje w projekcie zazwyczaj współdzielą te same zasoby Firebase (baza danych, zasobniki na dane itp.).

Jeśli masz kilka wariantów budowy z różnych iOS lub Android pakiet identyfikatory zdefiniowane nazwy pakietów, można zarejestrować każdy wariant z odrębnym projektem Firebase. Jednakże, jeśli masz warianty, które mają te same zasoby Firebase, zarejestruj je z tego samego projektu Firebase.

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

  • Liczba projektów na konto

    • Plan cenowy Spark — przydział tworzenia projektów jest ograniczony do mniejszej liczby projektów (zwykle około 5-10).
    • Plan cenowy Blaze — limit tworzenia projektów na konto znacznie wzrasta, o ile powiązane konto rozliczeniowe Cloud Billing ma dobrą opinię.

    Limit kwoty z projektem tworzenia rzadko jest problemem dla większości deweloperów, ale w razie potrzeby można poprosić o zwiększenie kwot projektu .

    Pamiętaj, że całkowite usunięcie projektu wymaga 30 dni i wlicza się do limitu projektu do momentu całkowitego usunięcia projektu.

  • 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 końcowego. Więcej informacji na temat najlepszych praktyk w wielu najmu poniżej.

    Więcej informacji na temat limitu aplikacjach na projekt w FAQ.

  • Liczba witryn hostingowych na projekt

    Firebase Hosting wielokierunkowego funkcję obsługuje maksymalnie 36 stron na projekt.

Wielu najemców

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

Generalnie, jeśli zestaw aplikacji nie podzielają te same dane i konfiguracje, zdecydowanie rozważyć rejestracji każdą aplikację z innego projektu Firebase.

Na przykład, jeśli opracujesz aplikację z białą etykietą, każda niezależnie oznaczona aplikacja powinna mieć własny projekt Firebase, ale wersje tej etykiety na iOS i Androida mogą znajdować się w tym samym projekcie. Każda niezależnie oznaczona aplikacja nie powinna (ze względu na ochronę prywatności) udostępniać danych innym.

Uruchamiam Twoją aplikację