Dodawanie Firebase do projektu na Androida

Wymagania wstępne

  • Zainstaluj lub zaktualizuj Androida Studio do najnowszej wersji.

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

    • kierować aplikację co najmniej na poziom API 23 (Marshmallow);
    • Androida w wersji 6.0 lub nowszej,
    • Korzysta z Jetpacka (AndroidX), który 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ą, aby na urządzeniu lub emulatorze były zainstalowane usługi Google Play.

  • Zaloguj się w Firebase za pomocą konta Google.

Jeśli nie masz jeszcze projektu aplikacji na Androida, a chcesz tylko wypróbować usługę Firebase, możesz pobrać jeden z naszych przykładowych projektów.


Aplikację na Androida możesz połączyć z Firebase na jeden z tych sposobów:

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


Opcja 1: dodaj Firebase za pomocą Firebase konsoli

Dodanie Firebase do aplikacji wymaga wykonania czynności zarówno w Firebasekonsoli, jak i w otwartym projekcie aplikacji na Androida (np. pobierasz z konsoli pliki konfiguracyjne Firebase, a potem przenosisz je do projektu aplikacji na Androida).

Krok 1. Utwórz projekt w 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 zarejestrować aplikację w projekcie w Firebase. Rejestracja aplikacji jest często nazywana „dodawaniem” aplikacji do projektu.

  1. Otwórz Firebasekonsolę.

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

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

  4. (Opcjonalnie) wpisz pseudonim aplikacji, czyli wewnętrzny identyfikator ułatwiający rozpoznawanie aplikacji, który jest widoczny tylko dla Ciebie w Firebase konsoli.

  5. Kliknij Zarejestruj aplikację.

Krok 3. Dodaj plik konfiguracyjny Firebase

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

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

    2. Przenieś plik konfiguracyjny do głównego katalogu 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 Gradle usług Google (google-services).

    1. W pliku Gradle na poziomie 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.4" 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.4' 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 produktów Firebase, których chcesz używać w aplikacji. Zalecamy używanie Firebase Android BoM do kontrolowania obsługi wersji bibliotek.

    Włączono: Analytics 

    dependencies {
  // ...

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

    Gdy korzystamy z Firebase Android BoM, aplikacja zawsze używa zgodnych wersji bibliotek Firebase na Androida.

    Nie włączono Analytics 

    dependencies {
  // ...

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

    Gdy korzystamy z Firebase Android BoM, aplikacja zawsze używa zgodnych wersji bibliotek Firebase na Androida.

  2. Po dodaniu zależności dla produktów, których chcesz używać, zsynchronizuj projekt aplikacji na Androida z plikami Gradle.

To wszystko. Możesz przejść od razu do zalecanych kolejnych kroków.

Jeśli masz problemy z konfiguracją, zapoznaj się z tym artykułem.


Opcja 2. Dodawanie Firebase za pomocą funkcji Firebase Assistant

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

  1. Otwórz projekt aplikacji na Androida w Android Studio, a potem sprawdź, czy używasz najnowszych wersji Androida Studio i funkcji Firebase Assistant:

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

  2. Otwórz funkcję Firebase Assistant: 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 > Rejestrowanie zdarzenia Analytics).

    1. Aby połączyć projekt aplikacji 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 dodać dowolną liczbę innych usług Firebase.

To wszystko. Zapoznaj się z zalecanymi dalszymi krokami.

Jeśli masz problemy z konfiguracją, zapoznaj się z tym artykułem.


Dostępne biblioteki

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

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

Usługa lub produkt Zależność Gradle Najnowsza
wersja		 Dodać 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 wersji BoM.

 34.12.0
AdMob com.google.android.gms:play-services-ads 25.2.0
Firebase AI Logic 1 com.google.firebase:firebase-ai 17.11.0
Firebase AI Logic On-Device com.google.firebase:firebase-ai-ondevice 16.0.0-beta01
Firebase AI KSP com.google.firebase:firebase-ai-ksp-processor 16.0.1
Analytics com.google.firebase:firebase-analytics 23.2.0
App Check niestandardowy dostawca com.google.firebase:firebase-appcheck 19.0.2
App Check dostawca debugowania com.google.firebase:firebase-appcheck-debug 19.0.2
App Check Dostawca Play Integrity com.google.firebase:firebase-appcheck-playintegrity 19.0.2
App Distribution com.google.firebase:firebase-appdistribution 16.0.0-beta18
App Distribution API com.google.firebase:firebase-appdistribution-api 16.0.0-beta18
App Distribution wtyczka com.google.firebase:firebase-appdistribution-gradle 5.2.1
Authentication com.google.firebase:firebase-auth 24.0.1
Cloud Firestore com.google.firebase:firebase-firestore 26.2.0
Cloud Functions for Firebase Client SDK com.google.firebase:firebase-functions 22.1.1
Cloud Messaging com.google.firebase:firebase-messaging 25.0.1
Cloud Storage com.google.firebase:firebase-storage 22.0.1
Crashlytics com.google.firebase:firebase-crashlytics 20.0.5
Crashlytics NDK com.google.firebase:firebase-crashlytics-ndk 20.0.5
Crashlytics wtyczka com.google.firebase:firebase-crashlytics-gradle 3.0.7
SQL Connect 2 com.google.firebase:firebase-dataconnect 17.2.1
Obsługa modułów funkcji dynamicznych com.google.firebase:firebase-dynamic-module-support 16.0.0-beta04
In-App Messaging com.google.firebase:firebase-inappmessaging 22.0.3
(wymagane)
In-App Messaging Reklama displayowa com.google.firebase:firebase-inappmessaging-display 22.0.3
(wymagane)
Firebase instalacje com.google.firebase:firebase-installations 19.1.0
Firebase ML Model Downloader API com.google.firebase:firebase-ml-modeldownloader 26.0.2
Performance Monitoring com.google.firebase:firebase-perf 22.0.5
Performance Monitoring wtyczka com.google.firebase:perf-plugin 2.0.2
Firebase Phone Number Verification com.google.firebase:firebase-pnv 16.0.0
Realtime Database com.google.firebase:firebase-database 22.0.1
Remote Config com.google.firebase:firebase-config 23.0.1
Wtyczka usług Google Play com.google.gms:google-services 4.4.4
PRZESTARZAŁE LUB NIEWSPIERANE BIBLIOTEKI
Dynamic Links com.google.firebase:firebase-dynamic-links 22.1.0

Moduły Firebase KTX – nie są już obsługiwane

Analytics Nie używaj. Biblioteki modułu KTX nie są już obsługiwane.
com.google.firebase:firebase-analytics-ktx		 22.5.0
App Check niestandardowy dostawca Nie używaj. Biblioteki modułu KTX nie są już obsługiwane.
com.google.firebase:firebase-appcheck-ktx		 18.0.0
App Distribution API Nie używaj. Biblioteki modułu KTX nie są już obsługiwane.
com.google.firebase:firebase-appdistribution-api-ktx		 16.0.0-beta15
Authentication Nie używaj. Biblioteki modułu KTX nie są już obsługiwane.
com.google.firebase:firebase-auth-ktx		 23.2.1
Cloud Firestore Nie używaj; biblioteki modułu KTX nie są już obsługiwane.
com.google.firebase:firebase-firestore-ktx		 25.1.4
Cloud Functions for Firebase Client SDK Nie używaj. Biblioteki modułu KTX nie są już obsługiwane.
com.google.firebase:firebase-functions-ktx		 21.2.1
Cloud Messaging Nie używaj. Biblioteki modułu KTX nie są już obsługiwane.
com.google.firebase:firebase-messaging-ktx		 24.1.2
Cloud Storage Nie używaj. Biblioteki modułu KTX nie są już obsługiwane.
com.google.firebase:firebase-storage-ktx		 21.0.2
Crashlytics Nie używaj. Biblioteki modułu KTX nie są już obsługiwane.
com.google.firebase:firebase-crashlytics-ktx		 19.4.4
Dynamic Links Nie używaj. Biblioteki modułu KTX nie są już obsługiwane.
com.google.firebase:firebase-dynamic-links-ktx		 22.1.0
In-App Messaging Nie używaj; biblioteki modułu KTX nie są już obsługiwane.
com.google.firebase:firebase-inappmessaging-ktx		 21.0.2
(wymagane)
In-App Messaging Reklama displayowa Nie używaj. Biblioteki modułu KTX nie są już obsługiwane.
com.google.firebase:firebase-inappmessaging-display-ktx		 21.0.2
(wymagane)
Firebase instalacje Nie używaj. Biblioteki modułu KTX nie są już obsługiwane.
com.google.firebase:firebase-installations-ktx		 18.0.0
Firebase ML Model Downloader API Nie używaj. Biblioteki modułu KTX nie są już obsługiwane.
com.google.firebase:firebase-ml-modeldownloader-ktx		 25.0.1
Performance Monitoring Nie używaj. Biblioteki modułu KTX nie są już obsługiwane.
com.google.firebase:firebase-perf-ktx		 21.0.5
Realtime Database Nie używaj. Biblioteki modułu KTX nie są już obsługiwane.
com.google.firebase:firebase-database-ktx		 21.0.0
Remote Config Nie używaj. Biblioteki modułu KTX nie są już obsługiwane.
com.google.firebase:firebase-config-ktx		 22.1.2

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: Barcode Scanning Model com.google.firebase:firebase-ml-vision-barcode-model 16.1.2
Firebase ML: interfejs AutoML Vision Edge API com.google.firebase:firebase-ml-vision-automl 18.0.6
Firebase ML: interfejsy 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: Model tłumaczenia 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

1 Firebase AI Logic wcześniej nazywał się „Vertex AI in Firebase” w pakiecie com.google.firebase:firebase-vertexai.

2 Firebase SQL Connect nosiło wcześniej nazwę „Firebase Data Connect”


Dalsze kroki

Dodaj do aplikacji usługi Firebase:

  • Twórz funkcje generatywnej AI za pomocą modeli Gemini i Imagen, korzystając z Firebase AI Logic.

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

  • Skonfiguruj proces uwierzytelniania użytkowników 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 usłudze Cloud Storage.

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

  • Wysyłaj powiadomienia za pomocą Cloud Messaging.

  • Dowiedz się, kiedy i dlaczego aplikacja ulega awarii, korzystając z Crashlytics.

Więcej informacji o Firebase: