Как добавить Firebase в проект для Android

Требования

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

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

    • Целевой уровень API – 24 (Nougat) или выше.
    • Android 7.0 или более поздней версии;
    • Использует Jetpack (AndroidX), в том числе следующие версии:
      • com.android.tools.build:gradle версии 7.3.0 или более поздней;
      • compileSdkVersion 28 или более поздней версии;
  • Настройте физическое устройство или используйте эмулятор для запуска приложения.
    Обратите внимание, что для Firebase SDK, зависящих от Google Play services, на устройстве или эмуляторе должен быть установлен Google Play services.

Если у вас нет проекта для 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…

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

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

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

  2. На странице Project Overview (Обзор проекта) нажмите на значок Android () или Add app (Добавить приложение). Будет запущен мастер настройки.

  3. В поле Название пакета Android укажите название пакета приложения.

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

  5. Нажмите Register app (Зарегистрировать приложение).

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

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

    1. Нажмите Download google-services.json (Скачать 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 для Gradle в качестве зависимости:

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

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

    Analytics не включено

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

    Благодаря 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: Help (Справка) > Check for updates (Проверить наличие обновлений).
    • macOS: Android Studio > Check for updates (Проверить наличие обновлений).
  2. Откройте Firebase Assistant: Tools (Инструменты) > Firebase.

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

    1. Нажмите Connect to Firebase (Подключиться к Firebase), чтобы связать проект для Android с Firebase.

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

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

  5. На панели Assistant (Ассистент) следуйте инструкциям по настройке выбранного продукта 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.

35.2.0
Плагин Gradle для сервисов Google com.google.gms:google-services 4.6.0
AdMob com.google.android.gms:play-services-ads 25.5.0
Firebase AI Logic 1 com.google.firebase:firebase-ai 18.2.0
Firebase AI Logic On-Device com.google.firebase:firebase-ai-ondevice 16.0.0-beta08
Firebase AI KSP com.google.firebase:firebase-ai-ksp-processor 17.0.0
Analytics com.google.firebase:firebase-analytics 24.0.0
App Check специальный поставщик com.google.firebase:firebase-appcheck 20.1.0
Отладочный поставщик App Check com.google.firebase:firebase-appcheck-debug 20.1.0
App Check Поставщик Play Integrity com.google.firebase:firebase-appcheck-playintegrity 20.1.0
Поставщик App Check reCAPTCHA com.google.firebase:firebase-appcheck-recaptcha 20.1.0
App Distribution com.google.firebase:firebase-appdistribution 16.0.0-beta21
App Distribution API com.google.firebase:firebase-appdistribution-api 16.0.0-beta21
Плагин App Distribution com.google.firebase:firebase-appdistribution-gradle 5.3.1
Authentication com.google.firebase:firebase-auth 25.0.0
Cloud Firestore com.google.firebase:firebase-firestore 27.2.0
Cloud Functions for Firebase Client SDK com.google.firebase:firebase-functions 23.0.0
Cloud Messaging com.google.firebase:firebase-messaging 26.0.2
Cloud Storage com.google.firebase:firebase-storage 23.0.0
Crashlytics com.google.firebase:firebase-crashlytics 21.1.0
Crashlytics NDK com.google.firebase:firebase-crashlytics-ndk 21.1.0
Плагин Crashlytics com.google.firebase:firebase-crashlytics-gradle 3.0.8
Поддержка динамических модулей функций com.google.firebase:firebase-dynamic-module-support 16.0.0-beta05
In-App Messaging com.google.firebase:firebase-inappmessaging 23.0.0
(обязательно)
In-App Messaging медийная реклама com.google.firebase:firebase-inappmessaging-display 23.0.0
(обязательно)
Firebase установок com.google.firebase:firebase-installations 20.0.0
Performance Monitoring com.google.firebase:firebase-perf 23.0.1
Плагин Performance Monitoring com.google.firebase:perf-plugin 2.0.2
Firebase Phone Number Verification com.google.firebase:firebase-pnv 17.0.0
Realtime Database com.google.firebase:firebase-database 23.0.0
Remote Config com.google.firebase:firebase-config 24.0.1
SQL Connect 2 com.google.firebase:firebase-dataconnect 18.0.1
УСТАРЕВШИЕ ИЛИ НЕПОДДЕРЖИВАЕМЫЕ БИБЛИОТЕКИ
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
App Distribution API Не используйте. Библиотеки модулей KTX больше не поддерживаются.
com.google.firebase:firebase-appdistribution-api-ktx
16.0.0-beta15
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
Firebase ML Model Downloader API Не используйте. Библиотеки модулей 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 и Firebase ML Kit

Firebase ML Custom Model API com.google.firebase:firebase-ml-model-interpreter 22.0.4
Firebase ML Model Downloader API com.google.firebase:firebase-ml-modeldownloader 26.1.1
Firebase ML Vision API 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: Natural Language 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.

2 Firebase SQL Connect ранее назывался Firebase Data Connect.



Дальнейшие действия

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

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

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

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

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

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

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

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

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

Подробнее о Firebase: