Google 致力于为黑人社区推动种族平等。查看具体举措

Dodaj Firebase do swojego projektu na Androida

Wymagania wstępne

  • Zainstalować lub zaktualizować Androida Studio do jego najnowszej wersji.

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

    • Targets API level 16 (Jelly Bean) lub wyższy
    • Używa Androida 4.1 lub nowszego
    • Używa Jetpack (AndroidX) , która obejmuje spełnienia tych wymagań Wersja:
      • com.android.tools.build:gradle V3.2.1 lub później
      • compileSdkVersion 28 lub później
  • Konfigurowanie urządzenia fizycznego lub użyć emulatora , aby uruchomić aplikację.
    Zauważ, że Firebase SDK z uzależnienia od usług Google Play wymagają urządzenia lub emulatora mieć zainstalowane usługi Google Play.

  • Zarejestruj się Firebase za pomocą konta Google.

Jeżeli nie masz jeszcze projekt Android i po prostu chcą wypróbować Firebase produkt można pobrać jeden z naszych próbek QuickStart .


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

  • Wariant 1 : (zalecane) Za pomocą ustawień konsoli obieg Firebase.
  • Opcja 2 : Użyj Android Studio Firebase Assistant (może wymagać dodatkowej konfiguracji).



Opcja 1: Dodaj Firebase pomocą konsoli Firebase

Dodawanie Firebase do aplikacji obejmuje zadania zarówno w konsoli Firebase iw otwartej projektu Android (na przykład, można pobrać pliki konfiguracyjne Firebase z konsoli, a następnie przenieść je do projektu Android).

Krok 1: Tworzenie projektu Firebase

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

Krok 2: zarejestruj swoją aplikację z 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. W środku strony głównej projektu kliknij ikonę Android ( ) lub Dodaj aplikację, aby uruchomić przepływ pracy instalacji.

  3. Wpisz nazwę pakietu aplikacji w polu Nazwa pakietu Android.

  4. (Opcjonalnie) Wprowadź inne informacje APL: App nick i Debug podpisanie certyfikatu SHA-1.

  5. Kliknij Register aplikację.

Krok 3: Dodaj plik konfiguracyjny Firebase

  1. Dodaj plik konfiguracyjny Firebase Android do swojej aplikacji:

    1. Kliknij Pobierz Google-services.json aby uzyskać plik konfiguracyjny Firebase 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, dodać google-usług plugin do Gradle plików.

    1. W swoim głównym poziomie (projekt podstawowy) Plik Gradle ( build.gradle ), dodać zasady obejmują wtyczki Google Services Gradle. Sprawdź również, czy masz repozytorium Maven firmy Google.

      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.10'  // Google Services plugin
        }
      }
      
      allprojects {
        // ...
      
        repositories {
          // Check that you have the following line (if not, add it):
          google()  // Google's Maven repository
          // ...
        }
      }
      
    2. W module (app szczebla) Gradle plik (zazwyczaj app/build.gradle ), stosować wtyczki 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 Firebase SDK do aplikacji

  1. Korzystanie z Firebase Android Bom oświadczyć zależności dla produktów Firebase które chcesz użyć w swojej aplikacji. Zadeklarować je w module (app szczebla) Gradle plik (zazwyczaj app/build.gradle ).

    Analiza włączona

    Jawa

    dependencies {
      // ...
    
      // Import the Firebase BoM
      implementation platform('com.google.firebase:firebase-bom:28.4.1')
    
      // 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.4.1')
    
      // 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 Firebase Bom Android , aplikacja będzie zawsze używać kompatybilne wersje bibliotek Firebase Android.

    Analytics nie jest włączone

    Jawa

    dependencies {
      // ...
    
      // Import the Firebase BoM
      implementation platform('com.google.firebase:firebase-bom:28.4.1')
    
      // 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.4.1')
    
      // 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 Firebase Bom Android , aplikacja będzie zawsze używać kompatybilne wersje bibliotek Firebase Android.

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

Otóż ​​to! Można przejść od razu sprawdzić zalecanych kolejne kroki .

Jeśli masz problemy z uzyskaniem konfiguracji, choć można znaleźć w rozwiązywaniu problemów z Androidem nas .



Opcja 2: Dodaj Firebase pomocą Firebase Assistant

Firebase Assistant rejestruje swoją aplikację z projektem Firebase i dodaje potrzebne pliki Firebase, wtyczki i współzależności do projektu Android - wszystko z poziomu Androida 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ź dostępność aktualizacji
  2. Otwórz Firebase Assistant: Narzędzia> Firebase.

  3. W Assistant okienku wybrać Firebase produkt, aby dodać do swojej aplikacji. Poszerzyć swoją sekcję, a następnie kliknij odnośnik samouczka (na przykład Analytics> Log zdarzenie Analytics).

    1. Kliknij Połącz Firebase podłączyć Android projekt z Firebase.

    2. Kliknij przycisk, aby dodać żądany produkt Firebase (na przykład Dodaj Analytics do aplikacji).

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

  5. W Assistant okienku wykonaj pozostałe instrukcje konfiguracji dla wybranego produktu Firebase.

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

Otóż ​​to! Upewnij się, aby sprawdzić zalecanych kolejne kroki .

Jeśli masz problemy z uzyskaniem konfiguracji, choć można znaleźć w rozwiązywaniu problemów z Androidem nas .



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:

Należy pamiętać, że podczas korzystania z Firebase Android bom , nie określają poszczególne wersje bibliotek gdy deklarujesz Firebase zależności bibliotecznych 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 bibliotek są mapowane na konkretną wersję BoM, przejrzyj uwagi do wydania dla tej wersji BoM.

28.4.1
AdMob com.google.android.gms:reklamy usług-play 20.3.0
Analityka com.google.firebase:firebase-analytics 19.0.1
Niestandardowy dostawca sprawdzania aplikacji com.google.firebase:firebase-appcheck 16.0.0-beta02
Dostawca debugowania sprawdzania aplikacji com.google.firebase:firebase-appcheck-debug 16.0.0-beta02
Dostawca App Check SafetyNet com.google.firebase:firebase-appcheck-safetynet 16.0.0-beta02
Wtyczka do dystrybucji aplikacji com.google.firebase:firebase-appdistribution-gradle 2.2.0
Indeksowanie aplikacji com.google.firebase:firebase-appindexing 20.0.0
Uwierzytelnianie com.google.firebase:firebase-auth 21.0.1
Cloud Firestore com.google.firebase:firebase-firestore 23.0.3
Pakiet SDK Cloud Functions dla klienta Firebase com.google.firebase:funkcje-firebase 20.0.1
Wiadomości w chmurze com.google.firebase:wiadomości-firebase 22.0.0
Magazyn w chmurze com.google.firebase:pamięć-firebase 20.0.0
Crashlytics com.google.firebase:firebase-crashlytics 18.2.1
Crashlytics NDK com.google.firebase:firebase-crashlytics-ndk 18.2.1
Wtyczka Crashlytics com.google.firebase:firebase-crashlytics-gradle 2.7.1
Obsługa modułu funkcji dynamicznych com.google.firebase:firebase-dynamic-module-support 16.0.0-beta01
Dynamiczne linki com.google.firebase:firebase-dynamic-links 20.1.1
Wiadomości w aplikacji com.google.firebase:firebase-inappmessaging 20.1.0
(wymagany)
Wyświetlanie wiadomości w aplikacji com.google.firebase:firebase-inappmessaging-display 20.1.0
(wymagany)
Instalacje Firebase com.google.firebase:instalacje-firebase 17.0.0
Interfejs API Firebase ML Model Downloader com.google.firebase:firebase-ml-modeldownloader 24.0.0
Monitoring wydajności com.google.firebase:firebase-perf 20.0.2
Wtyczka do monitorowania wydajności com.google.firebase:wtyczka perf 1.4.0
Baza danych czasu rzeczywistego com.google.firebase:baza-danych-firebase 20.0.2
Zdalna konfiguracja com.google.firebase:firebase-config 21.0.1
Wtyczka usług Google Play com.google.gms:usługi-google 4.3.10
Przestarzałe biblioteki
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.

28.4.1
AdMob com.google.android.gms:reklamy usług-play 20.3.0
Analityka com.google.firebase:firebase-analytics-ktx 19.0.1
Niestandardowy dostawca sprawdzania aplikacji com.google.firebase:firebase-appcheck 16.0.0-beta02
Dostawca debugowania sprawdzania aplikacji com.google.firebase:firebase-appcheck-debug 16.0.0-beta02
Dostawca App Check SafetyNet com.google.firebase:firebase-appcheck-safetynet 16.0.0-beta02
Wtyczka do dystrybucji aplikacji com.google.firebase:firebase-appdistribution-gradle 2.2.0
Indeksowanie aplikacji com.google.firebase:firebase-appindexing 20.0.0
Uwierzytelnianie com.google.firebase:firebase-auth-ktx 21.0.1
Cloud Firestore com.google.firebase:firebase-firestore-ktx 23.0.3
Pakiet SDK Cloud Functions dla klienta Firebase com.google.firebase:funkcje-firebase-ktx 20.0.1
Wiadomości 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.2.1
Crashlytics NDK com.google.firebase:firebase-crashlytics-ndk 18.2.1
Wtyczka Crashlytics com.google.firebase:firebase-crashlytics-gradle 2.7.1
Obsługa modułu funkcji dynamicznych com.google.firebase:firebase-dynamic-module-support 16.0.0-beta01
Dynamiczne linki com.google.firebase:firebase-dynamic-links-ktx 20.1.1
Wiadomości w aplikacji com.google.firebase:firebase-inappmessaging-ktx 20.1.0
(wymagany)
Wyświetlanie wiadomości w aplikacji com.google.firebase:firebase-inappmessaging-display-ktx 20.1.0
(wymagany)
Instalacje Firebase com.google.firebase:firebase-installations-ktx 17.0.0
Interfejs API Firebase ML Model Downloader com.google.firebase:firebase-ml-modeldownloader-ktx 24.0.0
Monitoring wydajności com.google.firebase:firebase-perf-ktx 20.0.2
Wtyczka do monitorowania wydajności com.google.firebase:wtyczka perf 1.4.0
Baza danych czasu rzeczywistego com.google.firebase:firebase-database-ktx 20.0.2
Zdalna konfiguracja com.google.firebase:firebase-config-ktx 21.0.1
Wtyczka usług Google Play com.google.gms:usługi-google 4.3.10
Przestarzałe biblioteki
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: