Ogólne sprawdzone metody konfigurowania projektów Firebase
Zadbaj o dobrą organizację dzięki kolekcji
Zapisuj i kategoryzuj treści zgodnie ze swoimi preferencjami.
Na tej stronie znajdziesz ogólne, ogólne sprawdzone metody konfigurowania projektów Firebase i rejestrowania w nich aplikacji, aby mieć jasny przepływ pracy w przypadku tworzenia aplikacji, który wykorzystuje odrębne środowiska. Gdy zapoznasz się ze sprawdzonymi metodami opisanymi na tej stronie, przeczytaj ogólne wskazówki dotyczące bezpieczeństwa.
Hierarchia projektów Firebase
Ten diagram przedstawia podstawową hierarchię projektu Firebase. Oto najważniejsze relacje:
Projekt Firebase to kontener na wszystkie aplikacje oraz zasoby i usługi udostępnione w ramach projektu.
W projekcie Firebase może być zarejestrowanych co najmniej 1 aplikacja Firebase (np. wersja na iOS i Androida lub bezpłatna i płatna wersja aplikacji).
Wszystkie aplikacje Firebase zarejestrowane w tym samym projekcie Firebase mają dostęp do tych samych zasobów i usług udostępnionych dla tego projektu.
Oto przykłady:
Wszystkie aplikacje Firebase zarejestrowane w tym samym projekcie Firebase korzystają z tych samych backendów: Firebase Hosting, Authentication, Realtime Database, Cloud Firestore, Cloud Storage i Cloud Functions.
Wszystkie aplikacje Firebase zarejestrowane w tym samym projekcie Firebase są powiązane z tą samą usługą w Google Analytics, a każda aplikacja Firebase to osobny strumień danych w tej usłudze.
Gdzie w tej hierarchii mieści się projekt Google Cloud?
Jednym z elementów hierarchii projektu Firebase, który nie jest widoczny na diagramie powyżej, jest relacja z projektem Google Cloud. Projekt Firebase to tak naprawdę projekt Google Cloud z dodatkowymi konfiguracjami i usługami specyficznymi dla Firebase.
Pamiętaj, że wszystkie aplikacje zarejestrowane w tym samym projekcie Firebase udostępniają i mają dostęp do tych samych zasobów i usług Google Cloud.
Rejestrowanie wariantów aplikacji w projektach Firebase
Oto kilka ważnych wskazówek dotyczących rejestrowania wariantów aplikacji w projekcie Firebase:
Upewnij się, że wszystkie aplikacje zarejestrowane w projekcie Firebase są wariantami tej samej aplikacji z perspektywy użytkownika. Zarejestruj wersje na iOS, Androida i internet tej samej aplikacji lub gry w tym samym projekcie Firebase.
Jeśli masz kilka wersji kompilacji, które mogą dzielić te same zasoby Firebase, zarejestruj je w tym samym projekcie Firebase. Przykłady: blog i aplikacja internetowa w tym samym projekcie lub obie wersje (bezpłatna i płatna) tej samej aplikacji w tym samym projekcie.
Jeśli masz wiele wersji kompilacji, które różnią się stanem wydania (a nie typową aktywnością użytkownika lub dostępem, jak w przypadku powyżej), zarejestruj każdą wersję w oddzielnym projekcie Firebase. Przykładem jest kompilacja debugowania i kompilacja wersji – zarejestruj każdą z nich w oddzielnym projekcie Firebase.
Wersje kompilacji oparte na stanie wersji nie powinny udostępniać tych samych zasobów Firebase, ponieważ może to spowodować zanieczyszczenie lub nawet zastąpienie danych produkcyjnych danymi debugowania.
Wersje dla poszczególnych platform z tych wariantów kompilacji powinny znajdować się w tym samym projekcie Firebase. Na przykład zarejestruj wersje debugowania na iOS i Androida w „rozwijanym” projekcie Firebase, ponieważ obie mogą korzystać z tych samych nieprodukcyjnych danych i zasobów.
Unikanie środowiska wielu najemców
Wielodzierżalność może prowadzić do poważnych problemów z konfiguracją i prywatnością danych, w tym niezamierzonych problemów z agregacją danych, udostępnioną uwierzytelnianiem, zbyt skomplikowanymi strukturami baz danych i problemami z zasadami bezpieczeństwa.
Ogólnie jeśli zestaw aplikacji nie udostępnia tych samych danych i konfiguracji, warto zarejestrować każdą aplikację w oddzielnym projekcie Firebase.
Jeśli na przykład opracowujesz aplikację na potrzeby marki własnej, każda aplikacja z osobną etykietą powinna mieć własny projekt Firebase, a wersje na iOS i Androida tej samej etykiety powinny znajdować się w tym samym projekcie Firebase. Każda aplikacja z oświadczeniem dotyczącym prywatności nie powinna (ze względów związanych z prywatnością) udostępniać danych innym aplikacjom.
[[["Łatwo zrozumieć","easyToUnderstand","thumb-up"],["Rozwiązało to mój problem","solvedMyProblem","thumb-up"],["Inne","otherUp","thumb-up"]],[["Brak potrzebnych mi informacji","missingTheInformationINeed","thumb-down"],["Zbyt skomplikowane / zbyt wiele czynności do wykonania","tooComplicatedTooManySteps","thumb-down"],["Nieaktualne treści","outOfDate","thumb-down"],["Problem z tłumaczeniem","translationIssue","thumb-down"],["Problem z przykładami/kodem","samplesCodeIssue","thumb-down"],["Inne","otherDown","thumb-down"]],["Ostatnia aktualizacja: 2025-07-25 UTC."],[],[],null,["This page provides general, high-level best practices for setting up Firebase\nprojects and registering your apps with a project so that you have a clear\n[development workflow](/docs/projects/dev-workflows/overview-environments) that\nuse distinct environments. Once you're familiar with the best practices on this\npage, check out our\n[general security guidelines](/docs/projects/dev-workflows/general-security-guidelines).\n| **Key Point:** We recommend reading our guides thoroughly, but here's the top takeaway about development workflows: \n| **Firebase recommends using a *separate* Firebase project for *each* environment\n| in your development workflow.**\n\nUnderstanding the hierarchy of Firebase projects\n\n\nThis diagram shows the basic hierarchy of a Firebase project. Here are the key\nrelationships:\n\n- A **Firebase project** is like a container for all your apps and any resources\n and services provisioned for the project.\n\n- A Firebase project can have one or more **Firebase Apps** registered to it\n (for example, both the iOS and Android versions of an app, or both the free\n and paid versions of an app).\n\n- All Firebase Apps registered to the same Firebase project **share and have\n access to all the same resources and services provisioned for the project**.\n Here are some examples:\n\n - All the Firebase Apps registered to the same Firebase project share the same\n backends, like Firebase Hosting, Authentication, Realtime Database, Cloud Firestore,\n Cloud Storage, and Cloud Functions.\n\n - All Firebase Apps registered to the same Firebase project are associated\n with the same Google Analytics property, where each Firebase App is a\n separate data stream in that property.\n\nWhere does a Google Cloud project fit into this hierarchy?\n\nOne aspect of the Firebase project hierarchy that's not shown in the diagram\nabove is the relationship with a Google Cloud project. **A Firebase project is\nactually just a Google Cloud project that has additional *Firebase-specific*\nconfigurations and services enabled for it.**\nNote that all the apps registered to the same Firebase project also share and\nhave access to all the same Google Cloud resources and services, too.\n\nLearn more about the Firebase and Google Cloud relationship in\n[Understand Firebase projects](/docs/projects/learn-more#firebase-cloud-relationship)\n\nRegistering app variants with Firebase projects **Key Point:** All the apps registered to a Firebase project share and can access the same data as well as the resources and services provisioned for the project, which includes database instances, storage buckets, functions, etc.\n\nHere are some important tips for registering your app variants with a Firebase\nproject:\n\n- Ensure that all apps registered to a Firebase project are **platform variants\n of the same application** from an end-user perspective. Register the iOS,\n Android, and web versions of the same app or game with the *same* Firebase\n project.\n\n- If you have **multiple build variants that could *share the same Firebase\n resources*** , register the variants with the *same* Firebase project. Some\n examples are a blog and a web app in the same project, or both the free and\n paid versions of the same app in the same project.\n\n- If you have **multiple build variants that are *based on release status***\n (rather than on common end-user activity or access, like above), register each\n variant with a *separate* Firebase project. An example is your debug vs\n release build -- register each of these builds in its own Firebase project.\n\n - Builds based on release status should not share the same Firebase resources\n because that risks your debug data polluting or even overriding your prod\n data.\n\n - The *platform* -variants of each of these build variants should be in the\n *same* Firebase project. For example, register both the iOS and the Android\n debug builds in a \"dev\" Firebase project because they can both interact with\n the same non-prod data and resources.\n\n| **Note:** For each Android app, if you provide a SHA-1 key for the app, you need to provide a package name and SHA-1 key combination that is globally unique across all of Google Cloud.\n\nAvoiding multi-tenancy **Key Point:** Connecting several different logically independent apps and/or web sites to a single Firebase project (often called \"multi-tenancy\") is not recommended.\n\nMulti-tenancy can lead to serious configuration and data privacy concerns,\nincluding unintended issues with analytics aggregation, shared authentication,\noverly-complex database structures, and difficulties with security rules.\n\nGenerally, **if a set of apps don't share the same data and configurations,\nstrongly consider registering each app with a different Firebase project.**\n\nFor example, if you develop a white-label application, each independently\nlabeled app should have its own Firebase project, and the iOS and Android\nversions of that label should be in the same Firebase project. Each\nindependently labeled app shouldn't (for privacy reasons) share data with the\nothers.\n\nNext steps\n\n- Review the\n [general security guidelines](/docs/projects/dev-workflows/general-security-guidelines)\n for different environments. You want to make sure each environment and its\n data are secure.\n\n- Review the [Firebase launch checklist](/support/guides/launch-checklist)."]]
Ten diagram przedstawia podstawową hierarchię projektu Firebase. Oto najważniejsze relacje: