Informacje o projektach Firebase

Ta strona zawiera krótkie omówienie kilku ważnych pojęć związanych z projektami Firebase. Jeśli to możliwe, kliknij linki, aby uzyskać bardziej szczegółowe informacje o funkcjach, usługach, narzędziach i sprawdzonych metodach.

Zależności między projektami, aplikacjami i usługami Firebase

Projekt w Firebase to jednostka najwyższego poziomu w Firebase. W projekcie możesz zarejestrować swoje aplikacje na iOS, 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.

Poznawanie hierarchii projektów Firebase

Diagram przedstawiający podstawową hierarchię projektu w Firebase, w tym projekt, zarejestrowane w nim aplikacje oraz udostępnione zasoby i usługi Ten diagram przedstawia podstawową hierarchię projektu w Firebase. Oto najważniejsze zależności:

  • Projekt w Firebase to kontener na wszystkie Twoje aplikacje oraz zasoby i usługi udostępnione w projekcie.

  • Projekt w Firebase może mieć zarejestrowaną co najmniej 1 aplikację w Firebase (np. wersję aplikacji na iOS i Androida lub wersję bezpłatną i płatną).

  • Wszystkie aplikacje w Firebase zarejestrowane w tym samym projekcie w Firebase mają dostęp do wszystkich tych samych zasobów i usług udostępnionych w projekcie. 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 w tej usłudze.

Zależności między projektami Firebase a Google Cloud

Gdy tworzysz nowy projekt w Firebase, faktycznie tworzysz za kulisami projekt Google Cloud. Możesz nawet najpier0 utworzyć projekt, a potem dodać do niego Firebase.Google Cloud Projekt Google Cloud można traktować jako wirtualny kontener na dane, kod, konfigurację i usługi.

Pamiętaj, że w przypadku wszystkich projektów Firebase usługa ta automatycznie dodaje etykietę firebase:enabled na stronie Etykiety w konsoli Google Cloud. Więcej informacji o tej etykiecie znajdziesz w naszych najczęstszych pytaniach.

Ponieważ projekt w Firebase jest projektem Google Cloud:

  • Możesz uzyskiwać dostęp do projektu i wchodzić z nim w interakcje w Firebase konsoli a także w Google Cloud konsoli i konsoli interfejsów API Google.

  • Możesz wchodzić w interakcje z projektem za pomocą Firebase interfejsu wiersza poleceń, the gcloud CLI, i dowolnego zasobu Terraform od Google.

  • W projekcie możesz używać usług i interfejsów API zarówno Firebase, jak i Google Cloud w projekcie.

  • Uprawnienia i role IAM w projekcie są współdzielone przez Firebase i Google Cloud. Każdy dostęp, jaki członek projektu (czyli, podmiot) ma do Twojego Google Cloud projektu, będzie też dotyczyć Twojego Firebase projektu (i odwrotnie).

  • Płatności za projekt są rozliczane wspólnie przez Firebase i Google Cloud. Jeśli w Twoim projekcie Google Cloud włączono płatności, Twój projekt w Firebase będzie korzystać z abonamentu Blaze (płatność według wykorzystania).

  • Unikalne identyfikatory projektu (takie jak numer projektu i identyfikator projektu) są współdzielone przez Firebase i Google Cloud.

  • Każda hierarchia zasobów zastosowana w Twoim Google Cloud projekcie (np. organizacja, foldery, itp.) będzie też dotyczyć Twojego projektu w Firebase.

  • Usunięcie projektu spowoduje jego usunięcie zarówno w Firebase, jak i w Google Cloud.

  • Usunięcie lub zmodyfikowanie zasobu albo danych w projekcie spowoduje zastosowanie zmian zarówno w Firebase, jak i w Google Cloud.

Konfigurowanie projektu w Firebase i rejestrowanie aplikacji

Projekt w Firebase możesz skonfigurować, a aplikacje zarejestrować w konsoli Firebase (lub w bardziej zaawansowanych przypadkach użycia za pomocą interfejsu Firebase Management REST API albo Firebase interfejsu wiersza poleceń). Podczas konfigurowania projektu i rejestrowania aplikacji musisz podjąć pewne decyzje organizacyjne i dodać do lokalnych projektów informacje konfiguracyjne specyficzne dla Firebase.

W przypadku aplikacji produkcyjnych musisz skonfigurować przejrzysty proces tworzenia, który zwykle obejmuje korzystanie z wielu środowisk. Aby utworzyć proces tworzenia , zapoznaj się z naszą dokumentacją dotyczącą procesów deweloperskich , w tym ze sprawdzonymi metodami i ogólnymi wytycznymi dotyczącymi bezpieczeństwa w zakresie konfigurowania projektów Firebase i rejestrowania aplikacji.

Interakcje z projektem w Firebase

Oprócz pakietów SDK usług możesz bezpośrednio wchodzić w interakcje z projektem w Firebase za pomocą kilku różnych narzędzi i interfejsów.

Firebase konsola

Konsola FirebaseFirebase zapewnia najbogatsze środowisko do zarządzania usługami, aplikacjami i ustawieniami na poziomie projektu Firebase.

W panelu po lewej stronie konsoli znajdują się usługi Firebase uporządkowane według kategorii najwyższego poziomu. U góry panelu po lewej stronie kliknij , aby uzyskać dostęp do ustawień projektu. Ustawienia projektu obejmują integracje, uprawnienia dostępu, i płatności.

Na środku konsoli znajdują się przyciski, które uruchamiają procesy konfiguracji umożliwiające rejestrowanie różnych typów aplikacji. Gdy zaczniesz korzystać z Firebase, główny obszar konsoli zmieni się w panel, który wyświetla statystyki dotyczące używanych usług.

Pamiętaj, że projekt w Firebase jest też projektem Google Cloud, dlatego w przypadku różnych zadań lub usług może być konieczne użycie konsoli Google Cloud zamiast konsoli Firebase.

Firebase CLI (narzędzie wiersza poleceń)

Firebase oferuje też Firebase CLI do konfigurowania i zarządzania określonymi 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 interfejsu wiersza poleceń, aby połączyć lokalny katalog aplikacji z projektem w Firebase, a następnie wdrożyć nowe wersje treści hostowanych w Firebase lub aktualizacje funkcji.

Interfejs Firebase Management REST API

Za pomocą interfejsu Firebase Management REST API możesz programowo zarządzać projektem w Firebase. Możesz na przykład programowo zarejestrować aplikację w projekcie lub wyświetlić listę aplikacji, które są już zarejestrowane (iOS+ | Android | sieć).

Identyfikatory projektu w Firebase

Projekt w Firebase można zidentyfikować w backendzie Firebase i w różnych interfejsach deweloperskich za pomocą różnych identyfikatorów, w tym nazwy projektu, numeru projektu i identyfikatora projektu.

Nazwa projektu

Podczas tworzenia projektu podajesz jego nazwę. Ten identyfikator to tylko wewnętrzna nazwa projektu w Firebase konsoli, w Google Cloud konsoli, i w Firebase CLI. Nazwa projektu nie jest widoczna w żadnej publicznie dostępnej usłudze ani zasobie Firebase lub Google Cloud . Służy tylko do łatwiejszego rozróżniania projektów.

Nazwę projektu możesz w każdej chwili edytować w Ustawienia projektu w Firebase konsoli. Nazwa projektu jest wyświetlana 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 projektu przypisany przez Google. Wykorzystuj ten identyfikator przy konfigurowaniu integracji lub wywołaniach API do Firebase, Google albo usług innych firm.

Numeru projektu nie można edytować. Jeśli usuniesz projekt, numer projektu też zostanie usunięty i nigdy nie będzie można go użyć w innym projekcie.

Identyfikator projektu

Projekt w Firebase (i powiązany z nim projekt Google Cloud) ma identyfikator projektu. Jest to unikalny identyfikator projektu zdefiniowany przez użytkownika w Firebase i Google Cloud. Gdy tworzysz projekt w Firebase, usługa ta automatycznie przypisuje mu unikalny identyfikator, ale możesz go edytować podczas konfigurowania projektu. Ten identyfikator powinien być traktowany głównie jako praktyczny alias używany w odniesieniu do projektu.

Pliki i obiekty konfiguracyjne Firebase

Gdy zarejestrujesz aplikację w projekcie w Firebase, konsola Firebaseudostępni plik konfiguracyjny Firebase (aplikacje na iOS/Androida) lub obiekt konfiguracyjny (aplikacje internetowe), który dodasz bezpośrednio do lokalnego katalogu aplikacji.

  • W przypadku aplikacji na iOS dodaj plik konfiguracyjny GoogleService-Info.plist.
  • W przypadku aplikacji na Androida dodaj plik konfiguracyjny google-services.json.
  • W przypadku aplikacji internetowych dodaj obiekt konfiguracyjny Firebase.

W każdej chwili możesz pobrać plik lub obiekt konfiguracyjny Firebase aplikacji.

Plik lub obiekt konfiguracyjny Firebase łączy 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 powiązania danych klienta z projektem w Firebase i aplikacją w Firebase. Oto wymagane minimalne „opcje Firebase”:

  • Klucz interfejsu API: prosty zaszyfrowany ciąg znaków używany do wywoływania określonych interfejsów API, które nie wymagają dostępu do prywatnych danych użytkownika (przykładowa wartość: AIzaSyDOCAbC123dEf456GhI789jKl012-MnO)

  • Identyfikator projektu: unikalny identyfikator projektu zdefiniowany przez użytkownika w 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. (przykładowa wartość: myapp-project-123).

  • Identyfikator aplikacji („AppID”): unikalny identyfikator aplikacji w 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 Firebase na Androida: mobilesdk_app_id (przykładowa wartość: 1:1234567890:android:321abc456def7890)
      To nie jest nazwa pakietu na Androida ani identyfikator aplikacji na Androida.
    • Aplikacje Firebase w sieci: appId (przykładowa wartość: 1:65211879909:web:3ae38ef1cdcb2e01fe5f0c).

Zawartość pliku lub obiektu konfiguracyjnego Firebase jest uważana za publiczną, w tym identyfikator aplikacji specyficzny dla platformy (identyfikator pakietu Apple lub nazwa pakietu na Androida) oraz wartości specyficzne dla projektu Firebase, takie jak klucz interfejsu API, identyfikator projektu, Realtime Database adres URL i Cloud Storage nazwa zasobnika. W związku z tym, używaj Firebase Security Rules , aby chronić dane i pliki w Realtime Database, Cloud Firestore, i Cloud Storage.

W przypadku projektów open source na ogół nie zalecamy umieszczania pliku ani obiektu konfiguracyjnego Firebase aplikacji w systemie 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łasnego pliku lub obiektu konfiguracyjnego Firebase).

Ogólne limity projektów, aplikacji i witryn Firebase

Oto kilka ogólnych limitów projektów, aplikacji i witryn Firebase:

  • 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 się zwiększyć po połączeniu Cloud Billing w dobrej kondycji.

    Pamiętaj o tych ograniczeniach dotyczących limitu tworzenia projektów:

    • Ten limit nie dotyczy tylko Firebase. Limity Firebase dotyczące liczby projektów są takie same jak w Google Cloud.
    • W rzadkich przypadkach możesz poprosić o zwiększenie limitu projektów.
    • Całkowite usunięcie projektu wymaga 30 dni i jest wliczane do limitu projektów do momentu całkowitego usunięcia projektu.

    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ą wariantami tej samej aplikacji z perspektywy użytkownika. Więcej informacji o obsłudze wielu najemców znajdziesz w naszych dokumentach dotyczących sprawdzonych metod.

    Więcej informacji o limicie aplikacji na projekt znajdziesz w najczęstszych pytaniach.

  • Liczba witryn na projektHosting

    Funkcja obsługi wielu witryn w Hostingu Firebase obsługuje maksymalnie 36 witryn na projekt.Firebase Hosting

Uruchamianie aplikacji