Dowiedz się więcej o Androidzie i Firebase

Podczas opracowywania projektu na Androida przy użyciu Firebase możesz odkryć pojęcia, które są nieznane lub specyficzne dla Firebase. Ta strona ma na celu odpowiedzieć na te pytania lub wskazać zasoby, aby dowiedzieć się więcej.

Jeśli masz pytania dotyczące tematu nieobjętym na tej stronie, zapraszamy do odwiedzenia jednego z naszych społecznościach internetowych . Będziemy również okresowo aktualizować tę stronę o nowe tematy, więc sprawdź ponownie, czy nie dodaliśmy tematu, o którym chcesz się dowiedzieć!

Wtyczka Firebase Assistant dla Android Studio

Asystent Firebase to wtyczka Android Studio, która rejestruje Twoją aplikację na Androida w projekcie Firebase i dodaje niezbędne pliki konfiguracyjne, wtyczki i zależności Firebase do Twojego projektu na Androida — wszystko z poziomu Android Studio!

Postępuj zgodnie z instrukcjami wyświetlanymi w Androidzie PRZYGOTOWANIA stronę używać Firebase Assistant. Upewnij się, że używasz Najbardziej aktualne wersje zarówno Studio Android i Firebase Assistant (przejdź do menu Plik> Sprawdź aktualizacje).

Po wybraniu konkretnych produktów Firebase dodać do swojej aplikacji, Firebase Assistant automatycznie deklaruje wymaganych zależności w swojej app/build.gradle pliku. Aby jednak korzystać z funkcji Firebase, które wykraczają poza obecne możliwości Asystenta Firebase, warto ręcznie wprowadzić pewne zmiany w tych zależnościach:

  • Jeśli chcesz użyć Firebase Android Bom , zaktualizuj zależności w module (app-level) Gradle plik (zazwyczaj app/build.gradle ) importować platformę Bom. Musisz też usunąć wersje z każdego wiersza zależności biblioteki Firebase.

  • Jeśli chcesz korzystać z biblioteki Kotlin rozszerzeń , modyfikować linia zależność dodany do modułu (ok szczebla) Gradle plik (zazwyczaj app/build.gradle ) do korzystania z ktx wersję biblioteki Firebase zamiast.

Usługi Google — wtyczka i plik konfiguracyjny

W ramach dodanie Firebase do projektu Android, trzeba dodać google-services plugin i do google-services.json plik konfiguracyjny do projektu.

Jeśli dodać Firebase do projektu Android za pośrednictwem konsoli Firebase , w API Zarządzanie REST , lub Firebase CLI , należy ręcznie dodać wtyczki i plik konfiguracyjny do projektu. Jednakże, jeśli używasz Firebase Assistant , zadania te są wykonywane automatycznie przez Ciebie podczas konfiguracji.

Odwiedź Android dokumentację , aby dowiedzieć się o tym, jak usługi Google wtyczki i plik konfiguracyjny razem.

Firebase Android BoM (zestawienie materiałów)

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

Gdy korzystasz z Firebase BoM w swojej aplikacji, BoM automatycznie pobiera poszczególne wersje biblioteki zmapowane na wersję BoM. Wszystkie poszczególne wersje bibliotek będą kompatybilne. Gdy zaktualizujesz wersję BoM w swojej aplikacji, wszystkie biblioteki Firebase, których używasz w swojej aplikacji, zostaną zaktualizowane do wersji zmapowanych na tę wersję BoM.

Aby dowiedzieć się, które wersje bibliotek Firebase są przypisane do konkretnej wersji BOM, sprawdź informacje o wydaniu dla tej wersji BOM. Jeśli trzeba porównać wersje bibliotek odwzorowanych jednej z wersji w porównaniu do Bom Bom innej wersji, należy użyć porównania widget poniżej.

Dowiedz się więcej o wsparciu Gradle za platformach Bom .

Oto jak korzystać z Firebase Android BOM się zależnościami deklarować w module (app szczebla) Gradle plik (zazwyczaj app/build.gradle ). Używając BoM, nie określasz poszczególnych wersji bibliotek w wierszach zależności.

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

  // 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 kilka najczęściej zadawanych pytań dotyczących korzystania z Firebase Android BoM:

Porównaj wersje Firebase BoM

Biblioteki rozszerzeń Kotlin (KTX)

Biblioteki rozszerzeń Firebase Kotlin (KTX) są małymi towarzyszami podstawowych zestawów SDK Firebase, które pozwalają pisać piękny i idiomatyczny kod Kotlin.

Aby korzystać z biblioteki KTX w swojej aplikacji, aby zmienić swoje uzależnienie obejmują -ktx przyrostek. Każda biblioteka KTX automatycznie ma zależność od biblioteki podstawowej, więc nie ma potrzeby uwzględniania obu zależności w aplikacji.

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

  // Declare the base library
  implementation 'com.google.firebase:firebase-analytics'

  // Declare the KTX library instead (which automatically has a dependency on the base library)
  implementation 'com.google.firebase:firebase-analytics-ktx'
}

Każda biblioteka KTX zapewnia różne rozszerzenia składniowe biblioteki podstawowej. Na przykład biblioteka Analytics KTX ułatwia rejestrowanie zdarzeń:

Przed (z wykorzystaniem biblioteki bazowy)

val analytics = FirebaseAnalytics.getInstance();
val bundle = Bundle();
bundle.putString(FirebaseAnalytics.Param.ITEM_ID, id);
bundle.putString(FirebaseAnalytics.Param.ITEM_NAME, name);
bundle.putString(FirebaseAnalytics.Param.CONTENT_TYPE, "image");
analytics.logEvent(FirebaseAnalytics.Event.SELECT_ITEM, bundle);

Po (z wykorzystaniem biblioteki KTX zamiast)

firebaseAnalytics.logEvent(FirebaseAnalytics.Event.SELECT_ITEM) {
    param(FirebaseAnalytics.Param.ITEM_ID, id)
    param(FirebaseAnalytics.Param.ITEM_NAME, name)
    param(FirebaseAnalytics.Param.CONTENT_TYPE, "image")
}

Wszystkie produkty Firebase oferują biblioteki KTX wyjątkiem Firebase ML i indeksowania aplikacji.

Jeśli nie masz jeszcze sprawdzić dokumenty referencyjne API dla bibliotek KTX.

Moduły funkcji i dostarczanie funkcji Play

Od maja 2021 r. (Firebase BoM 28.0.0) pakiety Firebase Android SDK mogą być używane w dynamicznych modułach funkcji, które są instalowane niezależnie od podstawowego modułu aplikacji.

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

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

Teraz, po dodaniu obsługi modułów dynamicznych, możesz dodać zależności pakietu Firebase SDK (z zestawem Firebase BoM lub bez niego), aby wyróżnić moduły swojej aplikacji i używać ich w normalny sposób.

Na przykład, jeśli aplikacja korzysta z bazy danych w czasie rzeczywistym do władzy specyficzny realtime wyposażone można dodać firebase-database zależność do build.gradle modułu funkcji zamiast modułu bazowego. Zmniejszy to rozmiar pobierania dla większości użytkowników.

Podczas korzystania z pakietów SDK Firebase w modułach funkcji pamiętaj o następujących zastrzeżeniach:

  • Produkty takie jak dynamiczne linki lub Firebase In-App Wiadomości, które polegają na Analytics first_open zdarzenia mogą przegapić tego wydarzenia przy zastosowaniu w module funkcji dynamiczne.

  • Używając jednocześnie Cloud Firestore i uwierzytelniania, należy je zawsze uwzględniać w tym samym module. Jeśli nie jest to możliwe, a następnie upewnij się, że uwierzytelnianie jest ładowany przed chmurze FireStore; w przeciwnym razie niektóre operacje Cloud Firestore mogą mieć nieprawidłowy stan uwierzytelniania.

  • Podczas korzystania firebase-crashlytics-ndk jako zależność modułu funkcji dynamicznych, trzeba ustawić unstrippedNativeLibsDir nieruchomość w Twojej aplikacji build.gradle pliku, jak opisano w dokumentacji Crashlytics NDK .

Aby uzyskać więcej informacji na temat modułów funkcji Feature Delivery and Play, odwiedź Omówienie funkcja odtwarzania produktu .

Usługi Google Wtyczka Gradle vs Usługi Google Play vs Sklep Google Play

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

Wtyczka Gradle usług Google
Gradle wtyczki ( com.google.gms.google-services ), który działa w czasie kompilacji, aby upewnić się, że aplikacja ma właściwą konfigurację dostępu Firebase i Google API
Pomimo swojej nazwy wtyczka ta nie ma związku z usługami Google Play (patrz następny wpis) i nie ma wpływu na możliwości Twojej aplikacji w czasie wykonywania.
Wtyczka ta przetwarza również google-services.json plik, który dodasz do swojej aplikacji w ramach konfigurowania Firebase. Więcej informacji na temat usług Gradle wtyczki Google .
Usługi Google Play
Niewidoczna usługa działająca w tle, która działa na urządzeniu z Androidem i udostępnia kilka popularnych interfejsów API Google (takich jak Mapy Google i Logowanie Google) do aplikacji na urządzeniu
Scentralizowanie tych wspólnych interfejsów API w jednej usłudze zmniejsza rozmiar innych aplikacji i umożliwia urządzeniu otrzymywanie automatycznych aktualizacji zabezpieczeń i ulepszeń funkcji bez aktualizacji systemu operacyjnego. Więcej informacji na temat usługi Google Play .
Sklep Google Play
Sklep do pobierania aplikacji, filmów, książek i innych materiałów na urządzenie z Androidem
Jako programista zarządzasz dystrybucją, wydaniami itp. swojej aplikacji za pośrednictwem Konsoli Google Play. Jeśli na urządzeniu jest sklep Google Play, są na nim również uruchomione usługi Google Play (patrz poprzedni wpis). Dowiedz się więcej o Sklepie Google Play dla programistów .
Usługi gier Google Play
Zestaw API dla twórców gier mobilnych
Dowiedz się więcej o Google Play Games i jak zintegrować Firebase ze swoimi Gry Google Play wystają usługi .

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

Firebase wspiera rozwój oprogramowania typu open source i zachęcamy do publikowania wkładów i opinii społeczności.

Pakiety SDK Firebase na Androida

Większość Firebase Android SDK są opracowywane jako biblioteki open source w naszym publicznym repozytorium Firebase GitHub . Aktywnie pracujemy nad przeniesieniem pozostałych prywatnie opracowanych bibliotek Firebase do naszego publicznego serwisu GitHub!

Próbki szybkiego startu

Firebase utrzymuje kolekcję przykładów szybkiego startu dla większości interfejsów API Firebase na Androida. Znajdź te quickstarts w naszym publicznym Firebase GitHub szybkiego startu repozytorium .

Każdy przewodnik Szybki start można 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 przewodników Szybki start jako przykładowego kodu do korzystania z pakietów SDK Firebase.

Inne interesujące tematy