欢迎参加我们将于 2022 年 10 月 18 日举办的 Firebase 峰会(线上线下同时进行),了解 Firebase 如何帮助您加快应用开发速度、满怀信心地发布应用并在之后需要时轻松地扩大应用规模。立即报名

Dodaj Firebase do swojego projektu na Androida

Warunki wstępne

  • Zainstaluj lub zaktualizuj Android Studio do najnowszej wersji.

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

    • Targets API level 19 (KitKat) lub wyższy
    • Używa Androida 4.4 lub nowszego
    • Używa Jetpack (AndroidX) , który obejmuje spełnienie następujących wymagań wersji:
      • com.android.tools.build:gradle v3.2.1 lub nowszy
      • compileSdkVersion 28 lub nowszą
  • 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ę do Firebase przy użyciu swojego konta Google.

Jeśli nie masz jeszcze projektu na Androida, a chcesz tylko wypróbować produkt Firebase, możesz pobrać jeden z naszych krótkich przykładów .


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

  • Opcja 1 : (zalecane) Użyj 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 Android (na przykład pobierasz pliki konfiguracyjne Firebase z konsoli, a następnie przenosisz je do projektu Android).

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ź Zrozumienie projektów 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ć przepływ pracy instalacji.

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

  4. (Opcjonalnie) Podaj 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 pakietó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 pakiety 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.

    Analiza włączona

    Java

    dependencies {
      // ...
    
      // Import the Firebase BoM
      implementation platform('com.google.firebase:firebase-bom:30.5.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:30.5.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 używać zgodnych wersji bibliotek Firebase na Androida.

    Analytics nie jest włączone

    Java

    dependencies {
      // ...
    
      // Import the Firebase BoM
      implementation platform('com.google.firebase:firebase-bom:30.5.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:30.5.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 używać zgodnych wersji bibliotek Firebase na Androida.

  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 kolejnymi krokami .

Jeśli jednak masz problemy z konfiguracją, odwiedź sekcję Rozwiązywanie problemów z Androidem i najczęstsze pytania .



Opcja 2 : Dodaj Firebase za pomocą Asystenta Firebase

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

  1. Otwórz projekt na Androida w Android Studio, a następnie upewnij się, że korzystasz z najnowszych wersji Android Studio i Asystenta Firebase:

    • Windows / Linux: Pomoc > Sprawdź aktualizacje
    • macOS: Android Studio > Sprawdź aktualizacje
  2. Otwórz Asystenta Firebase: Narzędzia > Firebase .

  3. W okienku Asystent wybierz produkt Firebase, który chcesz dodać do swojej aplikacji. Rozwiń jego sekcję, a następnie kliknij link do 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 (na przykład Dodaj Analytics do swojej aplikacji ).

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

  5. W okienku Asystent postępuj zgodnie z pozostałymi instrukcjami konfiguracji wybranego produktu Firebase.

  6. Dodaj tyle innych produktów Firebase, ile chcesz, za pomocą Asystenta Firebase!

Otóż ​​to! Sprawdź zalecane dalsze kroki .

Jeśli jednak masz problemy z konfiguracją, odwiedź sekcję Rozwiązywanie problemów z Androidem i najczęstsze pytania .



Dostępne biblioteki

W tej sekcji wymieniono produkty Firebase obsługiwane w systemie Android oraz ich zależności od Gradle. Dowiedz się więcej o tych bibliotekach Firebase na Androida:

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

Java

Usługa lub produkt Zależność Gradle 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 na Androida. Aby dowiedzieć się, które wersje bibliotek są mapowane na konkretną wersję BoM, przejrzyj uwagi do wydania dla tej wersji BoM.

30.5.0
AdMob com.google.android.gms:reklamy usług-play 21.2.0
Analityka com.google.firebase:firebase-analytics 21.1.1
Niestandardowy dostawca sprawdzania aplikacji com.google.firebase:firebase-appcheck 16.0.2
Dostawca debugowania sprawdzania aplikacji com.google.firebase:firebase-appcheck-debug 16.0.2
Dostawca usługi App Check Play Integrity com.google.firebase:firebase-appcheck-playintegrity 16.0.2
Dostawca App Check SafetyNet com.google.firebase:firebase-appcheck-safetynet 16.0.2
Dystrybucja aplikacji com.google.firebase:firebase-appdistribution 16.0.0-beta04
API dystrybucji aplikacji com.google.firebase:firebase-appdistribution-api 16.0.0-beta04
Wtyczka do dystrybucji aplikacji com.google.firebase:firebase-appdistribution-gradle 3.0.3
Uwierzytelnianie com.google.firebase:firebase-auth 21.0.8
Cloud Firestore com.google.firebase:firebase-firestore 24.3.1
Pakiet SDK Cloud Functions dla klienta Firebase com.google.firebase:funkcje-firebase 20.1.1
Wiadomości w chmurze com.google.firebase:wiadomości-firebase 23.0.8
Magazyn w chmurze com.google.firebase:pamięć-firebase 20.0.2
Crashlytics com.google.firebase:firebase-crashlytics 18.2.13
Crashlytics NDK com.google.firebase:firebase-crashlytics-ndk 18.2.13
Wtyczka Crashlytics com.google.firebase:firebase-crashlytics-gradle 2.9.2
Obsługa modułu funkcji dynamicznych com.google.firebase:firebase-dynamic-module-support 16.0.0-beta03
Dynamiczne linki com.google.firebase:firebase-dynamic-links 21.0.2
Wiadomości w aplikacji com.google.firebase:firebase-inappmessaging 20.1.3
(wymagany)
Wyświetlanie wiadomości w aplikacji com.google.firebase:firebase-inappmessaging-display 20.1.3
(wymagany)
Instalacje Firebase com.google.firebase:instalacje-firebase 17.0.3
Interfejs API Firebase ML Model Downloader com.google.firebase:firebase-ml-modeldownloader 24,0,5
Monitoring wydajności com.google.firebase:firebase-perf 20.1.1
Wtyczka do monitorowania wydajności com.google.firebase:wtyczka perf 1.4.1
Baza danych czasu rzeczywistego com.google.firebase:baza-danych-firebase 20.0.6
Zdalna konfiguracja com.google.firebase:firebase-config 21.1.2
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-wizja 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-model-wykrywania-obiektów 19.0.6
Firebase ML: model wykrywania twarzy com.google.firebase:firebase-ml-vision-model-twarzy 20.0.2
Firebase ML: model skanowania kodów kreskowych 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-język-naturalny 22.0.1
Firebase ML: model identyfikacji języka com.google.firebase:firebase-ml-model-identyfikatora-języka-naturalnego 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-język-inteligentna-odpowiedź-model 20.0.8

Kotlin+KTX

Usługa lub produkt Zależność Gradle 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 na Androida. Aby dowiedzieć się, które wersje bibliotek są mapowane na konkretną wersję BoM, przejrzyj uwagi do wydania dla tej wersji BoM.

30.5.0
AdMob com.google.android.gms:reklamy usług-play 21.2.0
Analityka com.google.firebase:firebase-analytics-ktx 21.1.1
Niestandardowy dostawca sprawdzania aplikacji com.google.firebase:firebase-appcheck-ktx 16.0.2
Dostawca debugowania sprawdzania aplikacji com.google.firebase:firebase-appcheck-debug 16.0.2
Dostawca App Check SafetyNet com.google.firebase:firebase-appcheck-safetynet 16.0.2
API dystrybucji aplikacji com.google.firebase:firebase-appdistribution-api-ktx 16.0.0-beta04
Wtyczka do dystrybucji aplikacji com.google.firebase:firebase-appdistribution-gradle 3.0.3
Uwierzytelnianie com.google.firebase:firebase-auth-ktx 21.0.8
Cloud Firestore com.google.firebase:firebase-firestore-ktx 24.3.1
Pakiet SDK Cloud Functions dla klienta Firebase com.google.firebase:funkcje-firebase-ktx 20.1.1
Wiadomości w chmurze com.google.firebase:firebase-messaging-ktx 23.0.8
Magazyn w chmurze com.google.firebase:firebase-storage-ktx 20.0.2
Crashlytics com.google.firebase:firebase-crashlytics-ktx 18.2.13
Crashlytics NDK com.google.firebase:firebase-crashlytics-ndk 18.2.13
Wtyczka Crashlytics com.google.firebase:firebase-crashlytics-gradle 2.9.2
Obsługa modułu funkcji dynamicznych com.google.firebase:firebase-dynamic-module-support 16.0.0-beta03
Dynamiczne linki com.google.firebase:firebase-dynamic-links-ktx 21.0.2
Wiadomości w aplikacji com.google.firebase:firebase-inappmessaging-ktx 20.1.3
(wymagany)
Wyświetlanie wiadomości w aplikacji com.google.firebase:firebase-inappmessaging-display-ktx 20.1.3
(wymagany)
Instalacje Firebase com.google.firebase:firebase-installations-ktx 17.0.3
Interfejs API Firebase ML Model Downloader com.google.firebase:firebase-ml-modeldownloader-ktx 24,0,5
Monitoring wydajności com.google.firebase:firebase-perf-ktx 20.1.1
Wtyczka do monitorowania wydajności com.google.firebase:wtyczka perf 1.4.1
Baza danych czasu rzeczywistego com.google.firebase:firebase-database-ktx 20.0.6
Zdalna konfiguracja com.google.firebase:firebase-config-ktx 21.1.2
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-wizja 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-model-wykrywania-obiektów 19.0.6
Firebase ML: model wykrywania twarzy com.google.firebase:firebase-ml-vision-model-twarzy 20.0.2
Firebase ML: model skanowania kodów kreskowych 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-język-naturalny 22.0.1
Firebase ML: model identyfikacji języka com.google.firebase:firebase-ml-model-identyfikatora-języka-naturalnego 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-język-inteligentna-odpowiedź-model 20.0.8



Następne kroki

Dodaj usługi Firebase do swojej aplikacji:

Dowiedz się więcej o Firebase: