Dodawanie Firebase do projektu na Androida

Wymagania wstępne

  • Zainstaluj lub zaktualizuj Android Studio do najnowszej wersji.

  • Upewnij się, że Twój projekt spełnia te wymagania (zauważ, że niektóre produkty mogą mieć bardziej rygorystyczne wymagania):

    • kierowana na poziom API 21 (Lollipop) lub wyższy;
    • Urządzenie z Androidem w wersji 5.0 lub nowszej,
    • Używa Jetpacka (AndroidX), który musi spełniać te wymagania dotyczące wersji:
      • com.android.tools.build:gradle w wersji 7.3.0 lub nowszej
      • compileSdkVersion 28 lub nowsza

  • Skonfiguruj urządzenie fizyczne lub użyj emulatora, aby uruchomić aplikację.
    Pamiętaj, że pakiety SDK Firebase zależne od usług Google Play wymagają zainstalowania usług Google Play na urządzeniu lub emulatorze.

  • Zaloguj się w Firebase, używając konta Google.

Jeśli nie masz jeszcze projektu na Androida i chcesz wypróbować usługę Firebase, możesz pobrać jeden z naszych sampli szybkiego startu.


Aplikację na Androida możesz połączyć z Firebase, korzystając z jednego z tych sposobów:

  • Opcja 1: (zalecane) użyj przepływu pracy konfiguracji konsoli Firebase.
  • Opcja 2: użyj Asystenta Firebase w Android Studio (może wymagać dodatkowej konfiguracji).


Opcja 1: dodaj Firebase w konsoli Firebase

Dodanie Firebase do aplikacji wymaga wykonania zadań zarówno w konsoli Firebase, jak i w otwartym projekcie na Androida (np. pobieranie plików konfiguracji Firebase z konsoli i przenoszenie ich do projektu na Androida).

Krok 1. Utwórz projekt Firebase

Zanim dodasz Firebase do aplikacji na Androida, musisz utworzyć projekt Firebase, aby połączyć go z tą aplikacją. Więcej informacji o projektach Firebase znajdziesz w artykule Informacje o projektach Firebase.

Krok 2. Zarejestruj aplikację w Firebase

Aby korzystać z Firebase w aplikacji na Androida, musisz ją zarejestrować w projekcie Firebase. Rejestrowanie aplikacji jest często nazywane „dodawaniem” aplikacji do projektu.

  1. Otwórz konsolę Firebase.

  2. W centrum strony „Opis” projektu kliknij ikonę Androida () lub Dodaj aplikację, aby uruchomić proces konfiguracji.

  3. W polu Nazwa pakietu na Androida wpisz nazwę pakietu aplikacji.

  4. (Opcjonalnie) Wpisz inne informacje o aplikacji: pseudonim aplikacji i certyfikat podpisywania debugowania SHA-1.

  5. Kliknij Zarejestruj aplikację.

Krok 3. Dodaj plik konfiguracji Firebase

  1. Pobierz plik konfiguracji Firebase na Androida (google-services.json) i dodaj go do aplikacji:

    1. Kliknij Pobierz plik google-services.json, aby pobrać plik konfiguracji Firebase na Androida.

    2. Przenieś plik konfiguracji do głównego katalogu modułu (poziom aplikacji).

  2. Aby udostępnić wartości w pliku konfiguracyjnym google-services.json pakietom SDK Firebase, musisz mieć wtyczkę Gradle dla usług Google (google-services).

    1. W pliku Gradle na poziomie głównym (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.2" 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.2' 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 modułu (na poziomie aplikacji) (zazwyczaj <project>/<app-module>/build.gradle.kts lub <project>/<app-module>/build.gradle) dodaj zależności dla usług Firebase, których chcesz używać w aplikacji. Zalecamy używanie parametru Firebase Android BoM do kontrolowania wersji bibliotek.

    Włączono Analytics 

    dependencies {
  // ...

  // Import the Firebase BoM
  implementation(platform("com.google.firebase:firebase-bom:33.11.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")
}

    Dzięki użyciu Firebase Android BoMaplikacja zawsze będzie używać zgodnych wersji bibliotek Firebase na Androida.

    Szukasz modułu biblioteki dla Kotlina? Od października 2023 r. (Firebase BoM 32.5.0) deweloperzy Kotlina i Java mogą korzystać z głównego modułu biblioteki (szczegółowe informacje znajdziesz w często zadawanych pytaniach dotyczących tej inicjatywy).

    Analytics nie jest włączona 

    dependencies {
  // ...

  // Import the Firebase BoM
  implementation(platform("com.google.firebase:firebase-bom:33.11.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")
}

    Dzięki użyciu Firebase Android BoMaplikacja zawsze będzie używać zgodnych wersji bibliotek Firebase na Androida.

    Szukasz modułu biblioteki dla Kotlina? Od października 2023 r. (Firebase BoM 32.5.0) deweloperzy Kotlina i Java mogą korzystać z głównego modułu biblioteki (szczegółowe informacje znajdziesz w często zadawanych pytaniach dotyczących tej inicjatywy).

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

To wszystko. Możesz pominąć ten krok i sprawdzić zalecane kolejne kroki.

Jeśli jednak masz problem z konfiguracją, zapoznaj się z artykułem Rozwiązywanie problemów z Androidem i najczęstsze pytania.


Opcja 2. Dodaj Firebase za pomocą Asystenta Firebase

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

  1. Otwórz projekt Androida w Android Studio, a potem sprawdź, czy używasz najnowszych wersji Android 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ń jej sekcję, a potem kliknij link do samouczka (np. Analytics > Rejestruj zdarzenie Analytics).

    1. Aby połączyć projekt na Androida z Firebase, kliknij Połącz z Firebase.

    2. Kliknij przycisk, aby dodać wybrany produkt Firebase (np. Dodaj Analytics do aplikacji).

  4. Zsynchronizuj aplikację, aby wszystkie zależności na pewno miały odpowiednie wersje.

  5. W panelu Asystent postępuj zgodnie z pozostałymi instrukcjami konfiguracji wybranej usługi Firebase.

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

To wszystko. Zapoznaj się z zalecanymi dalszymi czynnościami.

Jeśli jednak masz problem z konfiguracją, zapoznaj się z artykułem Rozwiązywanie problemów z Androidem i najczęstsze pytania.


Dostępne biblioteki

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

Pamiętaj, że w przypadku wersji Firebase Android BoM nie musisz określać wersji poszczególnych bibliotek podczas deklarowania zależności od bibliotek Firebase w pliku konfiguracji kompilacji Gradle.

Usługa lub produkt zależność Gradle, Najnowsza wersja
 Dodaj Analytics?
Firebase Android BoM
(Bill of Materials)		 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ą mapowane na konkretną wersję BoM, zapoznaj się z informacjami o tej wersji BoM.

 33.11.0
AdMob com.google.android.gms:play-services-ads 24.1.0
Analytics com.google.firebase:firebase-analytics 22.4.0
App Check dostawca niestandardowego com.google.firebase:firebase-appcheck 18.0.0
App Check dostawca debugowania com.google.firebase:firebase-appcheck-debug 18.0.0
App Check Usługodawca Play Integrity com.google.firebase:firebase-appcheck-playintegrity 18.0.0
App Distribution com.google.firebase:firebase-appdistribution 16.0.0-beta15
App Distribution API com.google.firebase:firebase-appdistribution-api 16.0.0-beta15
App Distributionwtyczka com.google.firebase:firebase-appdistribution-gradle 5.1.1
Authentication com.google.firebase:firebase-auth 23.2.0
Cloud Firestore com.google.firebase:firebase-firestore 25.1.3
Cloud Functions for Firebase Client SDK com.google.firebase:firebase-functions 21.2.0
Cloud Messaging com.google.firebase:firebase-messaging 24.1.1
Cloud Storage com.google.firebase:firebase-storage 21.0.1
Crashlytics com.google.firebase:firebase-crashlytics 19.4.2
Crashlytics NDK com.google.firebase:firebase-crashlytics-ndk 19.4.2
Crashlyticswtyczka com.google.firebase:firebase-crashlytics-gradle 3.0.3
Obsługa modułów funkcji dynamicznych com.google.firebase:firebase-dynamic-module-support 16.0.0-beta03
Dynamic Links com.google.firebase:firebase-dynamic-links 22.1.0
In-App Messaging com.google.firebase:firebase-inappmessaging 21.0.2
(wymagane)
In-App Messaging Sieć reklamowa com.google.firebase:firebase-inappmessaging-display 21.0.2
(wymagane)
Firebase instalacji com.google.firebase:firebase-installations 18.0.0
Firebase ML Model Downloader API com.google.firebase:firebase-ml-modeldownloader 25.0.1
Performance Monitoring com.google.firebase:firebase-perf 21.0.5
Performance Monitoringwtyczka com.google.firebase:perf-plugin 1.4.2
Realtime Database com.google.firebase:firebase-database 21.0.0
Remote Config com.google.firebase:firebase-config 22.1.0
Vertex AI in Firebase com.google.firebase:firebase-vertexai 16.2.0
wtyczka usług Google Play, com.google.gms:google-services 4.4.2
WYCOFANE BIBLIOTEKI
App Check Dostawca SafetyNet com.google.firebase:firebase-appcheck-safetynet 16.1.2
App Indexing com.google.firebase:firebase-appindexing 20.0.0

Moduły KTX Firebase

Analytics com.google.firebase:firebase-analytics-ktx 22.4.0
App Check dostawca niestandardowego com.google.firebase:firebase-appcheck-ktx 18.0.0
App Distribution API com.google.firebase:firebase-appdistribution-api-ktx 16.0.0-beta15
Authentication com.google.firebase:firebase-auth-ktx 23.2.0
Cloud Firestore com.google.firebase:firebase-firestore-ktx 25.1.3
Cloud Functions for Firebase Client SDK com.google.firebase:firebase-functions-ktx 21.2.0
Cloud Messaging com.google.firebase:firebase-messaging-ktx 24.1.1
Cloud Storage com.google.firebase:firebase-storage-ktx 21.0.1
Crashlytics com.google.firebase:firebase-crashlytics-ktx 19.4.2
Dynamic Links com.google.firebase:firebase-dynamic-links-ktx 22.1.0
In-App Messaging com.google.firebase:firebase-inappmessaging-ktx 21.0.2
(wymagane)
In-App Messaging Sieć reklamowa com.google.firebase:firebase-inappmessaging-display-ktx 21.0.2
(wymagane)
Firebase instalacji com.google.firebase:firebase-installations-ktx 18.0.0
Firebase ML Model Downloader API com.google.firebase:firebase-ml-modeldownloader-ktx 25.0.1
Performance Monitoring com.google.firebase:firebase-perf-ktx 21.0.5
Realtime Database com.google.firebase:firebase-database-ktx 21.0.0
Remote Config com.google.firebase:firebase-config-ktx 22.1.0

Biblioteki Firebase ML Kit

Firebase ML Interfejsy API modeli niestandardowych com.google.firebase:firebase-ml-model-interpreter 22.0.4
Firebase ML Interfejsy Vision API com.google.firebase:firebase-ml-vision 24.1.0
Firebase ML: model etykietowania obrazów com.google.firebase:firebase-ml-vision-image-label-model 20.0.2
Firebase ML: model wykrywania i śledzenia obiektów 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 kodu kreskowego com.google.firebase:firebase-ml-vision-barcode-model 16.1.2
Firebase ML: interfejs API AutoML Vision Edge com.google.firebase:firebase-ml-vision-automl 18.0.6
Firebase ML: interfejsy API języka naturalnego 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

Aby dodać usługi Firebase do aplikacji:

  • Uzyskaj statystyki dotyczące zachowań użytkowników za pomocą Analytics.

  • Skonfiguruj proces uwierzytelniania użytkownika za pomocą Authentication.

  • Przechowuj dane, np. informacje o użytkownikach, za pomocą Cloud Firestore lub Realtime Database.

  • Przechowuj pliki, takie jak zdjęcia i filmy, w Cloud Storage.

  • Aktywuj kod backendu, który działa w bezpiecznym środowisku za pomocą Cloud Functions.

  • Wysyłanie powiadomień za pomocą Cloud Messaging.

  • Dowiedz się, kiedy i dlaczego aplikacja się zawiesza, korzystając z funkcji Crashlytics.

Więcej informacji o Firebase: