Ta strona została przetłumaczona przez Cloud Translation API.

Informacje o Firebase na Androida

Podczas tworzenia projektu na Androida za pomocą Firebase możesz natrafić na pojęcia, które są Ci nieznane lub specyficzne dla Firebase. Na tej stronie znajdziesz odpowiedzi na te pytania lub zasoby, które pomogą Ci dowiedzieć się więcej.

Jeśli masz pytania dotyczące tematu, którego nie ma na tej stronie, odwiedź jedną z naszych społeczności online. Będziemy też okresowo aktualizować tę stronę o nowe tematy, więc zaglądaj tu, aby sprawdzić, czy dodaliśmy temat, który Cię interesuje.

Wtyczka Asystent Firebase do Android Studio

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

Aby użyć Asystenta Firebase, postępuj zgodnie z instrukcjami na stronie dla początkujących użytkowników Androida. Sprawdź, czy używasz najnowszych wersji Android Studio i Asystenta Firebase (kliknij Plik > Sprawdź aktualizacje).

Gdy wybierzesz konkretne usługi Firebase, które chcesz dodać do aplikacji, Asystent Firebase 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.

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

Usługi Google – wtyczka i plik konfiguracyjny

W ramach dodawania Firebase do projektu na Androida musisz dodać do niego wtyczkę google-services i plik konfiguracyjny google-services.json.

Jeśli dodasz Firebase do projektu na Androida za pomocą Firebasekonsoli, interfejsu API REST do zarządzania lub Firebaseinterfejsu wiersza poleceń, musisz ręcznie dodać wtyczkę i plik konfiguracyjny do projektu. Jeśli jednak używasz Asystenta Firebase, te zadania są wykonywane automatycznie podczas konfiguracji.

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

Firebase Android BoM (Bill of Materials)

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

Gdy używasz Firebase BoM w aplikacji, BoM automatycznie pobiera poszczególne wersje biblioteki mapowane na wersję BoM. Wszystkie poszczególne wersje biblioteki będą ze sobą zgodne. Gdy zaktualizujesz wersję BoM 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ą powiązane z określoną wersją BoM, zapoznaj się z informacjami o wersji BoM. Jeśli chcesz porównać wersje bibliotek przypisane do jednej wersji z inną wersją, użyj poniższego widżetu porównania.BoMBoM

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

Aby zadeklarować zależności w pliku Gradle modułu (na poziomie aplikacji) (zwykle app/build.gradle), użyj znaku Firebase Android BoM. Jeśli 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.0.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 wskazana w BoM?

Aby zastąpić wersję biblioteki określoną w pliku BoM:

Zachowaj wiersz, aby zaimportować platformę BoM.

W wierszu zależności biblioteki podaj wybraną wersję biblioteki. Oto przykład deklarowania zależności, jeśli chcesz używać wersji 18.0.0 pakietu App Indexing niezależnie od wersji wskazanej w BoM,ale chcesz używać wersji pakietu BoM w przypadku Authentication i Cloud Firestore:

dependencies {
  // Import the BoM for the Firebase platform
  implementation platform('com.google.firebase:firebase-bom:34.0.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ć biblioteki Firebase do aplikacji i ich używać, musisz zadeklarować każdą bibliotekę jako osobną linię zależności w pliku Gradle modułu (na poziomie aplikacji) (zwykle app/build.gradle).

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

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

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

Zalecamy jednak przeniesienie aplikacji, aby korzystała z interfejsów API KTX z głównych modułów. W przeciwnym razie nie będzie można zaktualizować jej 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żyć BoM, aby dodać biblioteki 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 biblioteki Firebase?

Chociaż każda biblioteka Firebase ma własną wersję, są one tworzone razem, aby zapewnić, że najnowsza wersja każdej biblioteki jest zgodna z pozostałymi.

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

Nawet jeśli w aplikacji używasz obecnie tylko 1 biblioteki Firebase, zalecamy korzystanie z BoM, ponieważ nigdy nie wiadomo, kiedy zechcesz użyć innej biblioteki Firebase.

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

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

Dodaj do pliku settings.gradle te informacje:enableFeaturePreview('IMPROVED_POM_SUPPORT')

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

dependencies {
  // Import the Firebase BoM
  implementation 'com.google.firebase:firebase-bom:34.0.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ę o BoM?

Otwórz repozytorium pakietu Firebase Android SDK w GitHubie.

Porównanie wersji Firebase BoM

Moduły biblioteki rozszerzeń Kotlin (KTX)

Interfejsy API rozszerzeń Kotlin (KTX) zostały dodane do odpowiednich modułów głównych. Na przykład wszystkie interfejsy API z firebase-perf-ktx zostały dodane do firebase-perf w pakiecie com.google.firebase.perf. Ta zmiana oznacza, że deweloperzy Kotlin powinni teraz korzystać z modułów głównych zamiast modułów KTX (gdy używają Firebase BoM w wersji 32.5.0 lub nowszej albo wersji modułu głównego wymienionych w BoM w wersji 32.5.0 lub nowszej).

W lipcu 2025 r. przestaliśmy udostępniać nowe wersje modułów KTX i usunęliśmy biblioteki KTX z Firebase Android BoM (wersja 34.0.0).

Jeśli używasz interfejsów KTX API z wcześniej opublikowanych modułów KTX, zalecamy przeniesienie aplikacji, aby zamiast tego korzystała z interfejsów KTX API z modułów głównych. Więcej informacji znajdziesz w najczęstszych pytaniach dotyczących tej inicjatywy.

Moduły funkcji i Play Feature Delivery

Od maja 2021 r. (Firebase BoM w wersji 28.0.0) pakiety SDK Firebase na Androida mogą być używane w modułach funkcji dynamicznych, które są instalowane oddzielnie od podstawowego modułu 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'
}

Po dodaniu obsługi modułów dynamicznych możesz dodać zależności pakietu SDK Firebase (z Firebase BoM lub bez niego) do modułów funkcji aplikacji i używać ich w normalny sposób.

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

Podczas korzystania z pakietów SDK Firebase w modułach funkcji pamiętaj o tych ograniczeniach:

Usługi takie jak Dynamic Links czy Firebase In-App Messaging, które korzystają ze zdarzenia Analytics first_open, mogą nie rejestrować tego zdarzenia, gdy są używane w dynamicznym module funkcji.
Jeśli 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.
Jeśli używasz firebase-crashlytics-ndk jako zależności modułu funkcji dynamicznej, musisz ustawić właściwość unstrippedNativeLibsDir w pliku build.gradle aplikacji, zgodnie z opisem w Crashlyticsdokumentacji NDK.

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

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

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

Wtyczka Gradle usług Google: Wtyczka Gradle (com.google.gms.google-services), która jest uruchamiana w czasie kompilacji, aby sprawdzić, czy aplikacja ma odpowiednią konfigurację umożliwiającą dostęp do interfejsów API Firebase i Google.; 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.; Ten wtyczka przetwarza też plik google-services.json, który dodajesz do aplikacji w ramach konfigurowania Firebase. Dowiedz się więcej o wtyczce Gradle do 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 (np. 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ądzenie z Androidem.; Jako deweloper zarządzasz dystrybucją, wersjami itp. 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 usługach gier Google Play i o tym, jak zintegrować Firebase z projektem usług gier Google Play.

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

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

Pakiety Firebase SDK na Androida

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

Przykłady krótkich wprowadzeń

Firebase udostępnia kolekcję przykładów szybkiego startu dla większości interfejsów API Firebase na Androida. Te krótkie przewodniki znajdziesz w naszym publicznym repozytorium GitHub z krótkimi przewodnikami po Firebase.

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