Dodaj Firebase do swojego projektu na Androida

Wymagania wstępne

  • Instalowanie lub aktualizowanie Android Studio do najnowszej wersji.

  • Sprawdź, czy Twój projekt spełnia te wymagania (pamiętaj, że niektóre usługi mogą mieć bardziej rygorystyczne wymagania):

    • Docelowy poziom interfejsu API: 19 (KitKat) lub więcej
    • ma Androida 4.4 lub nowszego,
    • Zastosowania Jetpack (AndroidX), w tym:
      • com.android.tools.build:gradle w wersji 7.3.0 lub nowszej
      • compileSdkVersion 28 lub nowsze
  • Skonfiguruj urządzenie fizyczne lub użyj emulator na uruchom aplikację.
    Pamiętaj, że pakiety SDK Firebase zależą od Google Play usługi wymagają urządzenia lub emulatorowi, by mieć zainstalowane Usługi Google Play.

  • Zaloguj się w Firebase, korzystając ze swojego konta Google koncie.

Jeśli nie masz jeszcze projektu na Androida, a chcesz tylko wypróbować Firebase możesz pobrać nasze krótkie wprowadzenia.


Swoją aplikację na Androida możesz połączyć z Firebase przy użyciu jednej z tych metod: opcje:

  • Opcja 1: (zalecana) Użyj Proces konfiguracji konsoli Firebase.
  • Opcja 2. Użycie Firebase w Android Studio Asystent (może wymagać dodatkowej konfiguracji).



Opcja 1. Dodaj Firebase za pomocą konsoli Firebase

Dodanie Firebase do aplikacji wymaga wykonywania zadań zarówno w konsoli Firebase, jak w otwartym projekcie Androida (np. pobierasz pliki konfiguracyjne Firebase, w konsoli, a następnie przenieś je do projektu Androida).

Krok 1. Utwórz projekt Firebase

Zanim dodasz Firebase do swojej aplikacji na Androida, musisz utworzyć taką aplikację do połączenia z aplikacją na Androida. Odwiedź Więcej informacji o projektach Firebase Projekty Firebase.

Krok 2. Zarejestruj aplikację w Firebase

Aby używać Firebase w swojej aplikacji na Androida, musisz ją zarejestrować w projekt Firebase. Rejestracja aplikacji często nazywa się „dodawaniem” aplikacji na w projektach AI.

  1. Otwórz konsolę Firebase.

  2. Na środku strony przeglądu projektu kliknij ikonę Androida. () lub Dodaj aplikację, aby rozpocząć proces konfiguracji.

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

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

  5. Kliknij Zarejestruj aplikację.

Krok 3. Dodaj plik konfiguracji Firebase

  1. Pobierz i dodaj plik konfiguracji Firebase na Androida (google-services.json) do Twojej aplikacji:

    1. Kliknij Pobierz google-services.json, aby uzyskać Firebase na Androida. .

    2. Przenieś plik konfiguracyjny do katalogu głównego module (poziom aplikacji) serwera do aplikacji.

  2. Aby udostępnić wartości w pliku konfiguracyjnym google-services.json do pakietów SDK Firebase, Wtyczka 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 Wtyczka 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.2" 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.2' 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 aplikacji

  1. w pliku Gradle (na poziomie aplikacji) modułu, (zwykle <project>/<app-module>/build.gradle.kts lub <project>/<app-module>/build.gradle), dodaj zależności dla argumentu Usługi Firebase których chcesz użyć w aplikacji. Zalecamy użycie metody Firebase Android BoM do sterowania obsługi wersji biblioteki.

    Włączono: Analytics

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

    Za pomocą Firebase Android BoM, Twoja aplikacja zawsze będzie używać zgodnych wersji Firebase na Androida biblioteki.

    Szukasz modułu biblioteki korzystającego z usługi Kotlin? Zaczyna się za Październik 2023 r. (Firebase BoM 32.5.0) zarówno programiści Kotlin, jak i Java zależą od modułu biblioteki głównej (więcej informacji znajdziesz w Najczęstsze pytania na temat tej inicjatywy).

    Funkcja Analytics nie została włączona

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

    Za pomocą Firebase Android BoM, Twoja aplikacja zawsze będzie używać zgodnych wersji Firebase na Androida biblioteki.

    Szukasz modułu biblioteki korzystającego z usługi Kotlin? Zaczyna się za Październik 2023 r. (Firebase BoM 32.5.0) zarówno programiści Kotlin, jak i Java zależą od modułu biblioteki głównej (więcej informacji znajdziesz w Najczęstsze pytania na temat tej inicjatywy).

  2. Po dodaniu zależności usług, których chcesz używać, zsynchronizuj Projekt na Androida z plikami Gradle.

To wszystko. Możesz przejść dalej i sprawdzić polecane Dalsze kroki.

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



Opcja 2. Dodawanie Firebase za pomocą Asystenta Firebase

Asystent Firebase zarejestruje się z projektem Firebase i doda niezbędne pliki, wtyczki Firebase i zależności od projektu na Androida – a wszystko to z poziomu Android Studio.

  1. Otwórz projekt na Androida w Android Studio i sprawdź, czy za pomocą najnowszej wersji Android Studio i Asystenta Firebase:

    • Windows / Linux: Pomoc > Sprawdź dostępność aktualizacji
    • macOS: Android Studio > Sprawdź dostępność aktualizacji
  2. Otwórz Asystenta Firebase: Narzędzia > Firebase.

  3. W panelu Asystent wybierz usługę Firebase, którą chcesz dodać do aplikacji. Rozwiń jej sekcję i kliknij link samouczka (np. Analytics > Zarejestruj zdarzenie Analytics).

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

    2. Kliknij przycisk, aby dodać odpowiednią usługę Firebase (na przykład Dodaj Analytics do aplikacji).

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

  5. W panelu Asystent postępuj zgodnie z pozostałymi instrukcjami konfiguracji dotyczącymi wybranej usługi Firebase.

  6. Możesz dodać dowolną liczbę innych usług Firebase za pomocą tej usługi. Asystent!

To wszystko. Pamiętaj, aby zapoznać się z zalecanymi Dalsze kroki.

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



Dostępne biblioteki

W tej sekcji znajdziesz listę usług Firebase obsługiwanych na Androidzie oraz powiązanych z nimi usług Gradle zależności. Dowiedz się więcej o tych bibliotekach Firebase na Androida:

Pamiętaj, że podczas korzystania z narzędzia Firebase Android BoM przy deklarowaniu biblioteki Firebase nie określasz poszczególnych wersji bibliotek. zależności w pliku konfiguracji kompilacji Gradle.

Usługa lub produkt Zależność Gradle Najnowsza
wersja
Dodać konto Analytics?
Firebase Android BoM
(Bill of Materials)
com.google.firebase:firebase-bom

Najnowsza wersja Firebase BoM zawiera najnowsze wersje każdej biblioteki Firebase na Androida. Informacje o wersjach biblioteki są zmapowane do określonej wersji BoM, zapoznaj się z informacjami o wersji dla tej wersji BoM.

33.2.0
AdMob com.google.android.gms:play-services-ads 23.3.0
Analytics com.google.firebase:firebase-analytics 22.1.0
App Check dostawca niestandardowy com.google.firebase:firebase-appcheck 18.0.0
App Check dostawca debugowania com.google.firebase:firebase-appcheck-debug 18.0.0
App Check dostawca Play Integrity com.google.firebase:firebase-appcheck-playintegrity 18.0.0
App Distribution com.google.firebase:firebase-appdistribution 16.0.0-beta13
Interfejs API App Distribution com.google.firebase:firebase-appdistribution-api 16.0.0-beta13
Wtyczka App Distribution com.google.firebase:firebase-appdistribution-gradle 5.0.0
Authentication com.google.firebase:firebase-auth 23.0.0
Cloud Firestore com.google.firebase:firebase-firestore 25.1.0
Cloud Functions for Firebase Client SDK com.google.firebase:firebase-functions 21.0.0
Cloud Messaging com.google.firebase:firebase-messaging 24.0.1
Cloud Storage com.google.firebase:firebase-storage 21.0.0
Crashlytics com.google.firebase:firebase-crashlytics 19.0.3
Crashlytics DK com.google.firebase:firebase-crashlytics-ndk 19.0.3
Wtyczka Crashlytics com.google.firebase:firebase-crashlytics-gradle 3.0.2
Obsługa modułu funkcji dynamicznych com.google.firebase:firebase-dynamic-module-support 16.0.0-beta03
Dynamic Links com.google.firebase:firebase-dynamic-links 22.1.0
In-App Messaging com.google.firebase:firebase-inappmessaging 21.0.0
(wymagane)
In-App Messaging Sieć reklamowa com.google.firebase:firebase-inappmessaging-display 21.0.0
(wymagane)
Instalacje: Firebase com.google.firebase:firebase-installations 18.0.0
Interfejs API pobierania modeli Firebase ML com.google.firebase:firebase-ml-modeldownloader 25.0.0
Performance Monitoring com.google.firebase:firebase-perf 21.0.1
Wtyczka Performance Monitoring com.google.firebase:perf-plugin 1.4.2
Realtime Database com.google.firebase:firebase-database 21.0.0
Remote Config com.google.firebase:firebase-config 22.0.0
Vertex AI in Firebase com.google.firebase:firebase-vertexai 16.0.0-beta04
Wtyczka Usług Google Play com.google.gms:google-services 4.4.2
BIBLIOTEKI WYCOFANE
App Check dostawca SafetyNet com.google.firebase:firebase-appcheck-safetynet 16.1.2
App Indexing com.google.firebase:firebase-appindexing 20.0.0

Moduły Firebase KTX

Analytics com.google.firebase:firebase-analytics-ktx 22.1.0
App Check dostawca niestandardowy com.google.firebase:firebase-appcheck-ktx 18.0.0
Interfejs API App Distribution com.google.firebase:firebase-appdistribution-api-ktx 16.0.0-beta13
Authentication com.google.firebase:firebase-auth-ktx 23.0.0
Cloud Firestore com.google.firebase:firebase-firestore-ktx 25.1.0
Cloud Functions for Firebase Client SDK com.google.firebase:firebase-functions-ktx 21.0.0
Cloud Messaging com.google.firebase:firebase-messaging-ktx 24.0.1
Cloud Storage com.google.firebase:firebase-storage-ktx 21.0.0
Crashlytics com.google.firebase:firebase-crashlytics-ktx 19.0.3
Dynamic Links com.google.firebase:firebase-dynamic-links-ktx 22.1.0
In-App Messaging com.google.firebase:firebase-inappmessaging-ktx 21.0.0
(wymagane)
In-App Messaging Sieć reklamowa com.google.firebase:firebase-inappmessaging-display-ktx 21.0.0
(wymagane)
Instalacje: Firebase com.google.firebase:firebase-installations-ktx 18.0.0
Interfejs API pobierania modeli Firebase ML com.google.firebase:firebase-ml-modeldownloader-ktx 25.0.0
Performance Monitoring com.google.firebase:firebase-perf-ktx 21.0.1
Realtime Database com.google.firebase:firebase-database-ktx 21.0.0
Remote Config com.google.firebase:firebase-config-ktx 22.0.0

Biblioteki Firebase ML Kit

Firebase ML Interfejsy API modeli niestandardowych com.google.firebase:firebase-ml-model-interpreter 22.0.4
Firebase ML Vision API com.google.firebase:firebase-ml-vision 24.1.0
Firebase ML: model dodawania etykiet do 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 kodu kreskowego 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: Natural Language API 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



Dalsze kroki

Dodaj usługi Firebase do aplikacji:

Więcej informacji o Firebase: