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 następujące wymagania:

    • Docelowy poziom API 19 (KitKat) lub wyższy
    • Używa Androida 4.4 lub nowszego
    • Korzysta z Jetpack (AndroidX) , co obejmuje spełnienie następujących wymagań wersji:
      • com.android.tools.build:gradle w wersji 7.3.0 lub nowszej
      • compileSdkVersion 28 lub nowsza
  • 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 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 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 : (zalecana) Użyj przepływu pracy 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 projektu na Androida).

Krok 1 : Utwórz projekt Firebase

Zanim będziesz mógł dodać Firebase do swojej aplikacji na Androida, musisz utworzyć projekt Firebase, aby połączyć się z tą aplikacją na Androida. Odwiedź stronę Poznaj 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ć 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 aplikacji w polu nazwy pakietu Androida .

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

  5. Kliknij opcję 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 plik google-services.json, aby uzyskać plik konfiguracyjny Firebase na Androida.

    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 Gradle usług Google ( google-services ).

    1. W pliku Gradle na poziomie głównym (na poziomie projektu) ( <project>/build.gradle.kts lub <project>/build.gradle ) dodaj wtyczkę usług Google jako zależność:

      Kotlin

      plugins {
        id("com.android.application") version "7.3.0" apply false
        // ...
      
        // Add the dependency for the Google services Gradle plugin
        id("com.google.gms.google-services") version "4.4.0" apply false
      }
      

      Groovy

      plugins {
        id 'com.android.application' version '7.3.0' apply false
        // ...
      
        // Add the dependency for the Google services Gradle plugin
        id 'com.google.gms.google-services' version '4.4.0' apply false
      }
      
    2. W pliku Gradle modułu (na poziomie aplikacji) (zwykle <project>/<app-module>/build.gradle.kts lub <project>/<app-module>/build.gradle ) dodaj wtyczkę usług Google:

      Kotlin

      plugins {
        id("com.android.application")
      
        // Add the Google services Gradle plugin
        id("com.google.gms.google-services")
        // ...
      }
      

      Groovy

      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.kts lub <project>/<app-module>/build.gradle ) dodaj zależności dla produktów Firebase którego chcesz używać w swojej aplikacji. Zalecamy używanie Firebase Android BoM do kontrolowania wersji bibliotek.

    Analityka włączona

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

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

    Szukasz modułu bibliotecznego specyficznego dla Kotlina? Począwszy od października 2023 r. (Firebase BoM 32.5.0) zarówno programiści Kotlin, jak i Java mogą polegać na głównym module biblioteki (więcej informacji można znaleźć w często zadawanych pytaniach dotyczących tej inicjatywy ).

    Analityka nie jest włączona

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

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

    Szukasz modułu bibliotecznego specyficznego dla Kotlina? Począwszy od października 2023 r. (Firebase BoM 32.5.0) zarówno programiści Kotlin, jak i Java mogą polegać na głównym module biblioteki (więcej informacji można znaleźć w często zadawanych pytaniach dotyczących tej inicjatywy ).

  2. Po dodaniu zależności dla produktów, których chcesz używać, zsynchronizuj swój projekt Android z plikami Gradle.

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

Jeśli jednak masz problemy z konfiguracją, odwiedź stronę dotyczącą rozwiązywania problemów i często zadawanych pytań dotyczących systemu Android .



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 — a wszystko to 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ź aktualizacje
    • macOS: Android Studio > Sprawdź aktualizacje
  2. Otwórz Asystenta Firebase: Narzędzia > Firebase .

  3. W panelu Asystent wybierz produkt Firebase, który chcesz dodać do swojej aplikacji. Rozwiń jej sekcję, a następnie kliknij link do samouczka (na przykład Analytics > Rejestruj zdarzenie Analytics ).

    1. Kliknij Połącz z Firebase, aby połączyć swój projekt na Androida z Firebase.

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

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

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

  6. Dodaj dowolną liczbę innych produktów Firebase za pomocą Asystenta Firebase!

Otóż ​​to! Koniecznie zapoznaj się z zalecanymi kolejnymi krokami .

Jeśli jednak masz problemy z konfiguracją, odwiedź stronę dotyczącą rozwiązywania problemów i często zadawanych pytań dotyczących systemu Android .



Dostępne biblioteki

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

Pamiętaj, że podczas korzystania z Firebase Android BoM nie określasz poszczególnych wersji bibliotek, gdy deklarujesz zależności bibliotek Firebase w pliku konfiguracyjnym kompilacji Gradle.

Usługa lub Produkt Zależność Gradle’a Najnowszy
wersja
Dodać analitykę?
BoM Firebase na Androida
(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 informacje o wydaniu tej wersji BoM.

32.6.0
AdMob com.google.android.gms:play-services-ads 22.5.0
Analityka com.google.firebase:firebase-analytics 21.5.0
Sprawdź aplikację niestandardowego dostawcy com.google.firebase:firebase-appcheck 17.1.1
Dostawca debugowania sprawdzania aplikacji com.google.firebase:firebase-appcheck-debug 17.1.1
Dostawca sprawdzania aplikacji Play Integrity com.google.firebase:firebase-appcheck-playintegrity 17.1.1
Dystrybucja aplikacji com.google.firebase:firebase-appdistribution 16.0.0-beta11
Interfejs API dystrybucji aplikacji com.google.firebase:firebase-appdistribution-api 16.0.0-beta11
Wtyczka do dystrybucji aplikacji com.google.firebase:firebase-appdistribution-gradle 4.0.1
Uwierzytelnianie com.google.firebase:firebase-auth 22.3.0
Chmura Firestore com.google.firebase:firebase-firestore 24.9.1
Funkcje chmury dla pakietu SDK klienta Firebase com.google.firebase:firebase-functions 20.4.0
Wiadomości w chmurze com.google.firebase:firebase-messaging 23.3.1
Magazyn w chmurze com.google.firebase:firebase-storage 20.3.0
Crashlytics com.google.firebase:firebase-crashlytics 18.6.0
Crashlytics NDK com.google.firebase:firebase-crashlytics-ndk 18.6.0
Wtyczka Crashlytics com.google.firebase:firebase-crashlytics-gradle 2.9.9
Obsługa dynamicznych modułów funkcyjnych com.google.firebase:firebase-dynamic-module-support 16.0.0-beta03
Linki dynamiczne com.google.firebase:firebase-dynamic-links 21.2.0
Wiadomości w aplikacji com.google.firebase:firebase-inappmessaging 20.4.0
(wymagany)
Wyświetlanie wiadomości w aplikacji com.google.firebase:firebase-inappmessaging-display 20.4.0
(wymagany)
Instalacje Firebase com.google.firebase:firebase-installations 17.2.0
Interfejs API pobierania modeli Firebase ML com.google.firebase:firebase-ml-modeldownloader 24.2.1
Monitoring wydajności com.google.firebase:firebase-perf 20.5.1
Wtyczka do monitorowania wydajności com.google.firebase:perf-plugin 1.4.2
Baza danych czasu rzeczywistego com.google.firebase:firebase-database 20.3.0
Zdalna konfiguracja com.google.firebase:firebase-config 21.6.0
Wtyczka usług Google Play com.google.gms:google-services 4.4.0
WYCOFANE BIBLIOTEKI
App Sprawdź dostawcę SafetyNet com.google.firebase:firebase-appcheck-safetynet 16.1.2
Indeksowanie aplikacji com.google.firebase:firebase-appindexing 20.0.0

Moduły Firebase KTX

Analityka com.google.firebase:firebase-analytics-ktx 21.5.0
Sprawdź aplikację niestandardowego dostawcy com.google.firebase:firebase-appcheck-ktx 17.1.1
Interfejs API dystrybucji aplikacji com.google.firebase:firebase-appdistribution-api-ktx 16.0.0-beta11
Uwierzytelnianie com.google.firebase:firebase-auth-ktx 22.3.0
Chmura Firestore com.google.firebase:firebase-firestore-ktx 24.9.1
Funkcje chmury dla pakietu SDK klienta Firebase com.google.firebase:firebase-functions-ktx 20.4.0
Wiadomości w chmurze com.google.firebase:firebase-messaging-ktx 23.3.1
Magazyn w chmurze com.google.firebase:firebase-storage-ktx 20.3.0
Crashlytics com.google.firebase:firebase-crashlytics-ktx 18.6.0
Linki dynamiczne com.google.firebase:firebase-dynamic-links-ktx 21.2.0
Wiadomości w aplikacji com.google.firebase:firebase-inappmessaging-ktx 20.4.0
(wymagany)
Wyświetlanie wiadomości w aplikacji com.google.firebase:firebase-inappmessaging-display-ktx 20.4.0
(wymagany)
Instalacje Firebase com.google.firebase:firebase-installations-ktx 17.2.0
Interfejs API pobierania modeli Firebase ML com.google.firebase:firebase-ml-modeldownloader-ktx 24.2.1
Monitoring wydajności com.google.firebase:firebase-perf-ktx 20.5.1
Baza danych czasu rzeczywistego com.google.firebase:firebase-database-ktx 20.3.0
Zdalna konfiguracja com.google.firebase:firebase-config-ktx 21.6.0

Biblioteki zestawu Firebase ML Kit

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 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: 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-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-reply-model 20.0.8



Następne kroki

Dodaj usługi Firebase do swojej aplikacji:

Dowiedz się więcej o Firebase: