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

Предварительные требования

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

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

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

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

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

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


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

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


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

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

Шаг 1 : Создайте проект Firebase.

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

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

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

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

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

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

  4. (Необязательно) Введите псевдоним приложения — внутренний, удобный идентификатор, видимый только вам в консоли Firebase .

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

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

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

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

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

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

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

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

    2. В файл Gradle вашего модуля (уровня приложения) (обычно <project>/<app-module>/build.gradle.kts или <project>/<app-module>/build.gradle ) добавьте плагин Google Services:

      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 : Добавьте SDK Firebase в ваше приложение.

  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:34.7.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.

    Analytics отключена 

    dependencies {
  // ...

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

  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. В панели «Ассистент» выберите продукт Firebase, который хотите добавить в приложение. Разверните соответствующий раздел, затем нажмите на ссылку с руководством (например, Analytics > Зарегистрировать событие аналитики ).

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

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

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

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

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

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

Если у вас возникли проблемы с настройкой, посетите раздел устранения неполадок и часто задаваемые вопросы по 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 .

 34.7.0
AdMob com.google.android.gms:play-services-ads 24.9.0
Firebase AI Logic 1 com.google.firebase:firebase-ai 17.7.0
Analytics com.google.firebase:firebase-analytics 23.0.0
App Check пользовательский поставщик com.google.firebase:firebase-appcheck 19.0.1
Поставщик отладки App Check com.google.firebase:firebase-appcheck-debug 19.0.1
Поставщик услуг проверки целостности App Check Play com.google.firebase:firebase-appcheck-playintegrity 19.0.1
App Distribution com.google.firebase:firebase-appdistribution 16.0.0-бета17
API App Distribution com.google.firebase:firebase-appdistribution-api 16.0.0-бета17
Плагин App Distribution com.google.firebase:firebase-appdistribution-gradle 5.2.0
Authentication com.google.firebase:firebase-auth 24.0.1
Cloud Firestore com.google.firebase:firebase-firestore 26.0.2
Cloud Functions for Firebase Client SDK com.google.firebase:firebase-functions 22.1.0
Cloud Messaging com.google.firebase:firebase-messaging 25.0.1
Cloud Storage com.google.firebase:firebase-storage 22.0.1
Crashlytics com.google.firebase:firebase-crashlytics 20.0.3
Crashlytics NDK com.google.firebase:firebase-crashlytics-ndk 20.0.3
Плагин Crashlytics com.google.firebase:firebase-crashlytics-gradle 3.0.6
Data Connect com.google.firebase:firebase-dataconnect 17.1.2
Поддержка динамических функциональных модулей com.google.firebase:firebase-dynamic-module-support 16.0.0-beta04
In-App Messaging com.google.firebase:firebase-inappmessaging 22.0.2
(необходимый)
Отображение In-App Messaging com.google.firebase:firebase-inappmessaging-display 22.0.2
(необходимый)
Установка Firebase com.google.firebase:firebase-installations 19.0.1
API для загрузки моделей Firebase ML com.google.firebase:firebase-ml-modeldownloader 26.0.1
Performance Monitoring com.google.firebase:firebase-perf 22.0.4
Плагин Performance Monitoring com.google.firebase:perf-plugin 2.0.2
Firebase Phone Number Verification com.google.firebase:firebase-pnv 16.0.0-beta01
Realtime Database com.google.firebase:firebase-database 22.0.1
Remote Config com.google.firebase:firebase-config 23.0.1
плагин сервисов Google Play com.google.gms:google-services 4.4.4
УСТАРЕВШИЕ ИЛИ НЕ ПОДДЕРЖИВАЕМЫЕ БИБЛИОТЕКИ
Dynamic Links com.google.firebase:firebase-dynamic-links 22.1.0

Модули Firebase KTX больше не поддерживаются.

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

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

API для пользовательских моделей Firebase ML com.google.firebase:firebase-ml-model-interpreter 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-model 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-model 20.0.2
Firebase ML : Модель сканирования штрих-кодов 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 : API для обработки естественного языка com.google.firebase:firebase-ml-natural-language 22.0.1
Firebase ML : Модель идентификации языка com.google.firebase:firebase-ml-natural-language-language-id-model 20.0.8
Firebase ML : Модель перевода com.google.firebase:firebase-ml-natural-language-translate-model 20.0.9
Firebase ML : модель интеллектуального ответа com.google.firebase:firebase-ml-natural-language-smart-reply-model 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: