Save the date - Google I/O returns May 18-20. Register to get the most out of the digital experience: Build your schedule, reserve space, participate in Q&As, earn Google Developer profile badges, and more. Register now
Ta strona została przetłumaczona przez Cloud Translation API.
Switch to English

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:

    • Docelowy poziom interfejsu API 16 (Jelly Bean) lub nowszy
    • Używa Gradle 4.1 lub nowszego
    • Używa Jetpack (AndroidX) , który obejmuje spełnienie następujących wymagań dotyczących wersji:
      • com.android.tools.build:gradle V3.2.1 lub później
      • 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ą na urządzeniu lub emulatorze zainstalowania usług Google Play.

  • Zaloguj się do Firebase, używając swojego konta Google.

Jeśli nie masz jeszcze projektu na Androida i chcesz po prostu wypróbować produkt Firebase, możesz pobrać jeden z naszych przykładów szybkiego startu .


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

  • Opcja 1 : (zalecane) Użyj przepływu pracy 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 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 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ź artykuł Omówienie projektów Firebase, aby dowiedzieć się więcej o projektach Firebase.

Krok 2 : zarejestruj swoją aplikację w Firebase

Aby używać Firebase w swojej 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ę systemu Android ( ) lub Dodaj aplikację, aby uruchomić przepływ pracy konfiguracji.

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

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

  5. Kliknij Zarejestruj aplikację .

Krok 3 : Dodaj plik konfiguracyjny Firebase

  1. Dodaj plik konfiguracyjny Firebase na Androida do swojej aplikacji:

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

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

  2. Aby włączyć produkty Firebase w swojej aplikacji, dodaj wtyczkę Google-services do plików Gradle.

    1. W pliku Gradle na poziomie głównym (na poziomie projektu) ( build.gradle ) dodaj reguły, aby uwzględnić wtyczkę Gradle usług Google. Sprawdź, czy masz również repozytorium Google Maven.

      buildscript {
      
        repositories {
          // Check that you have the following line (if not, add it):
          google()  // Google's Maven repository
        }
      
        dependencies {
          // ...
      
          // Add the following line:
          classpath 'com.google.gms:google-services:4.3.6'  // Google Services plugin
        }
      }
      
      allprojects {
        // ...
      
        repositories {
          // Check that you have the following line (if not, add it):
          google()  // Google's Maven repository
          // ...
        }
      }
      
    2. W pliku Gradle modułu (na poziomie aplikacji) (zwykle app/build.gradle ) zastosuj wtyczkę Google Services Gradle:

      apply plugin: 'com.android.application'
      // Add the following line:
      apply plugin: 'com.google.gms.google-services'  // Google Services plugin
      
      android {
        // ...
      }
      

Krok 4. Dodaj pakiety SDK Firebase do swojej aplikacji

  1. Korzystając z BoM Firebase na Androida , zadeklaruj zależności produktów Firebase , których chcesz używać w swojej aplikacji. Zadeklaruj je w pliku Gradle modułu (na poziomie aplikacji) (zwykle app/build.gradle ).

    Analytics włączone

    Jawa

    dependencies {
      // ...
    
      // Import the Firebase BoM
      implementation platform('com.google.firebase:firebase-bom:28.0.0')
    
      // When using the BoM, you don't specify versions in Firebase library dependencies
    
      // Declare the dependency for the Firebase SDK for Google Analytics
      implementation 'com.google.firebase:firebase-analytics'
    
      // Declare the dependencies for any other desired Firebase products
      // For example, declare 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:28.0.0')
    
      // When using the BoM, you don't specify versions in Firebase library dependencies
    
      // Declare the dependency for the Firebase SDK for Google Analytics
      implementation 'com.google.firebase:firebase-analytics-ktx'
    
      // Declare the dependencies for any other desired Firebase products
      // For example, declare 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 BoM Firebase na Androida , Twoja aplikacja będzie zawsze używać zgodnych wersji bibliotek Firebase na Androida.

    Analytics nie jest włączony

    Jawa

    dependencies {
      // ...
    
      // Import the Firebase BoM
      implementation platform('com.google.firebase:firebase-bom:28.0.0')
    
      // When using the BoM, you don't specify versions in Firebase library dependencies
    
      // Declare the dependencies for the desired Firebase products
      // For example, declare 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:28.0.0')
    
      // When using the BoM, you don't specify versions in Firebase library dependencies
    
      // Declare the dependencies for the desired Firebase products
      // For example, declare 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 BoM Firebase na Androida , Twoja aplikacja będzie zawsze używać zgodnych wersji bibliotek Firebase na Androida.

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

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

Jeśli jednak masz problemy z konfiguracją, odwiedź stronę 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 Firebase, wtyczki i zależności do Twojego projektu na Androida - wszystko z poziomu Android Studio!

  1. Otwórz projekt 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 łącze 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 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 dla wybranej usługi Firebase.

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

Otóż ​​to! Upewnij się, że zapoznałeś się z zalecanymi następnymi krokami .

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



Dostępne biblioteki

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

Należy pamiętać, że w przypadku korzystania z BoM Firebase dla systemu Android nie określa się wersji poszczególnych bibliotek podczas deklarowania zależności bibliotek Firebase w pliku build.gradle .

Jawa

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 biblioteki są zmapowane do określonej wersji BoM, przejrzyj uwagi do wydania dla tej wersji BoM.

28.0.0
AdMob com.google.android.gms: reklamy-usług-odtwarzania 20.1.0
Analityka com.google.firebase: firebase-analytics 19.0.0
Wtyczka do dystrybucji aplikacji com.google.firebase: firebase-appdistribution-gradle 2.1.2
Indeksowanie aplikacji com.google.firebase: firebase-appindexing 20.0.0
Poświadczenie com.google.firebase: firebase-auth 21.0.0
Cloud Firestore com.google.firebase: firebase-firestore 23.0.0
Cloud Functions for Firebase Client SDK com.google.firebase: funkcje-firebase 20.0.0
Komunikacja w chmurze com.google.firebase: firebase-messaging 22.0.0
Magazyn w chmurze com.google.firebase: firebase-storage 20.0.0
Crashlytics com.google.firebase: firebase-crashlytics 18.0.0
Crashlytics NDK com.google.firebase: firebase-crashlytics-ndk 18.0.0
Wtyczka Crashlytics com.google.firebase: firebase-crashlytics-gradle 2.6.0
Obsługa modułu funkcji dynamicznych com.google.firebase: obsługa firebase-dynamic-module 16.0.0-beta01
Dynamiczne linki com.google.firebase: firebase-dynamic-links 20.0.0
Wiadomości w aplikacji com.google.firebase: firebase-inappmessaging 20.0.0
(wymagany)
Wyświetlanie wiadomości w aplikacji com.google.firebase: firebase-inappmessaging-display 20.0.0
(wymagany)
Instalacje Firebase com.google.firebase: instalacje firebase 17.0.0
Firebase ML Model Downloader API com.google.firebase: firebase-ml-modeldownloader 24.0.0
Monitoring wydajności com.google.firebase: firebase-perf 20.0.0
Wtyczka monitorowania wydajności com.google.firebase: perf-plugin 1.4.0
Baza danych czasu rzeczywistego com.google.firebase: baza-danych-firebase 20.0.0
Zdalna konfiguracja com.google.firebase: firebase-config 21.0.0
Wtyczka usług Google Play com.google.gms: usługi-google 4.3.6
Nieaktualne biblioteki
Interfejsy API modelu niestandardowego Firebase ML com.google.firebase: interpreter modelu firebase-ml-model 22.0.4
Interfejsy API Firebase ML Vision 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: 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 API języka naturalnego 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: Przetłumacz model 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-response-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 biblioteki są zmapowane do określonej wersji BoM, przejrzyj uwagi do wydania dla tej wersji BoM.

28.0.0
AdMob com.google.android.gms: reklamy-usług-odtwarzania 20.1.0
Analityka com.google.firebase: firebase-analytics-ktx 19.0.0
Wtyczka do dystrybucji aplikacji com.google.firebase: firebase-appdistribution-gradle 2.1.2
Indeksowanie aplikacji com.google.firebase: firebase-appindexing 20.0.0
Poświadczenie com.google.firebase: firebase-auth-ktx 21.0.0
Cloud Firestore com.google.firebase: firebase-firestore-ktx 23.0.0
Cloud Functions for Firebase Client SDK com.google.firebase: firebase-functions-ktx 20.0.0
Komunikacja w chmurze com.google.firebase: firebase-messaging-ktx 22.0.0
Magazyn w chmurze com.google.firebase: firebase-storage-ktx 20.0.0
Crashlytics com.google.firebase: firebase-crashlytics-ktx 18.0.0
Crashlytics NDK com.google.firebase: firebase-crashlytics-ndk 18.0.0
Wtyczka Crashlytics com.google.firebase: firebase-crashlytics-gradle 2.6.0
Obsługa modułu funkcji dynamicznych com.google.firebase: obsługa firebase-dynamic-module 16.0.0-beta01
Dynamiczne linki com.google.firebase: firebase-dynamic-links-ktx 20.0.0
Wiadomości w aplikacji com.google.firebase: firebase-inappmessaging-ktx 20.0.0
(wymagany)
Wyświetlanie wiadomości w aplikacji com.google.firebase: firebase-inappmessaging-display-ktx 20.0.0
(wymagany)
Instalacje Firebase com.google.firebase: firebase-installation-ktx 17.0.0
Firebase ML Model Downloader API com.google.firebase: firebase-ml-modeldownloader-ktx 24.0.0
Monitoring wydajności com.google.firebase: firebase-perf-ktx 20.0.0
Wtyczka monitorowania wydajności com.google.firebase: perf-plugin 1.4.0
Baza danych czasu rzeczywistego com.google.firebase: firebase-database-ktx 20.0.0
Zdalna konfiguracja com.google.firebase: firebase-config-ktx 21.0.0
Wtyczka usług Google Play com.google.gms: usługi-google 4.3.6
Nieaktualne biblioteki
Interfejsy API modelu niestandardowego Firebase ML com.google.firebase: interpreter modelu firebase-ml-model 22.0.4
Interfejsy API Firebase ML Vision 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: 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 API języka naturalnego 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: Przetłumacz model 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-response-model 20.0.8



Następne kroki

Dodaj usługi Firebase do swojej aplikacji:

Dowiedz się więcej o Firebase: