Google używa technologii AI do tłumaczenia treści na Twój preferowany język. Tłumaczenia wygenerowane przez AI mogą zawierać błędy.

Informacje o Firebase na Androida

Podczas tworzenia projektu aplikacji na Androida za pomocą Firebase możesz natknąć się na pojęcia, które są Ci nieznane lub specyficzne dla Firebase. Ta strona ma na celu odpowiedzieć na te pytania lub wskazać materiały, w których znajdziesz więcej informacji.

Jeśli masz pytania na temat, którego nie omawiamy na tej stronie, możesz zadać je w jednej z naszych społeczności online. Będziemy też okresowo aktualizować tę stronę o nowe tematy, więc sprawdzaj, czy nie dodaliśmy tematu, który Cię interesuje.

Wtyczka Firebase Assistant do Android Studio

Firebase Assistant to wtyczka do Android Studio, która rejestruje Twoją aplikację na Androida w projekcie w Firebase i dodaje do projektu aplikacji na Androida niezbędne pliki konfiguracyjne, wtyczki i zależności Firebase – wszystko to w Android Studio.

Aby korzystać z Firebase Assistant, postępuj zgodnie z instrukcjami na stronie Pierwsze kroki z Androidem. Upewnij się, że używasz najnowszych wersji Android Studio i Firebase Assistant (kliknij Plik > Sprawdź aktualizacje).

Gdy wybierzesz konkretne usługi Firebase, które chcesz dodać do aplikacji, Firebase Assistant automatycznie zadeklaruje wymagane zależności w pliku app/build.gradle. Jeśli chcesz używać Firebase Android BoM (zalecane), zaktualizuj zależności w pliku Gradle modułu (na poziomie aplikacji) (zwykle app/build.gradle), aby zaimportować platformę BoM. Musisz też usunąć wersje z każdego wiersza zależności biblioteki Firebase.

Ponadto, aby korzystać z niektórych usług Firebase, musisz włączyć interfejsy API lub udostępnić zasoby poza Android Studio. Instrukcje dotyczące każdej usługi w Firebase Assistant opisują dodatkowe działania, które musisz wykonać. Na przykład, aby korzystać z Cloud Firestore, musisz skonfigurować bazę danych i reguły w Firebase konsoli.

Usługi Google – wtyczka i plik konfiguracyjny

Aby dodać Firebase do projektu aplikacji na Androida, musisz dodać do projektu wtyczkę google-services i plik konfiguracyjny google-services.json do projektu.

Jeśli dodasz Firebase do projektu aplikacji na Androida za pomocą konsoli Firebase, interfejsu Management REST API, lub interfejsu Firebase CLI, musisz ręcznie dodać wtyczkę i plik konfiguracyjny do projektu. Jeśli jednak używasz Firebase Assistant, te zadania są wykonywane automatycznie podczas konfiguracji.

Więcej informacji o tym, jak współpracują ze sobą wtyczka i plik konfiguracyjny usług Google, znajdziesz w dokumentacji Androida.

Firebase Android BoM (Bill of Materials)

Firebase Android BoM (Bill of Materials) umożliwia zarządzanie wszystkimi wersjami bibliotek Firebase przez określenie tylko jednej wersji – wersji BoM.

Gdy używasz w aplikacji Firebase BoM, BoM automatycznie pobiera poszczególne wersje bibliotek przypisane do BoM's wersji. Wszystkie poszczególne wersje bibliotek będą zgodne. Gdy zaktualizujesz wersję BoM's w aplikacji, wszystkie biblioteki Firebase, których używasz w aplikacji, zostaną zaktualizowane do wersji przypisanych do tej wersji BoM.

Aby dowiedzieć się, które wersje bibliotek Firebase są przypisane do konkretnej wersji BoM , zapoznaj się z informacjami o wersji dla tej wersji BoM. Jeśli chcesz porównać wersje bibliotek przypisane do jednej BoM wersji z wersjami przypisanymi do innej BoM wersji, użyj widżetu porównania poniżej.

Dowiedz się więcej o obsłudze platform BoM w Gradle.

Oto jak używać Firebase Android BoM do deklarowania zależności w pliku Gradle modułu (na poziomie aplikacji) (zwykle app/build.gradle). Gdy używasz BoM, nie musisz określać poszczególnych wersji bibliotek w wierszach zależności.

dependencies {
  // Import the BoM for the Firebase platform
  implementation platform('com.google.firebase:firebase-bom:34.17.0')

  // Declare the dependencies for the desired Firebase products without specifying versions
  // For example, declare the dependencies for Firebase Authentication and Cloud Firestore
  implementation 'com.google.firebase:firebase-auth'
  implementation 'com.google.firebase:firebase-firestore'
}

Oto odpowiedzi na najczęstsze pytania dotyczące korzystania z Firebase Android BoM:

Jak używać innej wersji biblioteki niż ta, która jest określona w BoM?

Oto jak zastąpić wersję biblioteki określoną w BoM:

Zachowaj wiersz, aby zaimportować platformę BoM.

W wierszu zależności biblioteki określ żądaną wersję biblioteki. Oto na przykład, jak zadeklarować zależności, jeśli chcesz używać wersji 18.0.0 indeksowania aplikacjiApp Indexing niezależnie od wersji określonej w BoM, ale chcesz używać wersji BoM's w przypadku uwierzytelnianiaAuthentication i Cloud Firestore:

dependencies {
  // Import the BoM for the Firebase platform
  implementation platform('com.google.firebase:firebase-bom:34.17.0')

  // Declare the dependency for the App Indexing library and specify a version
  // This specified library version overrides the version designated in the BoM.
  implementation 'com.google.firebase:firebase-appindexing:18.0.0'

  // Declare the dependencies for the other Firebase libraries without specifying versions
  // These libraries will use the versions designated in the BoM.
  implementation 'com.google.firebase:firebase-auth'
  implementation 'com.google.firebase:firebase-firestore'
}

Czy BoM automatycznie dodaje do mojej aplikacji wszystkie biblioteki Firebase?

Nie. Aby dodać i używać bibliotek Firebase w aplikacji, musisz zadeklarować każdą bibliotekę jako osobny wiersz zależności w pliku Gradle modułu (na poziomie aplikacji) (zwykle app/build.gradle).

Używanie BoM zapewnia, że wersje wszystkich bibliotek Firebase w Twojej aplikacji są zgodne, ale BoM nie dodaje tych bibliotek Firebase do Twojej aplikacji.

Czy biblioteki rozszerzeń Kotlin (KTX) Firebase są obsługiwane przez BoM?

W lipcu 2025 r. (BoM w wersji 34.0.0) biblioteki rozszerzeń Kotlin (KTX) Firebase zostały usunięte z BoM. Jeśli używasz wersji BoM starszej niż 34.0.0, możesz nadal używać w aplikacji bibliotek KTX.

Zalecamy jednak migrację aplikacji, aby korzystała z interfejsów API KTX z modułów głównych . W przeciwnym razie nie będzie można aktualizować do nowszych wersji BoM, a tym samym do nowszych wersji bibliotek usług Firebase . Więcej informacji znajdziesz w najczęstszych pytaniach dotyczących tej inicjatywy.

Czy mogę używać BoM do dodawania bibliotek Androida, które nie pochodzą z Firebase?

Nie. Firebase Android BoM zarządza tylko wersjami bibliotek Firebase.

Dlaczego BoM jest zalecanym sposobem zarządzania wersjami bibliotek Firebase?

Chociaż każda biblioteka Firebase jest wersjonowana niezależnie, są one tworzone razem, aby zapewnić, że najnowsza wersja każdej biblioteki jest zgodna z innymi.

Dzięki używaniu BoM do zarządzania wersjami bibliotek Firebase w aplikacji nie musisz śledzić, która wersja biblioteki Firebase jest zgodna z inną biblioteką Firebase.

Nawet jeśli obecnie używasz w aplikacji tylko 1 biblioteki Firebase, nadal zalecamy używanie BoM, ponieważ nigdy nie wiadomo, kiedy możesz chcieć użyć innej biblioteki Firebase.

Moja aplikacja używa wersji Gradle starszej niż 5.0 – czy mogę nadal używać BoM?

Tak, możesz nadal używać BoM. W przypadku Gradle 5.0 i nowszych wersji obsługa BoM jest włączona automatycznie. W przypadku starszych wersji Gradle wystarczy włączyć funkcję BoM i zaimportować BoM nieco inaczej.BoMBoM

Do pliku settings.gradle dodaj enableFeaturePreview('IMPROVED_POM_SUPPORT').

Do pliku Gradle modułu (na poziomie aplikacji) (zwykle app/build.gradle) zaimportuj BoM jak zwykłą bibliotekę (bez platform modyfikatora), w ten sposób:

dependencies {
  // Import the Firebase BoM
  implementation 'com.google.firebase:firebase-bom:34.17.0'

  // Declare the dependencies for the desired Firebase products, without specifying versions
  // For example, declare the dependencies for Firebase Authentication and Cloud Firestore
  implementation 'com.google.firebase:firebase-auth'
  implementation 'com.google.firebase:firebase-firestore'
}

Jak zgłosić problem lub przesłać opinię na temat BoM?

Otwórz repozytorium (pakiet) SDK Firebase na Androida w GitHubie.

Porównywanie wersjiFirebase BoM

Moduły biblioteki rozszerzeń Kotlin (KTX)

Moduły funkcji i Play Feature Delivery

Od maja 2021 r. (Firebase BoM w wersji 28.0.0) pakiety SDK Firebase na Androida można używać w modułach funkcji dynamicznych, które są instalowane oddzielnie od modułu podstawowego aplikacji.

Aby włączyć obsługę modułów funkcji dynamicznych, dodaj tę zależność do pliku build.gradle modułu podstawowego:

dependencies {
  implementation 'com.google.firebase:firebase-dynamic-module-support:16.0.0-beta04'
}

Teraz, gdy masz już obsługę modułów dynamicznych, możesz dodawać zależności pakietu SDK Firebase (z Firebase BoM lub bez niego) do modułów funkcji aplikacji i używać ich tak jak zwykle.

Jeśli na przykład Twoja aplikacja używa Realtime Database do obsługi określonej funkcji w czasie rzeczywistym , możesz dodać zależność firebase-database do pliku build.gradle modułu funkcji, a nie modułu podstawowego. Zmniejszy to rozmiar pobierania dla większości użytkowników.

Pamiętaj o tych zastrzeżeniach podczas używania pakietów SDK Firebase w modułach funkcji:

Usługi takie jak Dynamic Links czy Firebase In-App Messaging, które korzystają ze zdarzenia Analytics first_open, mogą nie otrzymać tego zdarzenia, gdy są używane w module funkcji dynamicznych.
Gdy używasz Cloud Firestore i Authentication razem, zawsze umieszczaj je w tym samym module. Jeśli nie jest to możliwe, upewnij się, że Authentication jest wczytywane przed Cloud Firestore. W przeciwnym razie niektóre operacje Cloud Firestore mogą mieć nieprawidłowy stan uwierzytelniania.
Gdy używasz firebase-crashlytics-ndk jako zależności modułu funkcji dynamicznych, musisz ustawić właściwość unstrippedNativeLibsDir w pliku build.gradle aplikacji, jak opisano w dokumentacji Crashlytics NDK.

Więcej informacji o modułach funkcji i Play Feature Delivery znajdziesz w artykule Omówienie Play Feature Delivery.

Wtyczka Gradle usług Google a Usługi Google Play a Sklep Google Play

Kilka elementów ekosystemu Google, Firebase i Androida ma podobne konwencje nazewnictwa. Oto krótkie wyjaśnienie każdego z nich:

Wtyczka Gradle usług Google: Wtyczka Gradle (com.google.gms.google-services), która działa podczas kompilacji, aby zapewnić, że aplikacja ma odpowiednią konfigurację umożliwiającą dostęp do interfejsów API Firebase i Google APIs; Pomimo nazwy ta wtyczka nie jest powiązana z Usługami Google Play (patrz następny wpis) i nie ma wpływu na możliwości aplikacji w czasie działania.; Ta wtyczka przetwarza też plik google-services.json, który dodajesz do aplikacji w ramach konfigurowania Firebase. Dowiedz się więcej o wtyczce Gradle usług Google.
Usługi Google Play: Niewidoczna usługa działająca w tle na urządzeniu z Androidem, która udostępnia aplikacjom na urządzeniu kilka popularnych interfejsów API Google (takich jak Mapy Google i Logowanie przez Google).; Dzięki scentralizowaniu tych popularnych interfejsów API w jednej usłudze zmniejsza się rozmiar innych aplikacji, a urządzenie może otrzymywać automatyczne aktualizacje zabezpieczeń i ulepszenia funkcji bez aktualizacji systemu operacyjnego. Dowiedz się więcej o Usługach Google Play.
Sklep Google Play: Sklep, w którym można pobierać aplikacje, filmy, książki i inne treści na urządzeniu z Androidem.; Jako deweloper zarządzasz dystrybucją, wersjami itp. swojej aplikacji za pomocą Konsoli Google Play. Jeśli urządzenie ma Sklep Google Play, korzysta też z Usług Google Play (patrz poprzedni wpis). Dowiedz się więcej o Sklepie Google Play dla deweloperów.
Google Play Games services: Zestaw interfejsów API dla deweloperów gier mobilnych; Dowiedz się więcej o Google Play Games services i o tym, jak zintegrować Firebase z projektem Google Play Games services.

Zasoby open source dotyczące pakietów SDK Firebase na Androida

Firebase obsługuje rozwój open source i zachęcamy społeczność do współtworzenia i przesyłania opinii.

Pakiety SDK Firebase na Androida

Większość pakietów SDK Firebase na Androida jest tworzona jako biblioteki open source w naszym publicznym repozytorium Firebase w GitHubie. Aktywnie pracujemy nad tym, aby wkrótce przenieść pozostałe biblioteki Firebase opracowane prywatnie do naszego publicznego repozytorium w GitHubie.

Przykłady szybkiego startu

Firebase utrzymuje kolekcję przykładów szybkiego startu dla większości interfejsów API Firebase na Androida. Te przykłady szybkiego startu znajdziesz w naszym publicznym repozytorium Firebase w GitHubie.

Każdy przykład szybkiego startu możesz otworzyć jako projekt Android Studio, a następnie uruchomić go na urządzeniu mobilnym lub urządzeniu wirtualnym (AVD). Możesz też użyć tych przykładów szybkiego startu jako kodu przykładowego do używania pakietów SDK Firebase.