Dodaj Firebase do swojego projektu na Androida

Wymagania wstępne

  • Zainstaluj lub zaktualizuj Android Studio do najnowszej wersji.

  • Sprawdź, czy projekt spełnia te wymagania (pamiętaj, że niektóre usługi mogą mieć bardziej rygorystyczne wymagania):

    • Jest kierowana na interfejs API na poziomie 19 (KitKat) lub wyższym
    • Korzysta z Androida 4.4 lub nowszego
    • Wykorzystuje pakiet Jetpack (AndroidX), który spełnia te wymagania dotyczące wersji:
      • com.android.tools.build:gradle w wersji 7.3.0 lub nowszej
      • compileSdkVersion w wersji 28 lub nowszej

  • Skonfiguruj urządzenie fizyczne lub użyj emulatora do uruchamiania aplikacji.
    Pamiętaj, że pakiety SDK Firebase bazujące na usługach Google Playwymagają zainstalowania urządzenia lub usług Google Play.

  • Zaloguj się w Firebase, korzystając ze swojego konta Google.

Jeśli nie masz jeszcze projektu na Androida i chcesz wypróbować usługę Firebase, możesz pobrać krótkie wprowadzenie.


Swoją aplikację na Androida możesz połączyć z Firebase, korzystając z jednej z tych opcji:

  • Opcja 1: (zalecana) użyj procesu konfiguracji konsoli Firebase.
  • Opcja 2. Użyj Asystenta Firebase w Android Studio (może wymagać dodatkowej konfiguracji).


Opcja 1. Dodaj Firebase za pomocą konsoli Firebase

Dodanie Firebase do aplikacji obejmuje zadania wykonywane zarówno w konsoli Firebase, jak i w otwartym projekcie Androida (np. pobierasz z konsoli pliki konfiguracyjne Firebase, a potem przenosisz je do projektu Androida).

Krok 1. Utwórz projekt Firebase

Zanim dodasz Firebase do swojej aplikacji na Androida, musisz utworzyć projekt Firebase, który będzie połączony z tą aplikacją. Więcej informacji o projektach Firebase znajdziesz w artykule Omówienie projektów Firebase.

Krok 2. Zarejestruj aplikację w Firebase

Aby używać Firebase w swojej aplikacji na Androida, musisz ją zarejestrować w projekcie Firebase. Rejestracja aplikacji to często tzw. „dodanie” jej do projektu.

  1. Otwórz konsolę Firebase.

  2. Na środku strony przeglądu projektu kliknij ikonę Androida () lub Dodaj aplikację, aby uruchomić proces konfiguracji.

  3. Wpisz nazwę pakietu aplikacji w polu Nazwa pakietu na Androida.

  4. (Opcjonalnie) Wpisz inne informacje o aplikacji: Nazwa aplikacji i Certyfikat debugowania SHA-1.

  5. Kliknij Zarejestruj aplikację.

Krok 3. Dodaj plik konfiguracji Firebase

  1. Pobierz, a następnie dodaj do aplikacji plik konfiguracyjny Firebase na Androida (google-services.json):

    1. Kliknij Pobierz google-services.json, aby uzyskać plik konfiguracyjny Firebase na Androida.

    2. Przenieś plik konfiguracyjny do katalogu głównego modułu (na poziomie aplikacji) aplikacji.

  2. Aby wartości w pliku konfiguracyjnym google-services.json były dostępne dla pakietów SDK Firebase, potrzebujesz wtyczki do Gradle usług Google (google-services).

    1. W pliku Gradle głównym (na poziomie projektu) (<project>/build.gradle.kts lub <project>/build.gradle) dodaj wtyczkę usług Google jako zależność:

      Kotlin 

      plugins {
  id("com.android.application") version "7.3.0" apply false
  // ...

  // Add the dependency for the Google services Gradle plugin
  id("com.google.gms.google-services") version "4.4.1" apply false
}

      Groovy 

      plugins {
  id 'com.android.application' version '7.3.0' apply false
  // ...

  // Add the dependency for the Google services Gradle plugin
  id 'com.google.gms.google-services' version '4.4.1' apply false
}

    2. W pliku Gradle modułu (na poziomie aplikacji) (zwykle <project>/<app-module>/build.gradle.kts lub <project>/<app-module>/build.gradle) dodaj wtyczkę usług Google:

      Kotlin 

      plugins {
  id("com.android.application")

  // Add the Google services Gradle plugin
  id("com.google.gms.google-services")
  // ...
}

      Groovy 

      plugins {
  id 'com.android.application'

  // Add the Google services Gradle plugin
  id 'com.google.gms.google-services'
  // ...
}

Krok 4. Dodaj do aplikacji pakiety SDK Firebase

  1. W pliku Gradle na poziomie modułu (na poziomie aplikacji) (zwykle <project>/<app-module>/build.gradle.kts lub <project>/<app-module>/build.gradle) dodaj zależności usług Firebase, których chcesz używać w aplikacji. Do kontrolowania obsługi wersji biblioteki zalecamy używanie BOM Firebase na poziomie aplikacji.

    Analityka włączona 

    dependencies {
  // ...

  // Import the Firebase BoM
  implementation(platform("com.google.firebase:firebase-bom:33.0.0"))

  // When using the BoM, you don't specify versions in Firebase library dependencies

  // Add the dependency for the Firebase SDK for Google Analytics
  implementation("com.google.firebase:firebase-analytics")

  // TODO: Add the dependencies for any other Firebase products you want to use
  // See https://firebase.google.com/docs/android/setup#available-libraries
  // For example, add the dependencies for Firebase Authentication and Cloud Firestore
  implementation("com.google.firebase:firebase-auth")
  implementation("com.google.firebase:firebase-firestore")
}

    Jeśli używasz BOM Firebase na Androida, Twoja aplikacja zawsze będzie używała zgodnych wersji bibliotek Firebase na Androida.

    Szukasz modułu biblioteki specyficznego dla Kotlin? Od października 2023 r. (Firebase BoM w wersji 32.5.0) deweloperzy korzystający z Kotlin i Javy mogą korzystać z modułu biblioteki głównej (szczegółowe informacje znajdziesz w odpowiedziach na najczęstsze pytania na temat tej inicjatywy).

    Usługa Analytics nie jest włączona 

    dependencies {
  // ...

  // Import the Firebase BoM
  implementation(platform("com.google.firebase:firebase-bom:33.0.0"))

  // When using the BoM, you don't specify versions in Firebase library dependencies

  // TODO: Add the dependencies for Firebase products you want to use
  // See https://firebase.google.com/docs/android/setup#available-libraries
  // For example, add the dependencies for Firebase Authentication and Cloud Firestore
  implementation("com.google.firebase:firebase-auth")
  implementation("com.google.firebase:firebase-firestore")
}

    Jeśli używasz BOM Firebase na Androida, Twoja aplikacja zawsze będzie używała zgodnych wersji bibliotek Firebase na Androida.

    Szukasz modułu biblioteki specyficznego dla Kotlin? Od października 2023 r. (Firebase BoM w wersji 32.5.0) deweloperzy korzystający z Kotlin i Javy mogą korzystać z modułu biblioteki głównej (szczegółowe informacje znajdziesz w odpowiedziach na najczęstsze pytania na temat tej inicjatywy).

  2. Po dodaniu zależności usług, których chcesz używać, zsynchronizuj projekt na Androida z plikami Gradle.

To wszystko. Możesz przejść dalej i zapoznać się z zalecanymi dalszymi krokami.

Jeśli jednak masz problemy z konfiguracją, przeczytaj odpowiedzi na najczęstsze pytania i rozwiązywanie problemów z Androidem.


Opcja 2. Dodaj Firebase za pomocą Asystenta Firebase

Asystent Firebase rejestruje Twoją aplikację w projekcie Firebase i dodaje do tego projektu na Androida niezbędne pliki, wtyczki oraz zależności Firebase – wszystko to bezpośrednio w Android Studio.

  1. Otwórz projekt na Androida w Android Studio i sprawdź, czy używasz najnowszych wersji Androida Studio i Asystenta Firebase:

    • Windows / Linux: Pomoc > Sprawdź dostępność aktualizacji
    • macOS: Android Studio > Sprawdź dostępność aktualizacji

  2. Otwórz Asystenta Firebase: Narzędzia > Firebase.

  3. W panelu Asystent wybierz usługę Firebase, którą chcesz dodać do aplikacji. Rozwiń tę sekcję, a potem kliknij link do samouczka (np. Analytics > Zarejestruj zdarzenie Analytics).

    1. Kliknij Połącz z Firebase, aby połączyć z Firebase projekt na Androida.

    2. Kliknij przycisk, aby dodać wybraną usługę Firebase (np. Dodaj Analytics do aplikacji).

  4. Zsynchronizuj aplikację, aby upewnić się, że wszystkie zależności mają niezbędne wersje.

  5. W panelu Asystent wykonaj pozostałe instrukcje konfiguracji dla wybranej usługi Firebase.

  6. Za pomocą Asystenta Firebase możesz dodać dowolną liczbę innych usług Firebase.

To wszystko. Zapoznaj się z zalecanymi dalszymi krokami.

Jeśli jednak masz problemy z konfiguracją, przeczytaj odpowiedzi na najczęstsze pytania i rozwiązywanie problemów z Androidem.


Dostępne biblioteki

W tej sekcji znajdziesz listę usług Firebase obsługiwanych na Androidzie oraz ich zależności w ramach Gradle. Dowiedz się więcej o tych bibliotekach Firebase na Androida:

Pamiętaj, że w przypadku BOM Firebase na Androida nie określa się poszczególnych wersji biblioteki podczas deklarowania zależności biblioteki Firebase w pliku konfiguracji kompilacji Gradle.

Usługa lub produkt Zależność Gradle Najnowsza
wersja		 Dodać statystyki?
BOM Firebase na Androida
(zbiór materiałów)		 com.google.firebase:firebase-bom

Najnowsza wersja Firebase BoM zawiera najnowsze wersje każdej biblioteki Firebase na Androida. Aby dowiedzieć się, które wersje biblioteki są zmapowane na konkretną wersję BoM, zapoznaj się z informacjami o tej wersji BoM.

 33,0.0
AdMob com.google.android.gms:play-services-ads 23,0.0
Analytics com.google.firebase:firebase-analytics 22,0.0
Niestandardowy dostawca Sprawdzania aplikacji com.google.firebase:firebase-appcheck 18.0.0
Dostawca debugowania Sprawdzania aplikacji com.google.firebase:firebase-appcheck-debug 18.0.0
Dostawca funkcji Integrity funkcji Sprawdzania aplikacji com.google.firebase:firebase-appcheck-playintegrity 18.0.0
Rozpowszechnianie aplikacji com.google.firebase:firebase-appdistribution 16.0.0-beta12
App Distribution API com.google.firebase:firebase-appdistribution-api 16.0.0-beta12
Wtyczka App Distribution com.google.firebase:firebase-appdistribution-gradle 5,0
Uwierzytelnianie com.google.firebase:firebase-auth 23,0.0
Cloud Firestore. com.google.firebase:firebase-firestore 25,0.0
Pakiet SDK klienta Cloud Functions dla Firebase com.google.firebase:firebase-functions 21,0.0
Komunikacja w chmurze com.google.firebase:firebase-messaging 24:0
Cloud Storage, com.google.firebase:firebase-storage 21,0.0
Crashlytics com.google.firebase:firebase-crashlytics 19.0.0
Crashlytics NDK com.google.firebase:firebase-crashlytics-ndk 19.0.0
Wtyczka Crashlytics com.google.firebase:firebase-crashlytics-gradle 3.0.0
Obsługa modułu funkcji dynamicznych com.google.firebase:firebase-dynamic-module-support 16.0.0-beta03
Linki dynamiczne com.google.firebase:firebase-dynamic-links 22,0.0
Wysyłanie wiadomości w aplikacji com.google.firebase:firebase-inappmessaging 21,0.0
(wymagane)
Wyświetlanie wiadomości w aplikacji com.google.firebase:firebase-inappmessaging-display 21,0.0
(wymagane)
Instalacje Firebase com.google.firebase:firebase-installations 18.0.0
Interfejs Firebase ML Model Downloader API com.google.firebase:firebase-ml-modeldownloader 25,0.0
Monitorowanie wydajności com.google.firebase:firebase-perf 21,0.0
Wtyczka do monitorowania wydajności com.google.firebase:perf-plugin 1.4.2
Baza danych czasu rzeczywistego com.google.firebase:firebase-database 21,0.0
Zdalna konfiguracja com.google.firebase:firebase-config 22,0.0
Wtyczka Usług Google Play com.google.gms:google-services 4.4.1
BIBLIOTEKI WYCOFANE
Dostawca usługi SafetyNet do Sprawdzania aplikacji com.google.firebase:firebase-appcheck-safetynet 16.1.2
Indeksowanie aplikacji com.google.firebase:firebase-appindexing 20:0

Moduły KTX Firebase

Analytics com.google.firebase:firebase-analytics-ktx 22,0.0
Niestandardowy dostawca Sprawdzania aplikacji com.google.firebase:firebase-appcheck-ktx 18.0.0
App Distribution API com.google.firebase:firebase-appdistribution-api-ktx 16.0.0-beta12
Uwierzytelnianie com.google.firebase:firebase-auth-ktx 23,0.0
Cloud Firestore. com.google.firebase:firebase-firestore-ktx 25,0.0
Pakiet SDK klienta Cloud Functions dla Firebase com.google.firebase:firebase-functions-ktx 21,0.0
Komunikacja w chmurze com.google.firebase:firebase-messaging-ktx 24:0
Cloud Storage, com.google.firebase:firebase-storage-ktx 21,0.0
Crashlytics com.google.firebase:firebase-crashlytics-ktx 19.0.0
Linki dynamiczne com.google.firebase:firebase-dynamic-links-ktx 22,0.0
Wysyłanie wiadomości w aplikacji com.google.firebase:firebase-inappmessaging-ktx 21,0.0
(wymagane)
Wyświetlanie wiadomości w aplikacji com.google.firebase:firebase-inappmessaging-display-ktx 21,0.0
(wymagane)
Instalacje Firebase com.google.firebase:firebase-installations-ktx 18.0.0
Interfejs Firebase ML Model Downloader API com.google.firebase:firebase-ml-modeldownloader-ktx 25,0.0
Monitorowanie wydajności com.google.firebase:firebase-perf-ktx 21,0.0
Baza danych czasu rzeczywistego com.google.firebase:firebase-database-ktx 21,0.0
Zdalna konfiguracja com.google.firebase:firebase-config-ktx 22,0.0

Biblioteki Firebase ML Kit

Interfejsy API modeli niestandardowych Firebase ML com.google.firebase:firebase-ml-model-interpreter 22.0.4
Interfejsy Firebase ML Vision API com.google.firebase:firebase-ml-vision 24.1.0
Firebase ML: model dodawania etykiet do obrazów com.google.firebase:firebase-ml-vision-image-label-model 20.0.2
Firebase ML: wykrywanie obiektów i model śledzenia com.google.firebase:firebase-ml-vision-object-detection-model 19.0.6
Firebase ML: model wykrywania twarzy com.google.firebase:firebase-ml-vision-face-model 20.0.2
Firebase ML: model skanowania kodów kreskowych com.google.firebase:firebase-ml-vision-barcode-model 16.1.2
Firebase ML: AutoML Vision Edge API com.google.firebase:firebase-ml-vision-automl 18.0.6
Firebase ML: Natural Language API com.google.firebase:firebase-ml-natural-language 22.0.1
Firebase ML: model identyfikacji języka com.google.firebase:firebase-ml-natural-language-language-id-model 20.0.8
Firebase ML: tłumaczenie modelu com.google.firebase:firebase-ml-natural-language-translate-model 20.0.9
Firebase ML: model inteligentnej odpowiedzi com.google.firebase:firebase-ml-natural-language-smart-reply-model 20.0.8


Dalsze kroki

Dodaj usługi Firebase do aplikacji:

Więcej informacji o Firebase: