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 (pamiętaj, że niektóre usługi mogą mieć bardziej rygorystyczne wymagania):

    • jest kierowana na interfejs API na poziomie 24 (Nougat) lub wyższym;
    • ma system Android 7.0 lub nowszy,
    • używa Jetpacka (AndroidX), co obejmuje spełnienie tych wymagań dotyczących wersji:
      • com.android.tools.build:gradle w wersji 7.3.0 lub nowszej
      • compileSdkVersion 28 lub nowsza wersja,
  • Skonfiguruj urządzenie fizyczne lub użyj emulatora, aby uruchomić aplikację.
    Pamiętaj, że pakiety SDK Firebase zależne od Google Play services wymagają, aby na urządzeniu lub emulatorze była zainstalowana usługa Google Play services.

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


Możesz połączyć aplikację na Androida 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 wymaga wykonania zadań zarówno w konsoli Firebase, jak i w otwartym projekcie aplikacji na Androida (np. pobrania plików konfiguracji Firebase z konsoli, a następnie przeniesienia ich do projektu aplikacji na Androida).

Krok 1. Utwórz projekt w Firebase.

Zanim dodasz Firebase do aplikacji na Androida, musisz utworzyć projekt w Firebase, aby połączyć go z tą aplikacją. Aby dowiedzieć się więcej o projektach w Firebase, przeczytaj artykuł Informacje o projektach Firebase.

Krok 2. Zarejestruj aplikację w Firebase

Aby używać Firebase w aplikacji na Androida, musisz zarejestrować aplikację w projekcie w Firebase. Rejestrowanie aplikacji jest często nazywane „dodawaniem” aplikacji do projektu.

  1. Otwórz konsolę Firebase.

  2. Na środku strony Przegląd 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 pseudonim aplikacji, który jest wewnętrznym, wygodnym identyfikatorem widocznym tylko dla Ciebie w konsoli Firebase.

  5. Kliknij Zarejestruj aplikację.

Krok 3. Dodaj plik konfiguracji Firebase

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

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

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

  2. Aby wartości w pliku konfiguracji 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 (poziomie projektu) (<project>/build.gradle.kts lub <project>/build.gradle) dodaj wtyczkę Gradle 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.6.0" 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.6.0' apply false
      }
    2. W pliku Gradle na poziomie modułu (aplikacji) (zwykle <project>/<app-module>/build.gradle.kts lub <project>/<app-module>/build.gradle) dodaj wtyczkę Gradle 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) (zwykle <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. Do kontrolowania wersji biblioteki zalecamy używanie Firebase Android BoM.

    Model Analytics został włączony

    dependencies {
      // ...
    
      // Import the Firebase BoM
      implementation(platform("com.google.firebase:firebase-bom:35.2.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:35.2.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 usług, których chcesz używać, zsynchronizuj projekt aplikacji na Androida z plikami Gradle.

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

Jeśli masz problemy z konfiguracją, zapoznaj się z najczęstszymi pytaniami i rozwiązaniami problemów na Androidzie.



Opcja 2. Dodaj Firebase za pomocą funkcji Firebase Assistant

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

  1. Otwórz projekt aplikacji na Androida w Android Studio, a następnie upewnij się, że używasz najnowszych wersji Android Studio i funkcji Firebase Assistant:

    • Windows / Linux: Pomoc > Sprawdź dostępność aktualizacji
    • macOS: Android Studio > Sprawdź aktualizacje
  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 następnie kliknij link do samouczka (np. Analytics > Rejestruj zdarzenie Analytics).

    1. Kliknij Connect to Firebase (Połącz z Firebase), aby połączyć projekt aplikacji na Androida z Firebase.

    2. Kliknij przycisk, aby dodać usługę 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. Dodaj dowolną liczbę innych usług Firebase za pomocą asystenta Firebase.

To wszystko. Zapoznaj się z zalecanymi dalszymi krokami.

Jeśli masz problemy z konfiguracją, zapoznaj się z najczęstszymi pytaniami i rozwiązaniami problemów na Androidzie.



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ć poszczególnych wersji bibliotek, gdy deklarujesz 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 wszystkich bibliotek Firebase na Androida. Aby dowiedzieć się, które wersje biblioteki są mapowane na konkretną wersję BoM, zapoznaj się z informacjami o wersji BoM.

35.2.0
Wtyczka Gradle usług Google com.google.gms:google-services 4.6.0
AdMob com.google.android.gms:play-services-ads 25.5.0
Firebase AI Logic 1 com.google.firebase:firebase-ai 18.2.0
Firebase AI Logic On-Device com.google.firebase:firebase-ai-ondevice 16.0.0-beta08
Firebase AI KSP com.google.firebase:firebase-ai-ksp-processor 17.0.0
Analytics com.google.firebase:firebase-analytics 24.0.0
App Check niestandardowy dostawca com.google.firebase:firebase-appcheck 20.1.0
Dostawca debugowania App Check com.google.firebase:firebase-appcheck-debug 20.1.0
Dostawca Play Integrity App Check com.google.firebase:firebase-appcheck-playintegrity 20.1.0
Dostawca reCAPTCHA App Check com.google.firebase:firebase-appcheck-recaptcha 20.1.0
App Distribution com.google.firebase:firebase-appdistribution 16.0.0-beta21
App Distribution API com.google.firebase:firebase-appdistribution-api 16.0.0-beta21
Wtyczka App Distribution com.google.firebase:firebase-appdistribution-gradle 5.3.1
Authentication com.google.firebase:firebase-auth 25.0.0
Cloud Firestore com.google.firebase:firebase-firestore 27.2.0
Cloud Functions for Firebase Client SDK com.google.firebase:firebase-functions 23.0.0
Cloud Messaging com.google.firebase:firebase-messaging 26.0.2
Cloud Storage com.google.firebase:firebase-storage 23.0.0
Crashlytics com.google.firebase:firebase-crashlytics 21.1.0
Crashlytics NDK com.google.firebase:firebase-crashlytics-ndk 21.1.0
Wtyczka Crashlytics com.google.firebase:firebase-crashlytics-gradle 3.0.8
Obsługa modułów funkcji dynamicznych com.google.firebase:firebase-dynamic-module-support 16.0.0-beta05
In-App Messaging com.google.firebase:firebase-inappmessaging 23.0.0
(wymagane)
In-App Messaging – sieć reklamowa com.google.firebase:firebase-inappmessaging-display 23.0.0
(wymagane)
Firebase instalacje com.google.firebase:firebase-installations 20.0.0
Performance Monitoring com.google.firebase:firebase-perf 23.0.1
Wtyczka Performance Monitoring com.google.firebase:perf-plugin 2.0.2
Firebase Phone Number Verification com.google.firebase:firebase-pnv 17.0.0
Realtime Database com.google.firebase:firebase-database 23.0.0
Remote Config com.google.firebase:firebase-config 24.0.1
SQL Connect 2 com.google.firebase:firebase-dataconnect 18.0.1
WYCOFANE LUB NIEOBSŁUGIWANE 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łów KTX nie są już obsługiwane.
com.google.firebase:firebase-analytics-ktx
22.5.0
App Check niestandardowy dostawca Nie używaj; biblioteki modułów KTX nie są już obsługiwane.
com.google.firebase:firebase-appcheck-ktx
18.0.0
App Distribution API Nie używaj; biblioteki modułów KTX nie są już obsługiwane.
com.google.firebase:firebase-appdistribution-api-ktx
16.0.0-beta15
Authentication Nie używaj; biblioteki modułów KTX nie są już obsługiwane.
com.google.firebase:firebase-auth-ktx
23.2.1
Cloud Firestore Nie używaj; biblioteki modułów 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łów KTX nie są już obsługiwane.
com.google.firebase:firebase-functions-ktx
21.2.1
Cloud Messaging Nie używaj; biblioteki modułów KTX nie są już obsługiwane.
com.google.firebase:firebase-messaging-ktx
24.1.2
Cloud Storage Nie używaj; biblioteki modułów KTX nie są już obsługiwane.
com.google.firebase:firebase-storage-ktx
21.0.2
Crashlytics Nie używaj; biblioteki modułów KTX nie są już obsługiwane.
com.google.firebase:firebase-crashlytics-ktx
19.4.4
Dynamic Links Nie używaj; biblioteki modułów KTX nie są już obsługiwane.
com.google.firebase:firebase-dynamic-links-ktx
22.1.0
In-App Messaging Nie używaj; biblioteki modułów KTX nie są już obsługiwane.
com.google.firebase:firebase-inappmessaging-ktx
21.0.2
(wymagane)
In-App Messaging – sieć reklamowa Nie używaj; biblioteki modułów KTX nie są już obsługiwane.
com.google.firebase:firebase-inappmessaging-display-ktx
21.0.2
(wymagane)
Firebase instalacje Nie używaj; biblioteki modułów 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łów KTX nie są już obsługiwane.
com.google.firebase:firebase-ml-modeldownloader-ktx
25.0.1
Performance Monitoring Nie używaj; biblioteki modułów KTX nie są już obsługiwane.
com.google.firebase:firebase-perf-ktx
21.0.5
Realtime Database Nie używaj; biblioteki modułów KTX nie są już obsługiwane.
com.google.firebase:firebase-database-ktx
21.0.0
Remote Config Nie używaj; biblioteki modułów KTX nie są już obsługiwane.
com.google.firebase:firebase-config-ktx
22.1.2

Biblioteki Firebase ML i Firebase ML Kit

Interfejsy API modeli niestandardowych Firebase ML com.google.firebase:firebase-ml-model-interpreter 22.0.4
Firebase ML Model Downloader API com.google.firebase:firebase-ml-modeldownloader 26.1.1
Interfejsy Vision API Firebase ML com.google.firebase:firebase-ml-vision 24.1.0
Firebase ML: model oznaczania obrazów etykietami com.google.firebase:firebase-ml-vision-image-label-model 20.0.2
Firebase ML: model wykrywania obiektów i ś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: 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 nosił nazwę „Vertex AI in Firebase” i był powiązany z pakietem com.google.firebase:firebase-vertexai.

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



Dalsze kroki

Dodaj usługi Firebase do aplikacji:

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

  • Uzyskuj statystyki dotyczące zachowań użytkowników dzięki Analytics.

  • Skonfiguruj proces uwierzytelniania użytkowników za pomocą Authentication.

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

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

  • Uruchamiaj kod backendu 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: