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. Dodawanie 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.

    Analityka włączona 

    dependencies {
  // ...

  // Import the Firebase BoM
  implementation(platform("com.google.firebase:firebase-bom:33.1.2"))

  // 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), programiści, zarówno w języku Kotlin, jak i w języku Java, zależą od modułu biblioteki głównej (więcej informacji znajdziesz w Najczęstsze pytania na temat tej inicjatywy).

    Statystyki nie są włączone 

    dependencies {
  // ...

  // Import the Firebase BoM
  implementation(platform("com.google.firebase:firebase-bom:33.1.2"))

  // 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), programiści, zarówno w języku Kotlin, jak i w języku 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 BoM 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ć Analytics?
BoM Firebase na Androida
(lista materiałów)		 com.google.firebase:firebase-bom

Najnowsza wersja Firebase BoM zawiera najnowsze wersje każdej biblioteki Firebase na Androida. Informacje o wersjach biblioteki są zmapowane na konkretną wersję BoM, zapoznaj się z informacjami o wersji dla danej wersji BoM.

 33.1.2
AdMob com.google.android.gms:play-services-ads 23.2.0
Analytics com.google.firebase:firebase-analytics 22.0.2
Niestandardowy dostawca Sprawdzania aplikacji com.google.firebase:firebase-appcheck 18.0.0
Dostawca debugowania Sprawdzania aplikacji com.google.firebase:firebase-appcheck-debug 18.0.0
Dostawca usługi Sprawdzania integralności aplikacji w Play Integrity com.google.firebase:firebase-appcheck-playintegrity 18.0.0
Rozpowszechnianie aplikacji com.google.firebase:firebase-appdistribution 16.0.0-beta13
App Distribution API com.google.firebase:firebase-appdistribution-api 16.0.0-beta13
Wtyczka App Distribution com.google.firebase:firebase-appdistribution-gradle 5.0.0
Uwierzytelnianie com.google.firebase:firebase-auth 23.0.0
Cloud Firestore com.google.firebase:firebase-firestore 25.0.0
Pakiet SDK klienta Cloud Functions dla Firebase com.google.firebase:firebase-functions 21.0.0
Komunikacja w chmurze com.google.firebase:firebase-messaging 24.0.0
Cloud Storage com.google.firebase:firebase-storage 21.0.0
Crashlytics com.google.firebase:firebase-crashlytics 19.0.3
Crashlytics NDK com.google.firebase:firebase-crashlytics-ndk 19.0.3
Wtyczka Crahlytics 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
Linki dynamiczne com.google.firebase:firebase-dynamic-links 22.1.0
Wysyłanie wiadomości w aplikacji com.google.firebase:firebase-inappmessaging 21.0.0
(wymagane)
Wyświetlanie wiadomości w aplikacji com.google.firebase:firebase-inappmessaging-display 21.0.0
(wymagane)
Instalacje Firebase com.google.firebase:firebase-installations 18.0.0
Firebase ML Model Downloader API com.google.firebase:firebase-ml-modeldownloader 25.0.0
Monitorowanie wydajności com.google.firebase:firebase-perf 21.0.1
Wtyczka do monitorowania wydajności com.google.firebase:perf-plugin 1.4.2
Baza danych czasu rzeczywistego com.google.firebase:firebase-database 21.0.0
Zdalna konfiguracja com.google.firebase:firebase-config 22.0.0
Vertex AI dla Firebase com.google.firebase:firebase-vertexai 16.0.0-beta03
Wtyczka Usług Google Play com.google.gms:google-services 4.4.2
BIBLIOTEKI WYCOFANE
Dostawca SafetyNet do Sprawdzania aplikacji com.google.firebase:firebase-appcheck-safetynet 16.1.2
Indeksowanie aplikacji com.google.firebase:firebase-appindexing 20.0.0

Moduły Firebase KTX

Analytics com.google.firebase:firebase-analytics-ktx 22.0.2
Niestandardowy dostawca Sprawdzania aplikacji com.google.firebase:firebase-appcheck-ktx 18.0.0
App Distribution API com.google.firebase:firebase-appdistribution-api-ktx 16.0.0-beta13
Uwierzytelnianie com.google.firebase:firebase-auth-ktx 23.0.0
Cloud Firestore com.google.firebase:firebase-firestore-ktx 25.0.0
Pakiet SDK klienta Cloud Functions dla Firebase com.google.firebase:firebase-functions-ktx 21.0.0
Komunikacja w chmurze com.google.firebase:firebase-messaging-ktx 24.0.0
Cloud Storage com.google.firebase:firebase-storage-ktx 21.0.0
Crashlytics com.google.firebase:firebase-crashlytics-ktx 19.0.3
Linki dynamiczne com.google.firebase:firebase-dynamic-links-ktx 22.1.0
Wysyłanie wiadomości w aplikacji com.google.firebase:firebase-inappmessaging-ktx 21.0.0
(wymagane)
Wyświetlanie wiadomości w aplikacji com.google.firebase:firebase-inappmessaging-display-ktx 21.0.0
(wymagane)
Instalacje Firebase com.google.firebase:firebase-installations-ktx 18.0.0
Firebase ML Model Downloader API com.google.firebase:firebase-ml-modeldownloader-ktx 25.0.0
Monitorowanie wydajności com.google.firebase:firebase-perf-ktx 21.0.1
Baza danych czasu rzeczywistego com.google.firebase:firebase-database-ktx 21.0.0
Zdalna konfiguracja com.google.firebase:firebase-config-ktx 22.0.0

Biblioteki 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 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 kodów kreskowych com.google.firebase:firebase-ml-vision-barcode-model 16.1.2
Firebase ML: interfejs AutoML Vision Edge API com.google.firebase:firebase-ml-vision-automl 18.0.6
Firebase ML: interfejsy 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: 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-language-smart-reply-model 20.0.8


Dalsze kroki

Dodaj usługi Firebase do aplikacji:

Więcej informacji o Firebase: