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 или новее
  • Настройте физическое устройство или используйте эмулятор для запуска приложения.
    Эмуляторы должны использовать образ эмулятора с 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. Убедитесь, что у вас есть репозиторий 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.4'  // 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:25.12.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:25.12.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:25.12.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'
    }
    
    // Getting a "Could not find" error? Make sure that you've added
    // Google's Maven repository to your root-level build.gradle file
    

    Котлин + KTX

    dependencies {
      // ...
    
      // Import the Firebase BoM
      implementation platform('com.google.firebase:firebase-bom:25.12.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'
    }
    
    // Getting a "Could not find" error? Make sure that you've added
    // Google's Maven repository to your root-level build.gradle file
    

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

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

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



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

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

  1. Откройте свой проект Android в Android Studio и получите доступ к Firebase Assistant:

    1. Перейдите в Файл> Проверить наличие обновлений, чтобы убедиться, что вы используете последние версии Android Studio и Firebase Assistant.

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

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

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

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

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

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

  5. Добавьте столько других продуктов 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.

25.12.0
AdMob com.google.android.gms: play-services-ads 19.4.0
Аналитика com.google.firebase: firebase-analytics 17.6.0
Индексирование приложений com.google.firebase: firebase-appindexing 19.1.0
Аутентификация com.google.firebase: firebase-auth 19.4.0
Cloud Firestore com.google.firebase: firebase-firestore 21.7.1
Облачные функции для Firebase Client SDK com.google.firebase: функции firebase 19.1.0
Обмен сообщениями в облаке com.google.firebase: firebase-messaging 20.3.0
Облачное хранилище com.google.firebase: хранилище firebase 19.2.0
Crashlytics com.google.firebase: firebase-crashlytics 17.2.2
Динамические ссылки com.google.firebase: firebase-dynamic-links 19.1.1
API-интерфейсы Firebase ML Vision com.google.firebase: firebase-ml-vision 24.1.0
API пользовательских моделей Firebase ML com.google.firebase: firebase-ml-model-интерпретатор 22.0.4
Обмен сообщениями в приложении com.google.firebase: firebase-inappmessaging 19.1.1
(обязательный)
Отображение сообщений в приложении com.google.firebase: firebase-inappmessaging-display 19.1.1
(обязательный)
Мониторинг производительности com.google.firebase: firebase-perf 19.0.9
База данных в реальном времени com.google.firebase: база-данных firebase 19.5.0
Удаленная конфигурация com.google.firebase: firebase-config 19.2.0
Плагин сервисов Google Play com.google.gms: google-services 4.3.4
Устаревшие библиотеки
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.

25.12.0
AdMob com.google.android.gms: play-services-ads 19.4.0
Аналитика com.google.firebase: firebase-analytics-ktx 17.6.0
Индексирование приложений com.google.firebase: firebase-appindexing 19.1.0
Аутентификация com.google.firebase: firebase-auth-ktx 19.4.0
Cloud Firestore com.google.firebase: firebase-firestore-ktx 21.7.1
Облачные функции для Firebase Client SDK com.google.firebase: firebase-functions-ktx 19.1.0
Обмен сообщениями в облаке com.google.firebase: firebase-messaging-ktx 20.3.0
Облачное хранилище com.google.firebase: firebase-storage-ktx 19.2.0
Crashlytics com.google.firebase: firebase-crashlytics-ktx 17.2.2
Динамические ссылки com.google.firebase: firebase-dynamic-links-ktx 19.1.1
API-интерфейсы Firebase ML Vision com.google.firebase: firebase-ml-vision 24.1.0
API пользовательских моделей Firebase ML com.google.firebase: firebase-ml-model-интерпретатор 22.0.4
Обмен сообщениями в приложении com.google.firebase: firebase-inappmessaging-ktx 19.1.1
(обязательный)
Отображение сообщений в приложении com.google.firebase: firebase-inappmessaging-display-ktx 19.1.1
(обязательный)
Мониторинг производительности com.google.firebase: firebase-perf-ktx 19.0.9
База данных в реальном времени com.google.firebase: firebase-database-ktx 19.5.0
Удаленная конфигурация com.google.firebase: firebase-config-ktx 19.2.0
Плагин сервисов Google Play com.google.gms: google-services 4.3.4
Устаревшие библиотеки
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: