Добавьте Firebase в свой проект Android

Предпосылки

  • Установите или обновите Android Studio до последней версии.

  • Убедитесь, что ваш проект соответствует следующим требованиям (обратите внимание, что к некоторым продуктам могут предъявляться более строгие требования):

    • Целевой уровень API 21 (Lollipop) или выше
    • Использует Android 5.0 или выше.
    • Использует Jetpack (AndroidX) , который включает в себя соответствие следующим требованиям к версии:
      • com.android.tools.build:gradle v7.3.0 или более поздняя версия
      • compileSdkVersion 28 или более поздняя версия

  • Настройте физическое устройство или используйте эмулятор для запуска вашего приложения.
    Обратите внимание, что Firebase SDK с зависимостью от сервисов Google Play требуют, чтобы на устройстве или эмуляторе были установлены сервисы Google Play.

  • Войдите в Firebase, используя свой аккаунт Google.

Если у вас еще нет проекта Android и вы просто хотите опробовать продукт Firebase, вы можете загрузить один из наших примеров быстрого старта .


Вы можете подключить свое Android-приложение к Firebase одним из следующих способов:

  • Вариант 1 : (рекомендуется) используйте рабочий процесс настройки консоли Firebase .
  • Вариант 2 : использование Android Studio Firebase Assistant (может потребоваться дополнительная настройка).


Вариант 1 : Добавить Firebase с помощью консоли Firebase

Добавление Firebase в ваше приложение включает в себя задачи как в консоли Firebase , так и в вашем открытом проекте Android (например, вы загружаете файлы конфигурации Firebase из консоли, а затем перемещаете их в свой проект Android).

Шаг 1 : Создание проекта Firebase

Прежде чем вы сможете добавить Firebase в свое приложение Android, вам нужно создать проект Firebase для подключения к вашему приложению Android. Посетите Understand Firebase Projects , чтобы узнать больше о проектах Firebase.

Шаг 2 : Зарегистрируйте свое приложение в Firebase

Чтобы использовать Firebase в вашем приложении Android, вам необходимо зарегистрировать ваше приложение в вашем проекте Firebase. Регистрация вашего приложения часто называется «добавлением» вашего приложения в ваш проект.

  1. Перейдите в консоль Firebase .

  2. В центре страницы обзора проекта щелкните значок Android ( ) или «Добавить приложение» , чтобы запустить рабочий процесс настройки.

  3. Введите имя пакета вашего приложения в поле «Имя пакета Android» .

  4. (Необязательно) Введите другую информацию о приложении: псевдоним приложения и сертификат подписи отладки SHA-1 .

  5. Нажмите «Зарегистрировать приложение» .

Шаг 3 : Добавьте файл конфигурации Firebase

  1. Загрузите и добавьте файл конфигурации Firebase вашего приложения ( google-services.json ) в вашу кодовую базу:

    1. Нажмите «Загрузить google-services.json» , чтобы получить файл конфигурации Firebase вашего приложения.

    2. Переместите файл конфигурации в корневой каталог модуля (уровня приложения) вашего приложения.

  2. Чтобы сделать значения в файле конфигурации google-services.json доступными для Firebase SDK, вам понадобится плагин Google Services Gradle ( google-services ).

    1. В файле Gradle корневого уровня (уровня проекта) ( <project>/build.gradle.kts или <project>/build.gradle ) добавьте плагин служб Google в качестве зависимости:

      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.3" 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.3' apply false
}

    2. В файле Gradle вашего модуля (уровня приложения) (обычно <project>/<app-module>/build.gradle.kts или <project>/<app-module>/build.gradle ) добавьте плагин служб 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'
  // ...
}

Шаг 4 : Добавьте Firebase SDK в свое приложение

  1. В файле Gradle вашего модуля (уровня приложения) (обычно <project>/<app-module>/build.gradle.kts или <project>/<app-module>/build.gradle ) добавьте зависимости для продуктов Firebase , которые вы хотите использовать в своем приложении. Мы рекомендуем использовать Firebase Android BoM для управления версиями библиотеки.

    Analytics включена 

    dependencies {
  // ...

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

    Благодаря использованию Firebase Android BoM ваше приложение всегда будет использовать совместимые версии библиотек Firebase Android.

    Ищете модуль библиотеки, специфичный для Kotlin? Начиная с октября 2023 года ( Firebase BoM 32.5.0) разработчики Kotlin и Java смогут полагаться на основной модуль библиотеки (подробности см. в разделе часто задаваемых вопросов об этой инициативе ).

    Analytics не включена 

    dependencies {
  // ...

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

    Благодаря использованию Firebase Android BoM ваше приложение всегда будет использовать совместимые версии библиотек Firebase Android.

    Ищете модуль библиотеки, специфичный для Kotlin? Начиная с октября 2023 года ( Firebase BoM 32.5.0) разработчики Kotlin и Java смогут полагаться на основной модуль библиотеки (подробности см. в разделе часто задаваемых вопросов об этой инициативе ).

  2. После добавления зависимостей для продуктов, которые вы хотите использовать, синхронизируйте свой проект Android с файлами Gradle.

Вот и все! Вы можете пропустить этот шаг и ознакомиться с рекомендуемыми дальнейшими шагами .

Если у вас возникли проблемы с настройкой, посетите страницу устранения неполадок и часто задаваемых вопросов на устройствах Android .


Вариант 2 : Добавить Firebase с помощью Firebase Assistant

Firebase Assistant регистрирует ваше приложение в проекте Firebase и добавляет необходимые файлы Firebase, плагины и зависимости в ваш проект Android — и все это прямо из Android Studio!

  1. Откройте свой проект Android в Android Studio, затем убедитесь, что вы используете последние версии Android Studio и Firebase Assistant:

    • Windows / Linux: Справка > Проверить наличие обновлений
    • macOS: Android Studio > Проверить наличие обновлений

  2. Откройте Firebase Assistant: Инструменты > Firebase .

  3. На панели Assistant выберите продукт Firebase для добавления в приложение. Разверните его раздел, затем щелкните ссылку на руководство (например, Analytics > Зарегистрировать событие Аналитики ).

    1. Нажмите «Подключиться к Firebase» , чтобы подключить свой проект Android к Firebase.

    2. Нажмите кнопку, чтобы добавить нужный продукт Firebase (например, « Добавить Analytics в ваше приложение »).

  4. Синхронизируйте свое приложение, чтобы убедиться, что все зависимости имеют необходимые версии.

  5. На панели помощника следуйте оставшимся инструкциям по настройке выбранного вами продукта Firebase.

  6. Добавьте столько других продуктов Firebase, сколько захотите, с помощью Firebase Assistant!

Вот и все! Обязательно ознакомьтесь с рекомендуемыми дальнейшими шагами .

Если у вас возникли проблемы с настройкой, посетите страницу устранения неполадок и часто задаваемых вопросов на устройствах Android .


Доступные библиотеки

В этом разделе перечислены продукты Firebase, поддерживаемые для Android, и их зависимости Gradle. Узнайте больше об этих библиотеках Firebase Android:

Обратите внимание, что при использовании Firebase Android BoM вы не указываете отдельные версии библиотеки при объявлении зависимостей библиотеки Firebase в файле конфигурации сборки Gradle.

Услуга или продукт Зависимость Gradle Последний
версия		 Добавить Analytics ?
Firebase Android BoM
( Bill of Materials )		 com.google.firebase:firebase-bom

Последняя версия Firebase BoM содержит последние версии каждой библиотеки Firebase Android. Чтобы узнать, какие версии библиотеки сопоставлены с определенной версией BoM , просмотрите заметки о выпуске для этой версии BoM .

 33.16.0
AdMob com.google.android.gms:play-services-ads 24.4.0
Firebase AI Логика 1 com.google.firebase:firebase-ai 16.2.0
Analytics com.google.firebase:firebase-analytics 22.5.0
Пользовательский поставщик App Check com.google.firebase:firebase-appcheck 18.0.0
Поставщик отладки App Check com.google.firebase:firebase-appcheck-debug 18.0.0
Поставщик App Check Play Integrity com.google.firebase:firebase-appcheck-playintegrity 18.0.0
App Distribution com.google.firebase:firebase-appdistribution 16.0.0-бета15
API App Distribution com.google.firebase:firebase-appdistribution-api 16.0.0-бета15
Плагин App Distribution com.google.firebase:firebase-appdistribution-gradle 5.1.1
Authentication com.google.firebase:firebase-auth 23.2.1
Cloud Firestore com.google.firebase:firebase-firestore 25.1.4
Cloud Functions for Firebase Client SDK com.google.firebase:firebase-функции 21.2.1
Cloud Messaging com.google.firebase:firebase-сообщения 24.1.2
Cloud Storage com.google.firebase:firebase-хранилище 21.0.2
Crashlytics com.google.firebase:firebase-crashlytics 19.4.4
Crashlytics NDK com.google.firebase:firebase-crashlytics-ndk 19.4.4
Плагин Crashlytics com.google.firebase:firebase-crashlytics-gradle 3.0.4
Data Connect com.google.firebase:firebase-dataconnect 16.0.3
Поддержка динамических функциональных модулей com.google.firebase:firebase-динамический-модуль-поддержка 16.0.0-бета03
Dynamic Links com.google.firebase:firebase-динамические-ссылки 22.1.0
In-App Messaging com.google.firebase:firebase-inappсообщения 21.0.2
(необходимый)
Отображение In-App Messaging com.google.firebase:firebase-inappmessaging-display 21.0.2
(необходимый)
Установки Firebase com.google.firebase:firebase-установки 18.0.0
API загрузчика моделей Firebase ML com.google.firebase:firebase-ml-modeldownloader 25.0.1
Performance Monitoring com.google.firebase:firebase-perf 21.0.5
Плагин Performance Monitoring com.google.firebase:perf-plugin 1.4.2
Realtime Database com.google.firebase:firebase-база данных 21.0.0
Remote Config com.google.firebase:firebase-config 22.1.2
Плагин сервисов Google Play com.google.gms:google-services 4.4.3
УСТАРЕВШИЕ БИБЛИОТЕКИ
Поставщик App Check SafetyNet com.google.firebase:firebase-appcheck-safetynet 16.1.2
App Indexing com.google.firebase:firebase-appindexing 20.0.0

Модули Firebase KTX

Analytics com.google.firebase:firebase-analytics-ktx 22.5.0
Пользовательский поставщик App Check com.google.firebase:firebase-appcheck-ktx 18.0.0
API App Distribution com.google.firebase:firebase-appdistribution-api-ktx 16.0.0-бета15
Authentication com.google.firebase:firebase-auth-ktx 23.2.1
Cloud Firestore com.google.firebase:firebase-firestore-ktx 25.1.4
Cloud Functions for Firebase Client SDK com.google.firebase:firebase-functions-ktx 21.2.1
Cloud Messaging com.google.firebase:firebase-messaging-ktx 24.1.2
Cloud Storage com.google.firebase:firebase-storage-ktx 21.0.2
Crashlytics com.google.firebase:firebase-crashlytics-ktx 19.4.4
Dynamic Links com.google.firebase:firebase-динамические-ссылки-ktx 22.1.0
In-App Messaging com.google.firebase:firebase-inappmessaging-ktx 21.0.2
(необходимый)
Отображение In-App Messaging com.google.firebase:firebase-inappmessaging-display-ktx 21.0.2
(необходимый)
Установки Firebase com.google.firebase:firebase-installations-ktx 18.0.0
API загрузчика моделей Firebase ML com.google.firebase:firebase-ml-modeldownloader-ktx 25.0.1
Performance Monitoring com.google.firebase:firebase-perf-ktx 21.0.5
Realtime Database com.google.firebase:firebase-database-ktx 21.0.0
Remote Config com.google.firebase:firebase-config-ktx 22.1.2

Библиотеки Firebase ML Kit

API-интерфейсы пользовательских моделей Firebase ML com.google.firebase:firebase-ml-модель-интерпретатор 22.0.4
API Firebase ML Vision com.google.firebase:firebase-ml-vision 24.1.0
Firebase ML : Модель маркировки изображений com.google.firebase:firebase-ml-vision-image-label-модель 20.0.2
Firebase ML : модель обнаружения и отслеживания объектов com.google.firebase:firebase-ml-vision-object-detection-model 19.0.6
Firebase ML : модель распознавания лиц com.google.firebase:firebase-ml-vision-face-модель 20.0.2
Firebase ML : модель сканирования штрихкодов com.google.firebase:firebase-ml-vision-штрихкод-модель 16.1.2
Firebase ML : API AutoML Vision Edge com.google.firebase:firebase-ml-vision-automl 18.0.6
Firebase ML : API естественного языка com.google.firebase:firebase-ml-естественный-язык 22.0.1
Firebase ML : модель идентификации языка com.google.firebase:firebase-ml-естественный-язык-идентификатор-языка-модель 20.0.8
Firebase ML : модель перевода com.google.firebase:firebase-ml-естественный-язык-перевод-модель 20.0.9
Firebase ML : модель интеллектуального ответа com.google.firebase:firebase-ml-естественный-язык-умная-модель-ответа 20.0.8

1 Firebase AI Logic ранее назывался « Vertex AI in Firebase » с пакетом com.google.firebase:firebase-vertexai .


Следующие шаги

Добавьте службы Firebase в свое приложение:

  • Создавайте генеративные функции ИИ с помощью моделей Gemini и Imagen , используя Firebase AI Logic .

  • Получайте информацию о поведении пользователей с помощью Analytics .

  • Настройте процесс аутентификации пользователя с помощью Authentication .

  • Храните данные, например информацию о пользователях, с помощью Cloud Firestore или Realtime Database .

  • Храните файлы, такие как фотографии и видео, в Cloud Storage .

  • Запустите внутренний код, который работает в безопасной среде с помощью Cloud Functions .

  • Отправляйте уведомления с помощью Cloud Messaging .

  • Узнайте, когда и почему ваше приложение дает сбой, с помощью Crashlytics .

Узнайте больше о Firebase: