Предпосылки
Установите или обновите 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. Регистрация вашего приложения часто называется «добавлением» вашего приложения в проект.
Зайдите в консоль Firebase .
В центре страницы обзора проекта щелкните значок Android (
) или Добавить приложение, чтобы запустить рабочий процесс настройки.Введите имя пакета вашего приложения в поле имени пакета Android .
Имя пакета однозначно идентифицирует ваше приложение на устройстве и в магазине Google Play.
Имя пакета часто называют идентификатором приложения .
Найдите имя пакета вашего приложения в файле Gradle модуля (уровня приложения), обычно
app/build.gradle
(пример имени пакета:com.yourcompany.yourproject
).Имейте в виду, что значение имени пакета чувствительно к регистру и не может быть изменено для этого Android-приложения Firebase после его регистрации в вашем проекте Firebase.
(Необязательно) Введите другую информацию о приложении: псевдоним приложения и сертификат подписи отладки SHA-1 .
Псевдоним приложения : внутренний удобный идентификатор, который виден только вам в консоли Firebase.
Сертификат подписи отладки SHA-1 : хэш SHA-1 требуется для аутентификации Firebase (при использовании входа в систему Google или входа по номеру телефона ) и динамических ссылок Firebase .
Щелкните Зарегистрировать приложение .
Шаг 3. Добавьте файл конфигурации Firebase
Добавьте в приложение файл конфигурации Firebase Android:
Нажмите Загрузить google-services.json, чтобы получить файл конфигурации Firebase Android (
).google-services.json Переместите файл конфигурации в каталог модуля (уровня приложения) вашего приложения.
Конфигурационный файл Firebase содержит уникальные, но не секретные идентификаторы вашего проекта. Чтобы узнать больше об этом файле конфигурации, посетите Understand Firebase Projects .
Вы можете снова загрузить файл конфигурации Firebase в любое время.
Убедитесь, что к имени файла конфигурации не добавлены дополнительные символы, например
(2)
.
Чтобы включить продукты Firebase в своем приложении, добавьте плагин google-services в свои файлы Gradle.
В файле 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 // ... } }
В вашем модуле (уровне приложения) файле 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 в свое приложение
Используя Firebase Android BoM , объявите зависимости для продуктов Firebase, которые вы хотите использовать в своем приложении. Объявите их в файле Gradle вашего модуля (уровня приложения) (обычно
app/build.gradle
).Аналитика включена
Ява
dependencies { // ... // Import the Firebase BoM implementation platform('com.google.firebase:firebase-bom:26.6.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:26.6.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:26.6.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:26.6.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. Добавьте Firebase с помощью Firebase Assistant
Firebase Assistant регистрирует ваше приложение в проекте Firebase и добавляет необходимые файлы Firebase, плагины и зависимости в ваш проект Android - и все это прямо из Android Studio!
Откройте свой проект Android в Android Studio и получите доступ к Firebase Assistant:
Перейдите в Файл> Проверить наличие обновлений, чтобы убедиться, что вы используете последние версии Android Studio и Firebase Assistant.
Перейдите в Инструменты> Firebase, чтобы открыть панель Ассистента .
Выберите продукт Firebase, который хотите добавить в свое приложение. Разверните его раздел, затем щелкните ссылку учебника (например,
Analytics> Log an Analytics event ).Нажмите « Подключиться к Firebase», чтобы подключить свой проект Android к Firebase.
Этот рабочий процесс автоматически создает новое приложение Firebase для Android, используя имя пакета вашего приложения. Вы можете создать это новое приложение Firebase для Android либо в существующем проекте Firebase, либо в новом проекте.
Вот несколько советов по настройке проекта Firebase:
Посетите раздел «Общие сведения о проектах Firebase», чтобы узнать больше о передовых методах и рекомендациях по добавлению приложений в проект Firebase, в том числе о том, как обрабатывать несколько вариантов сборки.
Если вы создаете новый проект, мы настоятельно рекомендуем вам настроить Google Analytics для своего проекта, что позволит вам оптимально использовать многие продукты Firebase.
Этот рабочий процесс также добавляет файл конфигурации Android вашего проекта Firebase (
) в каталог модуля (уровня приложения) вашего приложения.google-services.json
Нажмите кнопку, чтобы добавить желаемый продукт Firebase (например, «
Добавить аналитику в свое приложение» ).
Синхронизируйте свое приложение, чтобы убедиться, что все зависимости имеют необходимые версии.
На панели Firebase Assistant следуйте оставшимся инструкциям по настройке для выбранного продукта Firebase.
Добавьте столько других продуктов 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. | 26.6.0 | |
AdMob | com.google.android.gms: play-services-ads | 19.7.0 | |
Аналитика | com.google.firebase: firebase-analytics | 18.0.2 | |
Индексирование приложений | com.google.firebase: firebase-appindexing | 19.2.0 | |
Аутентификация | com.google.firebase: firebase-auth | 20.0.3 | |
Cloud Firestore | com.google.firebase: firebase-firestore | 22.1.1 | |
Облачные функции для клиентского SDK Firebase | com.google.firebase: функции firebase | 19.2.0 | |
Обмен сообщениями в облаке | com.google.firebase: firebase-messaging | 21.0.1 | |
Облачное хранилище | com.google.firebase: хранилище firebase | 19.2.1 | |
Crashlytics | com.google.firebase: firebase-crashlytics | 17.3.1 | |
Динамические ссылки | com.google.firebase: firebase-dynamic-links | 19.1.1 | |
API загрузчика моделей Firebase ML | com.google.firebase: firebase-ml-modeldownloader | 23.0.0 | |
Обмен сообщениями в приложении | 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.6.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. | 26.6.0 | |
AdMob | com.google.android.gms: play-services-ads | 19.7.0 | |
Аналитика | com.google.firebase: firebase-analytics-ktx | 18.0.2 | |
Индексирование приложений | com.google.firebase: firebase-appindexing | 19.2.0 | |
Аутентификация | com.google.firebase: firebase-auth-ktx | 20.0.3 | |
Cloud Firestore | com.google.firebase: firebase-firestore-ktx | 22.1.1 | |
Облачные функции для клиентского 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.1 | |
Crashlytics | com.google.firebase: firebase-crashlytics-ktx | 17.3.1 | |
Динамические ссылки | com.google.firebase: firebase-dynamic-links-ktx | 19.1.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.6.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 в свое приложение:
Узнавайте о поведении пользователей с помощью Google Analytics .
Настройте поток проверки подлинности пользователя с помощью проверки подлинности .
Храните данные, например информацию о пользователях, в Cloud Firestore или Realtime Database .
Храните файлы, например фотографии и видео, в облачном хранилище .
Запускайте бэкэнд-код, который работает в безопасной среде с облачными функциями .
Отправляйте уведомления с помощью Cloud Messaging .
Узнайте, когда и почему ваше приложение дает сбой, с помощью Crashlytics .
Узнайте о Firebase:
Посетите Understand Firebase Projects, чтобы узнать больше о проектах Firebase и лучших методах работы с ними.
Посетите раздел Подробнее об Android и Firebase, если у вас есть вопросы о концепциях, которые незнакомы или характерны для разработки Firebase и Android.
Ознакомьтесь с примерами приложений Firebase .
Получите практический опыт работы с Firebase Android Codelab .
Узнайте больше о Firebase на курсе выходного дня .
Подготовьтесь к запуску вашего приложения:
- Настройте оповещения о бюджете для своего проекта в Google Cloud Console.
- Следите за своей панелью использования и выставления счетов в консоли Firebase.
- Ознакомьтесь с контрольным списком запуска Firebase .