Google is committed to advancing racial equity for Black communities. See how.
Эта страница была переведа с помощью 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 или более поздняя compileSdkVersion
  • Настройте физическое устройство или используйте эмулятор для запуска вашего приложения.
    Эмуляторы должны использовать изображение эмулятора с 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», чтобы узнать больше о передовых методах и соображениях по добавлению приложений в проект 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 ) добавьте правила, чтобы включить плагин Google Services Gradle. Убедитесь, что у вас есть репозиторий 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 ) примените плагин Google Services Gradle:

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

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

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

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

    dependencies {
      // ...
    
      // Add the Firebase SDK for Google Analytics
      implementation 'com.google.firebase:firebase-analytics:17.4.4'
    
      // 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. Если вы добавили 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 a Analytics event ).

  4. Нажмите Connect to Firebase, чтобы подключить ваш проект Android к Firebase.

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

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

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

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

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

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

Это оно! Не забудьте проверить рекомендуемые следующие шаги .

Управление версиями библиотеки с помощью ведомости материалов Firebase (BoM)

Для упрощения управления версиями библиотеки рассмотрите возможность импорта спецификации материалов Firebase (BoM).

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

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

Ява

Сервис или продукт Gradle зависимости Добавить аналитику?
AdMob com.google.android.gms: стыковые услуги-объявления: 19.3.0
аналитика com.google.firebase: firebase-аналитика: 17.4.4
Индексирование приложений com.google.firebase: firebase-appindexing: 19.1.0
Аутентификация com.google.firebase: firebase-аутентификации: 19.3.2
Облачный Пожарный Магазин 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.1.1
Динамические ссылки com.google.firebase: firebase-динамическая-ссылка: 19.1.0
API Firebase ML Vision com.google.firebase: firebase-мл-видение: 24.0.3
API пользовательской модели Firebase ML com.google.firebase: firebase-мл-модель-переводчик: 22.0.3
Обмен сообщениями в приложении 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.7.0

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

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

Котлин + KTX

Сервис или продукт Gradle зависимости Добавить аналитику?
AdMob com.google.android.gms: стыковые услуги-объявления: 19.3.0
аналитика com.google.firebase: firebase-аналитика-KTX: 17.4.4
Индексирование приложений com.google.firebase: firebase-appindexing: 19.1.0
Аутентификация com.google.firebase: firebase-Auth-KTX: 19.3.2
Облачный Пожарный Магазин 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.1.1
Динамические ссылки com.google.firebase: firebase-динамическая-ссылка-KTX: 19.1.0
API Firebase ML Vision com.google.firebase: firebase-мл-видение: 24.0.3
API пользовательской модели Firebase ML com.google.firebase: firebase-мл-модель-переводчик: 22.0.3
Обмен сообщениями в приложении 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.7.0

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

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

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

Узнайте о Firebase:

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