Catch up on highlights from Firebase at Google I/O 2023. Learn more

Dodaj Firebase do swojego projektu na Androida

Wymagania wstępne

  • Zainstaluj lub zaktualizuj Android Studio do najnowszej wersji.

  • Upewnij się, że Twój projekt spełnia te wymagania:

    • Celuje w interfejs API poziomu 19 (KitKat) lub wyższy
    • Używa Androida 4.4 lub nowszego
    • Używa Jetpack (AndroidX) , co obejmuje spełnienie następujących wymagań dotyczących wersji:
      • com.android.tools.build:gradle w wersji 3.2.1 lub nowszej
      • compileSdkVersion 28 lub nowszy
  • Skonfiguruj urządzenie fizyczne lub użyj emulatora , aby uruchomić aplikację.
    Pamiętaj, że zestawy SDK Firebase zależne od usług Google Play wymagają, aby urządzenie lub emulator miały zainstalowane usługi Google Play.

  • Zaloguj się do Firebase przy użyciu swojego konta Google.

Jeśli nie masz jeszcze projektu na Androida i chcesz tylko wypróbować produkt Firebase, możesz pobrać jedną z naszych szybkich próbek .


Możesz połączyć swoją aplikację na Androida z Firebase, korzystając z jednej z następujących opcji:

  • Opcja 1 : (zalecane) Skorzystaj z procedury konfiguracji konsoli Firebase.
  • Opcja 2 : użyj Asystenta Firebase Android Studio (może wymagać dodatkowej konfiguracji).



Opcja 1 : Dodaj Firebase za pomocą konsoli Firebase

Dodanie Firebase do aplikacji obejmuje zadania zarówno w konsoli Firebase , jak i w otwartym projekcie na Androida (na przykład pobierasz pliki konfiguracyjne Firebase z konsoli, a następnie przenosisz je do swojego projektu na Androida).

Krok 1 : Utwórz projekt Firebase

Zanim dodasz Firebase do swojej aplikacji na Androida, musisz utworzyć projekt Firebase, aby połączyć się z aplikacją na Androida. Odwiedź stronę Projekty Firebase, aby dowiedzieć się więcej o projektach Firebase.

Krok 2 : Zarejestruj swoją aplikację w Firebase

Aby korzystać z Firebase w aplikacji na Androida, musisz zarejestrować swoją aplikację w projekcie Firebase. Rejestracja aplikacji jest często nazywana „dodawaniem” aplikacji do projektu.

  1. Przejdź do konsoli Firebase .

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

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

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

  5. Kliknij Zarejestruj aplikację .

Krok 3 : Dodaj plik konfiguracyjny Firebase

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

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

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

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

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

      buildscript {
      
          repositories {
            // Make sure that you have the following two repositories
            google()  // Google's Maven repository
            mavenCentral()  // Maven Central repository
          }
      
          dependencies {
            ...
      
            // Add the dependency for the Google services Gradle plugin
            classpath 'com.google.gms:google-services:4.3.15'
          }
      }
      
      allprojects {
        ...
      
        repositories {
          // Make sure that you have the following two repositories
          google()  // Google's Maven repository
          mavenCentral()  // Maven Central repository
        }
      }
      
    2. W pliku Gradle modułu (na poziomie aplikacji) (zwykle <project>/<app-module>/build.gradle ) dodaj wtyczkę usług Google:

      plugins {
          id 'com.android.application'
      
          // Add the Google services Gradle plugin
          id 'com.google.gms.google-services'
          ...
      }
      

Krok 4 : dodaj zestawy SDK Firebase do swojej aplikacji

  1. W pliku Gradle modułu (na poziomie aplikacji) (zwykle <project>/<app-module>/build.gradle ) dodaj zależności dla produktów Firebase , których chcesz używać w swojej aplikacji. Zalecamy używanie Firebase Android BoM do kontrolowania wersji bibliotek.

    Analityka włączona

    Kotlin+KTX

    dependencies {
      // ...
    
      // Import the Firebase BoM
      implementation platform('com.google.firebase:firebase-bom:32.1.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-ktx'
    
      // 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-ktx'
      implementation 'com.google.firebase:firebase-firestore-ktx'
    }
    

    Java

    dependencies {
      // ...
    
      // Import the Firebase BoM
      implementation platform('com.google.firebase:firebase-bom:32.1.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'
    }
    

    Korzystając z Firebase Android BoM , Twoja aplikacja będzie zawsze korzystać ze zgodnych wersji bibliotek Firebase Android.

    Analityka nie jest włączona

    Kotlin+KTX

    dependencies {
      // ...
    
      // Import the Firebase BoM
      implementation platform('com.google.firebase:firebase-bom:32.1.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-ktx'
      implementation 'com.google.firebase:firebase-firestore-ktx'
    }
    

    Java

    dependencies {
      // ...
    
      // Import the Firebase BoM
      implementation platform('com.google.firebase:firebase-bom:32.1.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'
    }
    

    Korzystając z Firebase Android BoM , Twoja aplikacja będzie zawsze korzystać ze zgodnych wersji bibliotek Firebase Android.

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

Otóż ​​to! Możesz przejść dalej, aby zapoznać się z zalecanymi następnymi krokami .

Jeśli jednak masz problemy z konfiguracją, odwiedź stronę Rozwiązywanie problemów z Androidem i często zadawane pytania .



Opcja 2 : Dodaj Firebase za pomocą Asystenta Firebase

Asystent Firebase rejestruje Twoją aplikację w projekcie Firebase i dodaje niezbędne pliki Firebase, wtyczki i zależności do Twojego projektu Android — wszystko z poziomu Android Studio!

  1. Otwórz swój projekt na Androida w Android Studio, a następnie upewnij się, że 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 okienku Asystenta wybierz produkt Firebase, który chcesz dodać do swojej aplikacji. Rozwiń jego sekcję, a następnie kliknij link samouczka (na przykład Analytics > Rejestruj zdarzenie Analytics ).

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

    2. Kliknij przycisk, aby dodać żądany produkt Firebase (np. Dodaj Analytics do swojej aplikacji ).

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

  5. W okienku Asystenta postępuj zgodnie z pozostałymi instrukcjami dotyczącymi konfiguracji wybranego produktu Firebase.

  6. Dodaj dowolną liczbę innych produktów Firebase za pomocą Asystenta Firebase!

Otóż ​​to! Zapoznaj się z zalecanymi kolejnymi krokami .

Jeśli jednak masz problemy z konfiguracją, odwiedź stronę Rozwiązywanie problemów z Androidem i często zadawane pytania .



Dostępne biblioteki

Ta sekcja zawiera listę produktów Firebase obsługiwanych na Androida i ich zależności Gradle. Dowiedz się więcej o tych bibliotekach Firebase na Androida:

Pamiętaj, że podczas korzystania z Firebase Android BoM , nie określasz poszczególnych wersji bibliotek podczas deklarowania zależności bibliotek Firebase w build.gradle .

Kotlin+KTX

Usługa lub Produkt Zależność stopniowa Najnowszy
wersja
Dodać Analytics?
Firebase Android BoM
(Zestawienie materiałów)
com.google.firebase:firebase-bom

Najnowsza wersja Firebase BoM zawiera najnowsze wersje każdej biblioteki Firebase Android. Aby dowiedzieć się, które wersje bibliotek są odwzorowane na określoną wersję zestawienia komponentów, przejrzyj informacje o wydaniu dla tej wersji zestawienia komponentów.

32.1.0
AdMob com.google.android.gms:play-services-ads 22.1.0
Analityka com.google.firebase:firebase-analytics-ktx 21.3.0
App Sprawdź dostawcę niestandardowego com.google.firebase:firebase-appcheck-ktx 17.0.1
App Sprawdź dostawcę debugowania com.google.firebase:firebase-appcheck-debug 17.0.1
Dostawca sprawdzania integralności aplikacji Play com.google.firebase:firebase-appcheck-playintegrity 17.0.1
Dystrybucja aplikacji com.google.firebase:firebase-appdistribution 16.0.0-beta08
Interfejs API dystrybucji aplikacji com.google.firebase:firebase-appdistribution-api-ktx 16.0.0-beta08
Wtyczka dystrybucji aplikacji com.google.firebase:firebase-appdistribution-gradle 4.0.0
Uwierzytelnianie com.google.firebase:firebase-auth-ktx 22.0.0
Cloud Firestore com.google.firebase:firebase-firestore-ktx 24.6.1
Cloud Functions dla pakietu SDK klienta Firebase com.google.firebase:funkcje-firebase-ktx 20.3.1
Wiadomości w chmurze com.google.firebase:firebase-messaging-ktx 23.1.2
Magazyn w chmurze com.google.firebase:firebase-storage-ktx 20.2.0
Crashlytics com.google.firebase:firebase-crashlytics-ktx 18.3.7
Crashlytics NDK com.google.firebase:firebase-crashlytics-ndk 18.3.7
Wtyczka Crashlytics com.google.firebase:firebase-crashlytics-gradle 2.9.5
Obsługa dynamicznego modułu funkcji com.google.firebase:firebase-dynamic-module-support 16.0.0-beta03
Linki dynamiczne com.google.firebase:firebase-dynamic-links-ktx 21.1.0
Wiadomości w aplikacji com.google.firebase:firebase-inappmessaging-ktx 20.3.2
(wymagany)
Wyświetlanie wiadomości w aplikacji com.google.firebase:firebase-inappmessaging-display-ktx 20.3.2
(wymagany)
Instalacje Firebase com.google.firebase:firebase-installations-ktx 17.1.3
Interfejs API narzędzia do pobierania modeli Firebase ML com.google.firebase:firebase-ml-modeldownloader-ktx 24.1.2
Monitoring wydajności com.google.firebase:firebase-perf-ktx 20.3.2
Wtyczka do monitorowania wydajności com.google.firebase:perf-plugin 1.4.2
Baza danych czasu rzeczywistego com.google.firebase:firebase-database-ktx 20.2.2
Zdalna konfiguracja com.google.firebase:firebase-config-ktx 21.4.0
Wtyczka usług Google Play com.google.gms:usługi-google 4.3.15
Przestarzałe biblioteki
Aplikacja Sprawdź dostawcę SafetyNet com.google.firebase:firebase-appcheck-safetynet 16.1.2
Indeksowanie aplikacji com.google.firebase:firebase-appindexing 20.0.0

Biblioteki Firebase ML Kit

Interfejsy API modelu niestandardowego Firebase ML com.google.firebase:firebase-ml-model-interpreter 22.0.4
Interfejsy API Firebase ML Vision com.google.firebase:firebase-ml-vision 24.1.0
Firebase ML: Model etykietowania obrazu 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 kodów kreskowych com.google.firebase:firebase-ml-vision-barcode-model 16.1.2
Firebase ML: 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-język naturalny 22.0.1
Firebase ML: model identyfikacji języka com.google.firebase:firebase-ml-natural-language-id-language-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

Java

Usługa lub Produkt Zależność stopniowa Najnowszy
wersja
Dodać Analytics?
Firebase Android BoM
(Zestawienie materiałów)
com.google.firebase:firebase-bom

Najnowsza wersja Firebase BoM zawiera najnowsze wersje każdej biblioteki Firebase Android. Aby dowiedzieć się, które wersje bibliotek są odwzorowane na określoną wersję zestawienia komponentów, przejrzyj informacje o wydaniu dla tej wersji zestawienia komponentów.

32.1.0
AdMob com.google.android.gms:play-services-ads 22.1.0
Analityka com.google.firebase:firebase-analytics 21.3.0
App Sprawdź dostawcę niestandardowego com.google.firebase:firebase-appcheck 17.0.1
App Sprawdź dostawcę debugowania com.google.firebase:firebase-appcheck-debug 17.0.1
Dostawca sprawdzania integralności aplikacji Play com.google.firebase:firebase-appcheck-playintegrity 17.0.1
Dystrybucja aplikacji com.google.firebase:firebase-appdistribution 16.0.0-beta08
Interfejs API dystrybucji aplikacji com.google.firebase:firebase-appdistribution-api 16.0.0-beta08
Wtyczka dystrybucji aplikacji com.google.firebase:firebase-appdistribution-gradle 4.0.0
Uwierzytelnianie com.google.firebase:firebase-auth 22.0.0
Cloud Firestore com.google.firebase:firebase-firestore 24.6.1
Cloud Functions dla pakietu SDK klienta Firebase com.google.firebase:funkcje-firebase 20.3.1
Wiadomości w chmurze com.google.firebase:wiadomości-firebase 23.1.2
Magazyn w chmurze com.google.firebase:firebase-przechowywanie 20.2.0
Crashlytics com.google.firebase:firebase-crashlytics 18.3.7
Crashlytics NDK com.google.firebase:firebase-crashlytics-ndk 18.3.7
Wtyczka Crashlytics com.google.firebase:firebase-crashlytics-gradle 2.9.5
Obsługa dynamicznego modułu funkcji com.google.firebase:firebase-dynamic-module-support 16.0.0-beta03
Linki dynamiczne com.google.firebase:dynamiczne-linki-firebase 21.1.0
Wiadomości w aplikacji com.google.firebase:firebase-inappmessaging 20.3.2
(wymagany)
Wyświetlanie wiadomości w aplikacji com.google.firebase:firebase-inappmessaging-display 20.3.2
(wymagany)
Instalacje Firebase com.google.firebase:firebase-instalacje 17.1.3
Interfejs API narzędzia do pobierania modeli Firebase ML com.google.firebase:firebase-ml-modeldownloader 24.1.2
Monitoring wydajności com.google.firebase:firebase-perf 20.3.2
Wtyczka do monitorowania wydajności com.google.firebase:perf-plugin 1.4.2
Baza danych czasu rzeczywistego com.google.firebase:firebase-baza danych 20.2.2
Zdalna konfiguracja com.google.firebase:firebase-config 21.4.0
Wtyczka usługi Google Play com.google.gms:usługi-google 4.3.15
Przestarzałe biblioteki
Aplikacja Sprawdź dostawcę SafetyNet com.google.firebase:firebase-appcheck-safetynet 16.1.2
Indeksowanie aplikacji com.google.firebase:firebase-appindexing 20.0.0

Biblioteki Firebase ML Kit

Interfejsy API modelu niestandardowego Firebase ML com.google.firebase:firebase-ml-model-interpreter 22.0.4
Interfejsy API Firebase ML Vision com.google.firebase:firebase-ml-vision 24.1.0
Firebase ML: Model etykietowania obrazu 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 kodów kreskowych com.google.firebase:firebase-ml-vision-barcode-model 16.1.2
Firebase ML: 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-język naturalny 22.0.1
Firebase ML: model identyfikacji języka com.google.firebase:firebase-ml-natural-language-id-language-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



Następne kroki

Dodaj usługi Firebase do swojej aplikacji:

Dowiedz się więcej o Firebase: