Google 致力于为黑人社区推动种族平等。查看具体举措
Эта страница переведена с помощью 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 или новее
  • Настройте физическое устройство или используйте эмулятор для запуска приложения.
    Обратите внимание, что для пакетов SDK Firebase, зависящих от сервисов 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 ) добавьте правила для включения подключаемого модуля Gradle служб Google. Убедитесь, что у вас есть репозиторий Maven от Google.

      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.5'  // 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. С помощью Firebase Android BoM объявите зависимости для продуктов Firebase, которые вы хотите использовать в своем приложении. Объявите их в файле Gradle вашего модуля (уровня приложения) (обычно app/build.gradle ).

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

    Ява

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

    Котлин + KTX

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

    Котлин + KTX

    dependencies {
      // ...
    
      // Import the Firebase BoM
      implementation platform('com.google.firebase:firebase-bom:27.1.0')
    
      // 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. Синхронизируйте свое приложение, чтобы убедиться, что все зависимости имеют необходимые версии.

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



Вариант 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: Инструменты> Firebase .

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

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

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

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

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

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

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



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

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

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

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

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

Ява

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

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

27.1.0
AdMob com.google.android.gms: play-services-ads 20.1.0
Аналитика com.google.firebase: firebase-analytics 18.0.3
Индексирование приложений com.google.firebase: firebase-appindexing 19.2.0
Аутентификация com.google.firebase: firebase-auth 20.0.4
Cloud Firestore com.google.firebase: firebase-firestore 22.1.2
Облачные функции для клиентского SDK Firebase com.google.firebase: функции firebase 19.2.0
Обмен сообщениями в облаке com.google.firebase: firebase-messaging 21.1.0
Облачное хранилище com.google.firebase: хранилище firebase 19.2.2
Crashlytics com.google.firebase: firebase-crashlytics 17.4.1
Динамические ссылки com.google.firebase: firebase-dynamic-links 19.1.1
API загрузчика моделей Firebase ML com.google.firebase: firebase-ml-modeldownloader 23.0.1
Обмен сообщениями в приложении com.google.firebase: firebase-inappmessaging 19.1.5
(обязательный)
Отображение сообщений в приложении com.google.firebase: firebase-inappmessaging-display 19.1.5
(обязательный)
Мониторинг производительности com.google.firebase: firebase-perf 19.1.1
База данных в реальном времени com.google.firebase: база-данных firebase 19.7.0
Удаленная конфигурация com.google.firebase: firebase-config 20.0.4
Плагин сервисов Google Play com.google.gms: google-services 4.3.5
Устаревшие библиотеки
API пользовательских моделей Firebase ML com.google.firebase: firebase-ml-модель-интерпретатор 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: 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-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-естественный язык-умный-ответ-модель 20.0.8

Котлин + KTX

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

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

27.1.0
AdMob com.google.android.gms: play-services-ads 20.1.0
Аналитика com.google.firebase: firebase-analytics-ktx 18.0.3
Индексирование приложений com.google.firebase: firebase-appindexing 19.2.0
Аутентификация com.google.firebase: firebase-auth-ktx 20.0.4
Cloud Firestore com.google.firebase: firebase-firestore-ktx 22.1.2
Облачные функции для клиентского SDK Firebase com.google.firebase: firebase-functions-ktx 19.2.0
Обмен сообщениями в облаке com.google.firebase: firebase-messaging-ktx 21.0.1
Облачное хранилище com.google.firebase: firebase-storage-ktx 19.2.2
Crashlytics com.google.firebase: firebase-crashlytics-ktx 17.4.1
Динамические ссылки com.google.firebase: firebase-dynamic-links-ktx 19.1.1
API загрузчика моделей Firebase ML com.google.firebase: firebase-ml-modeldownloader-ktx 23.0.1
Обмен сообщениями в приложении com.google.firebase: firebase-inappmessaging-ktx 19.1.5
(обязательный)
Отображение сообщений в приложении com.google.firebase: firebase-inappmessaging-display-ktx 19.1.5
(обязательный)
Мониторинг производительности com.google.firebase: firebase-perf-ktx 19.1.1
База данных в реальном времени com.google.firebase: firebase-database-ktx 19.7.0
Удаленная конфигурация com.google.firebase: firebase-config-ktx 20.0.4
Плагин сервисов Google Play com.google.gms: google-services 4.3.5
Устаревшие библиотеки
API пользовательских моделей Firebase ML com.google.firebase: firebase-ml-модель-интерпретатор 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: 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-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-естественный язык-умный-ответ-модель 20.0.8



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

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

Узнайте о Firebase: