Catch up on everything announced at Firebase Summit, and learn how Firebase can help you accelerate app development and run your app with confidence. Learn More

Dodaj Firebase do swojego projektu na Androida

Zadbaj o dobrą organizację dzięki kolekcji Zapisuj i kategoryzuj treści zgodnie ze swoimi preferencjami.

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.14'
          }
      }
      
      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

    Java

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

    Kotlin+KTX

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

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

    Analityka nie jest włączona

    Java

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

    Kotlin+KTX

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

    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 .

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.

31.1.0
AdMob com.google.android.gms:play-services-ads 21.3.0
Analityka com.google.firebase:firebase-analytics 21.2.0
App Sprawdź dostawcę niestandardowego com.google.firebase:firebase-appcheck 16.1.0
App Sprawdź dostawcę debugowania com.google.firebase:firebase-appcheck-debug 16.1.0
Dostawca sprawdzania integralności aplikacji Play com.google.firebase:firebase-appcheck-playintegrity 16.1.0
Aplikacja Sprawdź dostawcę SafetyNet com.google.firebase:firebase-appcheck-safetynet 16.1.0
Dystrybucja aplikacji com.google.firebase:firebase-appdistribution 16.0.0-beta05
Interfejs API dystrybucji aplikacji com.google.firebase:firebase-appdistribution-api 16.0.0-beta05
Wtyczka dystrybucji aplikacji com.google.firebase:firebase-appdistribution-gradle 3.1.1
Uwierzytelnianie com.google.firebase:firebase-auth 21.1.0
Cloud Firestore com.google.firebase:firebase-firestore 24.4.1
Cloud Functions dla pakietu SDK klienta Firebase com.google.firebase:funkcje-firebase 20.2.1
Wiadomości w chmurze com.google.firebase:wiadomości-firebase 23.1.0
Magazyn w chmurze com.google.firebase:firebase-przechowywanie 20.1.0
Crashlytics com.google.firebase:firebase-crashlytics 18.3.2
Crashlytics NDK com.google.firebase:firebase-crashlytics-ndk 18.3.2
Wtyczka Crashlytics com.google.firebase:firebase-crashlytics-gradle 2.9.2
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.2.0
(wymagany)
Wyświetlanie wiadomości w aplikacji com.google.firebase:firebase-inappmessaging-display 20.2.0
(wymagany)
Instalacje Firebase com.google.firebase:firebase-instalacje 17.1.0
Interfejs API narzędzia do pobierania modeli Firebase ML com.google.firebase:firebase-ml-modeldownloader 24.1.1
Monitoring wydajności com.google.firebase:firebase-perf 20.3.0
Wtyczka do monitorowania wydajności com.google.firebase:perf-plugin 1.4.2
Baza danych czasu rzeczywistego com.google.firebase:firebase-baza danych 20.1.0
Zdalna konfiguracja com.google.firebase:firebase-config 21.2.0
Wtyczka usługi Google Play com.google.gms:usługi-google 4.3.14
Przestarzałe biblioteki
Indeksowanie aplikacji com.google.firebase:firebase-appindexing 20.0.0
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

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.

31.1.0
AdMob com.google.android.gms:play-services-ads 21.3.0
Analityka com.google.firebase:firebase-analytics-ktx 21.2.0
App Sprawdź dostawcę niestandardowego com.google.firebase:firebase-appcheck-ktx 16.1.0
App Sprawdź dostawcę debugowania com.google.firebase:firebase-appcheck-debug 16.1.0
Aplikacja Sprawdź dostawcę SafetyNet com.google.firebase:firebase-appcheck-safetynet 16.1.0
Interfejs API dystrybucji aplikacji com.google.firebase:firebase-appdistribution-api-ktx 16.0.0-beta05
Wtyczka dystrybucji aplikacji com.google.firebase:firebase-appdistribution-gradle 3.1.1
Uwierzytelnianie com.google.firebase:firebase-auth-ktx 21.1.0
Cloud Firestore com.google.firebase:firebase-firestore-ktx 24.4.1
Cloud Functions dla pakietu SDK klienta Firebase com.google.firebase:funkcje-firebase-ktx 20.2.1
Wiadomości w chmurze com.google.firebase:firebase-messaging-ktx 23.1.0
Magazyn w chmurze com.google.firebase:firebase-storage-ktx 20.1.0
Crashlytics com.google.firebase:firebase-crashlytics-ktx 18.3.2
Crashlytics NDK com.google.firebase:firebase-crashlytics-ndk 18.3.2
Wtyczka Crashlytics com.google.firebase:firebase-crashlytics-gradle 2.9.2
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.2.0
(wymagany)
Wyświetlanie wiadomości w aplikacji com.google.firebase:firebase-inappmessaging-display-ktx 20.2.0
(wymagany)
Instalacje Firebase com.google.firebase:firebase-installations-ktx 17.1.0
Interfejs API narzędzia do pobierania modeli Firebase ML com.google.firebase:firebase-ml-modeldownloader-ktx 24.1.1
Monitoring wydajności com.google.firebase:firebase-perf-ktx 20.3.0
Wtyczka do monitorowania wydajności com.google.firebase:perf-plugin 1.4.2
Baza danych czasu rzeczywistego com.google.firebase:firebase-database-ktx 20.1.0
Zdalna konfiguracja com.google.firebase:firebase-config-ktx 21.2.0
Wtyczka usług Google Play com.google.gms:usługi-google 4.3.14
Przestarzałe biblioteki
Indeksowanie aplikacji com.google.firebase:firebase-appindexing 20.0.0
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: