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

Предпосылки

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

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

    • Ориентирован на уровень API 19 (KitKat) или выше.
    • Использует Android 4.4 или выше
    • Использует Jetpack (AndroidX) , который включает в себя выполнение следующих требований к версии:
      • com.android.tools.build:gradle v3.2.1 или новее
      • 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 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.10'  // 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. Добавьте SDK Firebase в свое приложение.

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

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

    Ява

    dependencies {
      // ...
    
      // Import the Firebase BoM
      implementation platform('com.google.firebase:firebase-bom:29.0.4')
    
      // When using the BoM, you don't specify versions in Firebase library dependencies
    
      // Declare the dependency for the Firebase SDK for Google Analytics
      implementation 'com.google.firebase:firebase-analytics'
    
      // Declare the dependencies for any other desired Firebase products
      // For example, declare the dependencies for Firebase Authentication and Cloud Firestore
      implementation 'com.google.firebase:firebase-auth'
      implementation 'com.google.firebase:firebase-firestore'
    }
    

    Котлин+КТХ

    dependencies {
      // ...
    
      // Import the Firebase BoM
      implementation platform('com.google.firebase:firebase-bom:29.0.4')
    
      // When using the BoM, you don't specify versions in Firebase library dependencies
    
      // Declare the dependency for the Firebase SDK for Google Analytics
      implementation 'com.google.firebase:firebase-analytics-ktx'
    
      // Declare the dependencies for any other desired Firebase products
      // For example, declare the dependencies for Firebase Authentication and Cloud Firestore
      implementation 'com.google.firebase:firebase-auth-ktx'
      implementation 'com.google.firebase:firebase-firestore-ktx'
    }
    

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

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

    Ява

    dependencies {
      // ...
    
      // Import the Firebase BoM
      implementation platform('com.google.firebase:firebase-bom:29.0.4')
    
      // When using the BoM, you don't specify versions in Firebase library dependencies
    
      // Declare the dependencies for the desired Firebase products
      // For example, declare the dependencies for Firebase Authentication and Cloud Firestore
      implementation 'com.google.firebase:firebase-auth'
      implementation 'com.google.firebase:firebase-firestore'
    }
    

    Котлин+КТХ

    dependencies {
      // ...
    
      // Import the Firebase BoM
      implementation platform('com.google.firebase:firebase-bom:29.0.4')
    
      // When using the BoM, you don't specify versions in Firebase library dependencies
    
      // Declare the dependencies for the desired Firebase products
      // For example, declare the dependencies for Firebase Authentication and Cloud Firestore
      implementation 'com.google.firebase:firebase-auth-ktx'
      implementation 'com.google.firebase:firebase-firestore-ktx'
    }
    

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

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

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

Однако, если у вас возникли проблемы с настройкой, посетите раздел « Устранение неполадок Android и часто задаваемые вопросы » .



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

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

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

    • Windows/Linux: Справка > Проверить наличие обновлений
    • macOS: Android Studio > Проверить наличие обновлений
  2. Откройте Помощник Firebase: Инструменты > Firebase .

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

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

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

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

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

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

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

Однако, если у вас возникли проблемы с настройкой, посетите раздел « Устранение неполадок Android и часто задаваемые вопросы » .



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

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

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

Ява

Услуга или продукт зависимость Gradle Последний
версия
Добавить аналитику?
Спецификация Firebase для Android
(Список материалов)
com.google.firebase: firebase-бом

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

29.0.4
AdMob com.google.android.gms:play-сервисы-объявления 20.5.0
Аналитика com.google.firebase:firebase-аналитика 20.0.2
Приложение Проверить настраиваемый поставщик com.google.firebase:firebase-appcheck 16.0.0-бета04
Поставщик отладки проверки приложений com.google.firebase:firebase-appcheck-debug 16.0.0-бета04
Приложение Проверить провайдера SafetyNet com.google.firebase:firebase-appcheck-safetynet 16.0.0-бета04
Плагин распространения приложений com.google.firebase: firebase-appdistribution-gradle 3.0.0
Индексирование приложений com.google.firebase: firebase-appindexing 20.0.0
Аутентификация com.google.firebase:firebase-аутентификация 21.0.1
Облако Firestore com.google.firebase: firebase-firestore 24.0.1
Облачные функции для Firebase Client SDK com.google.firebase:firebase-функции 20.0.1
Облачный обмен сообщениями com.google.firebase: обмен сообщениями firebase 23.0.0
Облачное хранилище com.google.firebase:firebase-хранилище 20.0.0
Crashlytics com.google.firebase:firebase-crashlytics 18.2.7
Crashlytics НДК com.google.firebase:firebase-crashlytics-ndk 18.2.7
Плагин Crashlytics com.google.firebase: firebase-crashlytics-градле 2.8.1
Поддержка динамических функциональных модулей com.google.firebase:firebase-динамический-модуль-поддержка 16.0.0-бета01
Динамические ссылки com.google.firebase:firebase-динамические ссылки 21.0.0
Обмен сообщениями в приложении com.google.firebase:firebase-inappmessaging 20.1.1
(обязательный)
Отображение сообщений в приложении com.google.firebase:firebase-inappmessaging-display 20.1.1
(обязательный)
Установки Firebase com.google.firebase:firebase-установки 17.0.0
API загрузчика моделей Firebase ML com.google.firebase:firebase-ml-modeldownloader 24.0.1
Мониторинг производительности com.google.firebase: firebase-perf 20.0.4
Плагин мониторинга производительности com.google.firebase:perf-плагин 1.4.1
База данных реального времени com.google.firebase:firebase-база данных 20.0.3
Удаленная конфигурация com.google.firebase:firebase-config 21.0.1
Плагин сервисов Google Play com.google.gms:сервисы google 4.3.10
Устаревшие библиотеки
API пользовательских моделей Firebase ML com.google.firebase:firebase-ml-модель-интерпретатор 22.0.4
API Firebase ML Vision com.google.firebase: firebase-ml-видение 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 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-натуральный-язык-id-модель 20.0.8
Firebase ML: перевод модели com.google.firebase:firebase-ml-модель-перевода на естественном языке 20.0.9
Firebase ML: модель интеллектуальных ответов com.google.firebase:firebase-ml-естественный-язык-умная-модель-ответа 20.0.8

Котлин+КТХ

Услуга или продукт зависимость Gradle Последний
версия
Добавить аналитику?
Спецификация Firebase для Android
(Список материалов)
com.google.firebase: firebase-бом

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

29.0.4
AdMob com.google.android.gms:play-сервисы-объявления 20.5.0
Аналитика com.google.firebase: firebase-analytics-ktx 20.0.2
Приложение Проверить настраиваемый поставщик com.google.firebase:firebase-appcheck 16.0.0-бета04
Поставщик отладки проверки приложений com.google.firebase:firebase-appcheck-debug 16.0.0-бета04
Приложение Проверить провайдера SafetyNet com.google.firebase:firebase-appcheck-safetynet 16.0.0-бета04
Плагин распространения приложений com.google.firebase: firebase-appdistribution-gradle 3.0.0
Индексирование приложений com.google.firebase: firebase-appindexing 20.0.0
Аутентификация com.google.firebase: firebase-auth-ktx 21.0.1
Облако Firestore com.google.firebase: firebase-firestore-ktx 24.0.1
Облачные функции для Firebase Client SDK com.google.firebase: firebase-функции-ktx 20.0.1
Облачный обмен сообщениями com.google.firebase:firebase-сообщения-ktx 23.0.0
Облачное хранилище com.google.firebase: firebase-storage-ktx 20.0.0
Crashlytics com.google.firebase:firebase-crashlytics-ktx 18.2.7
Crashlytics НДК com.google.firebase:firebase-crashlytics-ndk 18.2.7
Плагин Crashlytics com.google.firebase: firebase-crashlytics-градле 2.8.1
Поддержка динамических функциональных модулей com.google.firebase:firebase-динамический-модуль-поддержка 16.0.0-бета01
Динамические ссылки com.google.firebase:firebase-динамические ссылки-ktx 21.0.0
Обмен сообщениями в приложении com.google.firebase:firebase-inappmessaging-ktx 20.1.1
(обязательный)
Отображение сообщений в приложении com.google.firebase:firebase-inappmessaging-display-ktx 20.1.1
(обязательный)
Установки Firebase com.google.firebase:firebase-installations-ktx 17.0.0
API загрузчика моделей Firebase ML com.google.firebase: firebase-ml-modeldownloader-ktx 24.0.1
Мониторинг производительности com.google.firebase: firebase-perf-ktx 20.0.4
Плагин мониторинга производительности com.google.firebase:perf-плагин 1.4.1
База данных реального времени com.google.firebase:firebase-база данных-ktx 20.0.3
Удаленная конфигурация com.google.firebase:firebase-config-ktx 21.0.1
Плагин сервисов Google Play com.google.gms:сервисы google 4.3.10
Устаревшие библиотеки
API пользовательских моделей Firebase ML com.google.firebase:firebase-ml-модель-интерпретатор 22.0.4
API Firebase ML Vision com.google.firebase: firebase-ml-видение 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 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-натуральный-язык-id-модель 20.0.8
Firebase ML: перевод модели com.google.firebase:firebase-ml-модель-перевода на естественном языке 20.0.9
Firebase ML: модель интеллектуальных ответов com.google.firebase:firebase-ml-естественный-язык-умная-модель-ответа 20.0.8



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

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

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

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

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

  • Храните файлы, например фотографии и видео, в облачном хранилище .

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

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

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

Узнайте о Firebase: