Эта страница была переведа с помощью Cloud Translation API.
Switch to English

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

Предпосылки

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

  • Убедитесь, что ваш проект соответствует этим требованиям:

    • Целевой уровень API 16 (Jelly Bean) или более поздний
    • Использует Gradle 4.1 или новее
    • Использует Jetpack (AndroidX) , который включает следующие требования к версии:
      • com.android.tools.build:gradle v3.2.1 или новее
      • compileSdkVersion 28 или новее
  • Настройте физическое устройство или используйте эмулятор для запуска приложения.
    Эмуляторы должны использовать образ эмулятора с 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.

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

  1. Зайдите в консоль Firebase .

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

    Если вы уже добавили приложение в свой проект Firebase, нажмите « Добавить приложение», чтобы отобразить параметры платформы.

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

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

  5. Щелкните Зарегистрировать приложение .

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

  1. Добавьте в приложение файл конфигурации Firebase Android:

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

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

  2. Чтобы включить продукты Firebase в своем приложении, добавьте плагин google-services в свои файлы Gradle.

    1. В файле Gradle корневого уровня (уровня проекта) ( build.gradle ) добавьте правила для включения подключаемого модуля Gradle служб Google. Убедитесь, что у вас есть репозиторий Google Maven.

      buildscript {
      
        repositories {
          // Check that you have the following line (if not, add it):
          google()  // Google's Maven repository
        }
      
        dependencies {
          // ...
      
          // Add the following line:
          classpath 'com.google.gms:google-services:4.3.3'  // Google Services plugin
        }
      }
      
      allprojects {
        // ...
      
        repositories {
          // Check that you have the following line (if not, add it):
          google()  // Google's Maven repository
          // ...
        }
      }
      
    2. В файле Gradle модуля (уровня приложения) (обычно app/build.gradle ) примените подключаемый модуль Gradle служб Google:

      apply plugin: 'com.android.application'
      // Add the following line:
      apply plugin: 'com.google.gms.google-services'  // Google Services plugin
      
      android {
        // ...
      }
      

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

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

    Аналитика включена

    dependencies {
      // ...
    
      // Add the Firebase SDK for Google Analytics
      implementation 'com.google.firebase:firebase-analytics:17.5.0'
    
      // Add the dependencies for any other Firebase products you want to use in your app
      // For example, to also use Firebase Authentication
      implementation 'com.google.firebase:firebase-auth:19.3.2'
    
      // Getting a "Could not find" error? Make sure that you've added
      // Google's Maven repository to your root-level build.gradle file
    }
    

    Аналитика не включена

    dependencies {
      // ...
    
      // Add the dependencies for the Firebase products you want to use in your app
      // For example, to use Firebase Authentication
      implementation 'com.google.firebase:firebase-auth:19.3.2'
    
      // Getting a "Could not find" error? Make sure that you've added
      // Google's Maven repository to your root-level build.gradle file
    }
    
  2. Синхронизируйте свое приложение, чтобы убедиться, что все зависимости имеют необходимые версии.

  3. Если вы добавили Google Analytics, запустите приложение, чтобы отправить в Firebase подтверждение того, что вы успешно интегрировали Firebase. В противном случае вы можете пропустить этап проверки.

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

Это оно! Вы можете перейти к следующим шагам .

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

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

Обратите внимание, что для подключения вашего приложения к Firebase рекомендуется использовать рабочий процесс настройки консоли Firebase .

  1. Откройте свой Android-проект в Android Studio.

  2. Выберите Инструменты> Firebase, чтобы открыть панель Ассистента .

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

  4. Щелкните Подключиться к Firebase, чтобы подключить свой проект Android к Firebase.

  5. На панели Firebase Assistant нажмите кнопку, чтобы добавить зависимость библиотеки для выбранного продукта Firebase (например, « Добавить аналитику в свое приложение» ).

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

  7. Если вы добавили Google Analytics, запустите приложение, чтобы отправить в Firebase подтверждение того, что вы успешно интегрировали Firebase. В противном случае вы можете пропустить этот этап проверки.

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

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

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

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

Управление версиями библиотеки с помощью спецификации Firebase Bill of Materials (BoM)

Чтобы упростить управление версиями библиотеки, подумайте об импорте спецификации Firebase Bill of Materials (BoM).

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

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

  • Справочная документация ( Java | Kotlin + KTX )

  • Репозиторий Firebase Android SDK на GitHub

Ява

Услуга или продукт Зависимости Gradle Добавить аналитику?
AdMob com.google.android.gms: стыковые услуги-объявления: 19.3.0
аналитика com.google.firebase: firebase-аналитика: 17.5.0
Индексирование приложений com.google.firebase: firebase-appindexing: 19.1.0
Аутентификация com.google.firebase: firebase-аутентификации: 19.3.2
Cloud Firestore com.google.firebase: firebase-Firestore: 21.5.0
Облачные функции для Firebase Client SDK com.google.firebase: firebase-функции: 19.0.2
Обмен сообщениями в облаке com.google.firebase: firebase-сообщения: 20.2.4
Облачное хранилище com.google.firebase: firebase-хранения: 19.1.1
Crashlytics com.google.firebase: firebase-crashlytics: 17.2.1
Динамические ссылки com.google.firebase: firebase-динамическая-ссылка: 19.1.0
API-интерфейсы Firebase ML Vision com.google.firebase: firebase-мл-видение: 24.1.0
API пользовательских моделей Firebase ML com.google.firebase: firebase-мл-модель-переводчик: 22.0.4
Обмен сообщениями в приложении com.google.firebase: firebase-inappmessaging: 19.1.0
(обязательный)
Отображение сообщений в приложении com.google.firebase: firebase-inappmessaging-дисплей: 19.1.0
(обязательный)
Мониторинг производительности com.google.firebase: firebase-перфорация: 19.0.8
База данных в реальном времени com.google.firebase: firebase-база данных: 19.3.1
Удаленная конфигурация com.google.firebase: firebase-конфигурации: 19.2.0
Спецификация материалов Firebase (BoM) com.google.firebase: firebase-бом: 25.8.0

Последняя версия Firebase BoM содержит последние версии каждой библиотеки Firebase Android, доступной на момент выпуска BoM. Для версий библиотеки, сопоставленных с предыдущими версиями BoM, просмотрите примечания к выпуску для этой версии.

Плагин сервисов Google Play com.google.gms: Google-услуги: 4.3.3
Устаревшие библиотеки
Firebase ML: модель маркировки изображений com.google.firebase: firebase-мл-видение-изображение метки-модель: 20.0.2
Firebase ML: модель обнаружения и отслеживания объектов com.google.firebase: firebase-мл-видение-объект детектирования-модель: 19.0.6
Firebase ML: модель распознавания лиц com.google.firebase: firebase-мл-зрения-лицо-модель: 20.0.2
Firebase ML: модель сканирования штрих-кода com.google.firebase: firebase-мл-видение-штрих-модель: 16.1.2
Firebase ML: API AutoML Vision Edge com.google.firebase: firebase-мл-зрения-automl: 18.0.6
Firebase ML: API естественного языка com.google.firebase: firebase-мл-естественный язык: 22.0.1
Firebase ML: модель идентификации языка com.google.firebase: firebase-мл-естественный язык язык-ID-модель: 20.0.8
Firebase ML: перевод модели com.google.firebase: firebase-мл-естественный язык перевод-модель: 20.0.9
Firebase ML: модель умного ответа com.google.firebase: firebase-мл-естественный язык смарт-ответ-модель: 20.0.8

Котлин + KTX

Услуга или продукт Зависимости Gradle Добавить аналитику?
AdMob com.google.android.gms: стыковые услуги-объявления: 19.3.0
аналитика com.google.firebase: firebase-аналитика-KTX: 17.5.0
Индексирование приложений com.google.firebase: firebase-appindexing: 19.1.0
Аутентификация com.google.firebase: firebase-Auth-KTX: 19.3.2
Cloud Firestore com.google.firebase: firebase-Firestore-KTX: 21.5.0
Облачные функции для Firebase Client SDK com.google.firebase: firebase-функции-KTX: 19.0.2
Обмен сообщениями в облаке com.google.firebase: firebase-сообщения: 20.2.4
Облачное хранилище com.google.firebase: firebase-хранение-KTX: 19.1.1
Crashlytics com.google.firebase: firebase-crashlytics: 17.2.1
Динамические ссылки com.google.firebase: firebase-динамическая-ссылка-KTX: 19.1.0
API-интерфейсы Firebase ML Vision com.google.firebase: firebase-мл-видение: 24.1.0
API пользовательских моделей Firebase ML com.google.firebase: firebase-мл-модель-переводчик: 22.0.4
Обмен сообщениями в приложении com.google.firebase: firebase-inappmessaging-KTX: 19.1.0
(обязательный)
Отображение сообщений в приложении com.google.firebase: firebase-inappmessaging-дисплей-KTX: 19.1.0
(обязательный)
Мониторинг производительности com.google.firebase: firebase-перфорация: 19.0.8
База данных в реальном времени com.google.firebase: firebase-база-KTX: 19.3.1
Удаленная конфигурация com.google.firebase: firebase-конфиг-KTX: 19.2.0
Спецификация материалов Firebase (BoM) com.google.firebase: firebase-бом: 25.8.0

Последняя версия Firebase BoM содержит последние версии каждой библиотеки Firebase Android, доступной на момент выпуска BoM. Для версий библиотеки, сопоставленных с предыдущими версиями BoM, просмотрите примечания к выпуску для этой версии.

Плагин сервисов Google Play com.google.gms: Google-услуги: 4.3.3
Устаревшие библиотеки
Firebase ML: модель маркировки изображений com.google.firebase: firebase-мл-видение-изображение метки-модель: 20.0.2
Firebase ML: модель обнаружения и отслеживания объектов com.google.firebase: firebase-мл-видение-объект детектирования-модель: 19.0.6
Firebase ML: модель распознавания лиц com.google.firebase: firebase-мл-зрения-лицо-модель: 20.0.2
Firebase ML: модель сканирования штрих-кода com.google.firebase: firebase-мл-видение-штрих-модель: 16.1.2
Firebase ML: API AutoML Vision Edge com.google.firebase: firebase-мл-зрения-automl: 18.0.6
Firebase ML: API естественного языка com.google.firebase: firebase-мл-естественный язык: 22.0.1
Firebase ML: модель идентификации языка com.google.firebase: firebase-мл-естественный язык язык-ID-модель: 20.0.8
Firebase ML: перевод модели com.google.firebase: firebase-мл-естественный язык перевод-модель: 20.0.9
Firebase ML: модель умного ответа com.google.firebase: firebase-мл-естественный язык смарт-ответ-модель: 20.0.8

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

Узнайте о Firebase:

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