Google is committed to advancing racial equity for Black communities. See how.
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ń 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ę.
    Emulatory muszą używać obrazu emulatora w 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ę Androida ( ) 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.4'  // 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:26.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:26.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:26.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:26.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ą wymagane wersje.

Otóż ​​to! Możesz przejść od razu, aby sprawdzić zalecane kolejne kroki .



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 i uzyskaj dostęp do Asystenta Firebase:

    1. Wybierz kolejno Plik> Sprawdź aktualizacje, aby upewnić się, że używasz najnowszych wersji Android Studio i Asystenta Firebase.

    2. Wybierz Narzędzia> Firebase, aby otworzyć okienko Asystenta .

  2. Wybierz produkt Firebase, który chcesz dodać do swojej aplikacji. Rozwiń jego sekcję, a następnie kliknij łącze do samouczka (na przykład Analytics> Zarejestruj 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 ).

  3. Zsynchronizuj aplikację, aby upewnić się, że wszystkie zależności mają wymagane wersje.

  4. W okienku Asystent Firebase postępuj zgodnie z pozostałymi instrukcjami konfiguracji dla wybranej usługi Firebase.

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

Otóż ​​to! Koniecznie sprawdź zalecane następne kroki .



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:

Należy pamiętać, że w przypadku korzystania z BoM Firebase Android nie określa się wersji poszczególnych bibliotek podczas deklarowania zależności bibliotek build.gradle w 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.

26.0.0
AdMob com.google.android.gms: reklamy usług-odtwarzania 19.5.0
Analityka com.google.firebase: firebase-analytics 18.0.0
Indeksowanie aplikacji com.google.firebase: firebase-appindexing 19.1.0
Poświadczenie com.google.firebase: firebase-auth 20.0.0
Cloud Firestore com.google.firebase: firebase-firestore 22.0.0
Cloud Functions for Firebase Client SDK com.google.firebase: funkcje-firebase 19.1.0
Komunikacja w chmurze com.google.firebase: firebase-messaging 21.0.0
Magazyn w chmurze com.google.firebase: firebase-storage 19.2.0
Crashlytics com.google.firebase: firebase-crashlytics 17.2.2
Dynamiczne linki com.google.firebase: firebase-dynamic-links 19.1.1
Interfejsy API Firebase ML Vision com.google.firebase: firebase-ml-vision 24.1.0
Interfejsy API modelu niestandardowego Firebase ML com.google.firebase: interpreter modelu firebase-ml-model 22.0.4
Wiadomości w aplikacji com.google.firebase: firebase-inappmessaging 19.1.2
(wymagany)
Wyświetlanie wiadomości w aplikacji com.google.firebase: firebase-inappmessaging-display 19.1.2
(wymagany)
Monitoring wydajności com.google.firebase: firebase-perf 19.0.9
Baza danych czasu rzeczywistego com.google.firebase: baza-danych-firebase 19.5.1
Zdalna konfiguracja com.google.firebase: firebase-config 20.0.0
Wtyczka usług Google Play com.google.gms: usługi-google 4.3.4
Przestarzałe biblioteki
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ą mapowane do określonej wersji BoM, przejrzyj informacje o wydaniu tej wersji BoM.

26.0.0
AdMob com.google.android.gms: reklamy usług-odtwarzania 19.5.0
Analityka com.google.firebase: firebase-analytics-ktx 18.0.0
Indeksowanie aplikacji com.google.firebase: firebase-appindexing 19.1.0
Poświadczenie com.google.firebase: firebase-auth-ktx 20.0.0
Cloud Firestore com.google.firebase: firebase-firestore-ktx 22.0.0
Cloud Functions for Firebase Client SDK com.google.firebase: firebase-functions-ktx 19.1.0
Komunikacja w chmurze com.google.firebase: firebase-messaging-ktx 21.0.0
Magazyn w chmurze com.google.firebase: firebase-storage-ktx 19.2.0
Crashlytics com.google.firebase: firebase-crashlytics-ktx 17.2.2
Dynamiczne linki com.google.firebase: firebase-dynamic-links-ktx 19.1.1
Interfejsy API Firebase ML Vision com.google.firebase: firebase-ml-vision 24.1.0
Interfejsy API modelu niestandardowego Firebase ML com.google.firebase: interpreter modelu firebase-ml-model 22.0.4
Wiadomości w aplikacji com.google.firebase: firebase-inappmessaging-ktx 19.1.2
(wymagany)
Wyświetlanie wiadomości w aplikacji com.google.firebase: firebase-inappmessaging-display-ktx 19.1.2
(wymagany)
Monitoring wydajności com.google.firebase: firebase-perf-ktx 19.0.9
Baza danych czasu rzeczywistego com.google.firebase: firebase-database-ktx 19.5.1
Zdalna konfiguracja com.google.firebase: firebase-config-ktx 20.0.0
Wtyczka usług Google Play com.google.gms: usługi google 4.3.4
Nieaktualne biblioteki
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: