Projekty Firebase

Na tej stronie znajdziesz 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ć aplikacje na Apple, 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 |internet | Unity | C++ |Flutter.

Hierarchia 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 relacje:

  • Projekt w Firebase jest kontenerem 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 współdzielą wszystkie zasoby i usługi udostępnione w projekcie oraz mają do nich dostęp. Oto 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 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 Firebase jest osobnym strumieniem danych w tej usłudze.

Związek między projektami Firebase a Google Cloud

Gdy tworzysz nowy projekt w Firebase, faktycznie tworzysz za kulisami Google Cloudprojekt. Możesz nawet najpierw utworzyć Google CloudprojektGoogle Cloud, a potem dodać do niego Firebase. Google CloudProjekt to wirtualny kontener na dane, kod, konfigurację i usługi.

Pamiętaj, że w przypadku wszystkich projektów Firebase usługa ta automatycznie dodaje do projektu etykietę firebase:enabled na stronie Administracja > Etykiety w konsoli Google Cloud. Więcej informacji o tym oznaczeniu znajdziesz w odpowiedziach na najczęstsze pytania.

Projekt w Firebase jest projektem Google Cloud:

  • Dostęp do projektu i możliwość interakcji z nim masz w Firebasekonsoli, a także w Google Cloudkonsoli i Konsoli interfejsów API Google.

  • Z projektem możesz wchodzić w interakcje za pomocą Firebase CLI, gcloud CLI i dowolnego zasobu Terraform od Google.

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

  • Uprawnienia i role IAM w projekcie są współdzielone między Firebase a usługą Google Cloud. Wszelkie uprawnienia członka projektu (czyli podmiotu) do projektu Google Cloud będą też obowiązywać w projekcie Firebase (i odwrotnie).

  • Płatności za projekt są wspólne dla Firebase iGoogle Cloud. Jeśli w projekcie Google Cloud płatności są włączone, projekt w Firebase będzie korzystać z abonamentu Blaze (płatność według wykorzystania).

  • Unikalne identyfikatory projektu (np. numer projektu i identyfikator projektu) są udostępniane w Firebase i Google Cloud.

  • Każda hierarchia zasobów zastosowana do projektu Google Cloud (np. organizacja, foldery itp.) będzie też obowiązywać w projekcie w Firebase.

  • Usunięcie projektu spowoduje jego usunięcie z Firebase i Google Cloud.

  • Usunięcie lub zmiana zasobu lub danych w projekcie ma zastosowanie w Firebase i Google Cloud.

Konfigurowanie projektu w Firebase i rejestrowanie aplikacji

Możesz skonfigurować projekt w Firebase i zarejestrować aplikacje w Firebasekonsoli (lub w bardziej zaawansowanych przypadkach użycia za pomocą interfejsu Firebase Management REST API lub Firebaseinterfejsu wiersza poleceń). Podczas konfigurowania projektu i rejestrowania aplikacji musisz podjąć kilka decyzji organizacyjnych i dodać do lokalnych projektów informacje o konfiguracji specyficzne dla Firebase.

W przypadku aplikacji produkcyjnych musisz skonfigurować przejrzysty przepływ pracy związany z programowaniem, który zwykle obejmuje korzystanie z wielu środowisk. Zapoznaj się z naszą dokumentacją dotyczącą procesów deweloperskich, w tym ogólnych sprawdzonych metod i ogólnych wytycznych dotyczących bezpieczeństwa, aby skonfigurować projekty Firebase i zarejestrować aplikacje w celu utworzenia procesu deweloperskiego.

Interakcja z projektem w Firebase

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

Firebase konsola

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

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

Na środku konsoli znajdują się przyciski, które uruchamiają przepływy pracy 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 przez Ciebie usług.

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

Firebase interfejs wiersza poleceń (narzędzie wiersza poleceń);

Firebase oferuje też Firebase interfejs wiersza poleceń do konfigurowania i zarządzania konkretnymi usługami Firebase, takimi jak Firebase Hosting, Cloud Functions for Firebase i Firebase Extensions.

Po zainstalowaniu Firebaseinterfejsu CLI uzyskasz dostęp do globalnego firebasepolecenia. Użyj Firebase 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.

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 nazwę projektu. Ten identyfikator to nazwa projektu widoczna tylko wewnętrznie w Firebase konsoli, Google Cloud konsoli i Firebase interfejsie CLI. Nazwa projektu nie jest widoczna w żadnej publicznie dostępnej usłudze, produkcie ani zasobie Firebase ani Google Cloud. Ułatwia ona jedynie rozróżnianie wielu projektów.

Nazwę projektu możesz w każdej chwili zmienić w górnym panelu Ustawienia > karta Ogólne w Firebase konsoli.

Numer projektu

Projekt w Firebase (i powiązany z nim projekt Google Cloud) ma numer projektu. Jest to unikalny globalnie kanoniczny identyfikator projektu przypisany przez Google. Wykorzystuj ten identyfikator przy konfigurowaniu integracji lub wywołaniach API do Firebase, Google albo usług innych firm.

Nie możesz edytować numeru projektu. Jeśli usuniesz projekt, jego numer również zostanie usunięty i nie będzie można go ponownie użyć w żadnym innym projekcie.

Identyfikator projektu

Projekt Firebase (i powiązany z nim Google Cloudprojekt) ma identyfikator. Jest to zdefiniowany przez użytkownika unikalny identyfikator projektu we wszystkich usługach 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 konfiguracyjne i obiekty Firebase

Gdy zarejestrujesz aplikację w projekcie w Firebase, Firebasekonsola udostępni plik konfiguracyjny Firebase (w przypadku aplikacji na iOS i Androida) lub obiekt konfiguracyjny (w przypadku aplikacji internetowych), który możesz dodać bezpośrednio do lokalnego katalogu aplikacji.

  • W przypadku aplikacji Apple dodajesz GoogleService-Info.plist plik konfiguracji.
  • W przypadku aplikacji na Androida dodaj plik konfiguracji google-services.json.
  • W przypadku aplikacji internetowych dodajesz obiekt konfiguracji Firebase.

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

Plik lub obiekt konfiguracyjny Firebase łączy aplikację z konkretnym projektem Firebase i jego zasobami (bazami danych, zasobnikami pamięci itp.). Konfiguracja zawiera „Opcje Firebase”, czyli parametry wymagane przez Firebase i usługi Google do komunikacji 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 w przypadku wywoływania określonych interfejsów API, które nie wymagają dostępu do prywatnych danych użytkowników (przykładowa wartość: AIzaSyDOCAbC123dEf456GhI789jKl012-MnO).

  • Identyfikator projektu: zdefiniowany przez użytkownika unikalny identyfikator projektu w całym 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 we wszystkich usługach Firebase w formacie specyficznym dla platformy:

    • Aplikacje Apple w Firebase: 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 internetowe Firebase: 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 Android) oraz wartości specyficzne dla projektu Firebase, takie jak klucz API, identyfikator projektu, adres URL Realtime Database i nazwa zasobnika Cloud Storage. 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 zwykle nie zalecamy umieszczania pliku lub obiektu konfiguracji Firebase aplikacji w systemie kontroli wersji, ponieważ w większości przypadków użytkownicy powinni tworzyć własne projekty Firebase i kierować aplikacje do własnych zasobów Firebase (za pomocą własnego pliku lub obiektu konfiguracji Firebase).

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

Oto ogólne limity dotyczące 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 wzrosnąć po połączeniu z Cloud Billing kontem o dobrej reputacji.

    Pamiętaj o tych uwagach na temat limitu przydziału tworzenia projektów:

    • Ten limit nie dotyczy tylko Firebase. Limity Firebase dotyczące limitu projektu są takie same jak w przypadku Google Cloud.
    • W rzadkich przypadkach, gdy jest to konieczne, możesz poprosić o zwiększenie limitu projektów.
    • Całkowite usunięcie projektu zajmuje 30 dni i do tego czasu jest wliczane do limitu projektu.

    Dowiedz się więcej o zalecanych przez Firebase ogólnych sprawdzonych metodach konfigurowania projektów Firebase.

  • Liczba aplikacji w projekcie

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

    Upewnij się, że wszystkie aplikacje w Firebase w ramach jednego projektu w Firebase są z perspektywy użytkownika wariantami tej samej aplikacji na różne platformy. Więcej informacji o wielodostępności znajdziesz w dokumentacji dotyczącej sprawdzonych metod.

    Więcej informacji o limicie aplikacji w ramach projektu znajdziesz w sekcji Najczęstsze pytania.

  • Liczba witryn Hosting w projekcie

    Firebase HostingFunkcja wielu witryn obsługuje maksymalnie 36 witryn na projekt.

Uruchamianie aplikacji