Предпосылки
Установите или обновите Android Studio до последней версии.
Убедитесь, что ваш проект соответствует этим требованиям (обратите внимание, что к некоторым продуктам могут предъявляться более строгие требования):
- Целевой уровень API 21 (Lollipop) или выше
- Использует Android 5.0 или выше.
- Использует Jetpack (AndroidX) , который включает в себя соответствие следующим требованиям к версии:
-
com.android.tools.build:gradle
v7.3.0 или более поздняя версия -
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 для подключения к нему. Подробнее о проектах Firebase можно узнать в разделе «Понимание проектов Firebase».
Шаг 2 : Зарегистрируйте свое приложение в Firebase
Чтобы использовать Firebase в вашем приложении для Android, вам необходимо зарегистрировать его в проекте Firebase. Регистрация приложения часто называется «добавлением» приложения в проект.
Перейдите в консоль Firebase .
В центре страницы обзора проекта нажмите значок Android (
) или «Добавить приложение» , чтобы запустить рабочий процесс настройки.Введите имя пакета вашего приложения в поле «Имя пакета Android» .
(Необязательно) Введите другую информацию о приложении: псевдоним приложения и сертификат подписи отладки SHA-1 .
Нажмите «Зарегистрировать приложение» .
Шаг 3 : Добавьте файл конфигурации Firebase
Загрузите и добавьте файл конфигурации Firebase вашего приложения (
) в вашу кодовую базу:google-services.json Нажмите «Загрузить google-services.json» , чтобы получить файл конфигурации Firebase вашего приложения.
Переместите файл конфигурации в корневой каталог модуля (уровня приложения) вашего приложения.
Чтобы сделать значения в файле конфигурации
доступными для Firebase SDK, вам понадобится плагин Gradle для сервисов Google (google-services.json google-services
).В файле Gradle корневого уровня (уровня проекта) (
<project>/build.gradle.kts
или<project>/build.gradle
) добавьте плагин служб Google в качестве зависимости:Kotlin
plugins { id("com.android.application") version "7.3.0" apply false // ... // Add the dependency for the Google services Gradle plugin id("com.google.gms.google-services") version "4.4.3" apply false }
Groovy
plugins { id 'com.android.application' version '7.3.0' apply false // ... // Add the dependency for the Google services Gradle plugin id 'com.google.gms.google-services' version '4.4.3' apply false }
В файле Gradle вашего модуля (уровня приложения) (обычно
<project>/<app-module>/build.gradle.kts
или<project>/<app-module>/build.gradle
) добавьте плагин служб Google:Kotlin
plugins { id("com.android.application") // Add the Google services Gradle plugin id("com.google.gms.google-services") // ... }
Groovy
plugins { id 'com.android.application' // Add the Google services Gradle plugin id 'com.google.gms.google-services' // ... }
Шаг 4 : Добавьте Firebase SDK в свое приложение
В файле Gradle вашего модуля (уровня приложения) (обычно
<project>/<app-module>/build.gradle.kts
или<project>/<app-module>/build.gradle
) добавьте зависимости для продуктов Firebase , которые вы хотите использовать в своём приложении. Мы рекомендуем использовать Firebase Android BoM для управления версиями библиотеки.Analytics включена
dependencies { // ... // Import the Firebase BoM implementation(platform("com.google.firebase:firebase-bom:34.0.0")) // When using the BoM, you don't specify versions in Firebase library dependencies // Add the dependency for the Firebase SDK for Google Analytics implementation("com.google.firebase:firebase-analytics") // TODO: Add the dependencies for any other Firebase products you want to use // See https://firebase.google.com/docs/android/setup#available-libraries // For example, add the dependencies for Firebase Authentication and Cloud Firestore implementation("com.google.firebase:firebase-auth") implementation("com.google.firebase:firebase-firestore") }
Используя Firebase Android BoM , ваше приложение всегда будет использовать совместимые версии библиотек Firebase Android.
Analytics не включена
dependencies { // ... // Import the Firebase BoM implementation(platform("com.google.firebase:firebase-bom:34.0.0")) // When using the BoM, you don't specify versions in Firebase library dependencies // TODO: Add the dependencies for Firebase products you want to use // See https://firebase.google.com/docs/android/setup#available-libraries // For example, add the dependencies for Firebase Authentication and Cloud Firestore implementation("com.google.firebase:firebase-auth") implementation("com.google.firebase:firebase-firestore") }
Используя Firebase Android BoM , ваше приложение всегда будет использовать совместимые версии библиотек Firebase Android.
После добавления зависимостей для продуктов, которые вы хотите использовать, синхронизируйте свой проект Android с файлами Gradle.
Вот и всё! Вы можете перейти к рекомендуемым дальнейшим действиям .
Если у вас возникли проблемы с настройкой, посетите страницу устранения неполадок и часто задаваемых вопросов для Android .
Вариант 2 : добавление Firebase с помощью Firebase Assistant
Помощник Firebase регистрирует ваше приложение в проекте Firebase и добавляет необходимые файлы Firebase, плагины и зависимости в ваш проект Android — и все это в Android Studio!
Откройте свой Android-проект в Android Studio и убедитесь, что вы используете последние версии Android Studio и Firebase Assistant:
- Windows / Linux: Справка > Проверить наличие обновлений
- macOS: Android Studio > Проверить наличие обновлений
Откройте Firebase Assistant: Инструменты > Firebase .
На панели «Помощник» выберите продукт Firebase для добавления в приложение. Разверните его раздел и нажмите на ссылку с руководством (например,
Analytics > Регистрация события Аналитики ). Нажмите «Подключиться к Firebase» , чтобы подключить свой Android-проект к Firebase. Нажмите кнопку, чтобы добавить нужный продукт Firebase (например, «
Добавить Analytics в ваше приложение »).
Синхронизируйте свое приложение, чтобы убедиться, что все зависимости имеют необходимые версии.
На панели «Помощник» следуйте оставшимся инструкциям по настройке выбранного вами продукта Firebase.
Добавьте столько других продуктов Firebase, сколько захотите, с помощью Firebase Assistant!
Вот и всё! Обязательно ознакомьтесь с рекомендуемыми дальнейшими шагами .
Если у вас возникли проблемы с настройкой, посетите страницу устранения неполадок и часто задаваемых вопросов для Android .
Доступные библиотеки
В этом разделе перечислены продукты Firebase, поддерживаемые для Android, и их зависимости от Gradle. Узнайте больше о библиотеках Firebase для Android:
Обратите внимание, что при использовании Firebase Android BoM вы не указываете отдельные версии библиотеки при объявлении зависимостей библиотеки Firebase в файле конфигурации сборки Gradle.
Услуга или продукт | Зависимость Gradle | Последний версия | Добавить Analytics ? | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Firebase Android BoM ( Bill of Materials ) | com.google.firebase:firebase-bom Последняя версия Firebase BoM содержит последние версии каждой библиотеки Firebase для Android. Чтобы узнать, какие версии библиотек соответствуют конкретной версии BoM , ознакомьтесь с примечаниями к выпуску для этой версии BoM . | 34.0.0 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
AdMob | com.google.android.gms:play-services-ads | 24.4.0 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Firebase AI Logic 1 | com.google.firebase:firebase-ai | 17.0.0 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Analytics | com.google.firebase:firebase-analytics | 23.0.0 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Пользовательский поставщик App Check | com.google.firebase:firebase-appcheck | 19.0.0 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Поставщик отладки App Check | com.google.firebase:firebase-appcheck-debug | 19.0.0 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Поставщик App Check Play | com.google.firebase:firebase-appcheck-playintegrity | 19.0.0 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
App Distribution | com.google.firebase:firebase-appdistribution | 16.0.0-beta16 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
API App Distribution | com.google.firebase:firebase-appdistribution-api | 16.0.0-beta16 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Плагин App Distribution | com.google.firebase:firebase-appdistribution-gradle | 5.1.1 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Authentication | com.google.firebase:firebase-auth | 24.0.0 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Cloud Firestore | com.google.firebase:firebase-firestore | 26.0.0 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Cloud Functions for Firebase Client SDK | com.google.firebase:firebase-functions | 22.0.0 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Cloud Messaging | com.google.firebase:firebase-messaging | 25.0.0 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Cloud Storage | com.google.firebase:firebase-storage | 22.0.0 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Crashlytics | com.google.firebase:firebase-crashlytics | 20.0.0 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Crashlytics NDK | com.google.firebase:firebase-crashlytics-ndk | 20.0.0 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Плагин Crashlytics | com.google.firebase:firebase-crashlytics-gradle | 3.0.5 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Data Connect | com.google.firebase:firebase-dataconnect | 17.0.0 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Поддержка динамических модулей функций | com.google.firebase:firebase-dynamic-module-support | 16.0.0-beta04 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Dynamic Links | com.google.firebase:firebase-dynamic-links | 22.1.0 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
In-App Messaging | com.google.firebase:firebase-inappmessaging | 22.0.0 | (необходимый) | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Отображение In-App Messaging | com.google.firebase:firebase-inappmessaging-display | 22.0.0 | (необходимый) | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Установки Firebase | com.google.firebase:firebase-installations | 19.0.0 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
API загрузчика моделей Firebase ML | com.google.firebase:firebase-ml-modeldownloader | 26.0.0 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Performance Monitoring | com.google.firebase:firebase-perf | 22.0.0 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Плагин Performance Monitoring | com.google.firebase:perf-plugin | 2.0.0 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Realtime Database | com.google.firebase:firebase-database | 22.0.0 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Remote Config | com.google.firebase:firebase-config | 23.0.0 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Плагин сервисов Google Play | com.google.gms:google-services | 4.4.3 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
УСТАРЕВШИЕ БИБЛИОТЕКИ | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Поставщик App Check SafetyNet | com.google.firebase:firebase-appcheck-safetynet | 16.1.2 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
App Indexing | com.google.firebase:firebase-appindexing | 20.0.0 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Модули Firebase KTX
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Библиотеки Firebase ML Kit
|
1 Firebase AI Logic ранее назывался « Vertex AI in Firebase » с пакетом com.google.firebase:firebase-vertexai
.
Следующие шаги
Добавьте службы Firebase в свое приложение:
Создавайте генеративные функции ИИ с помощью моделей Gemini и Imagen , используя Firebase AI Logic .
Получайте информацию о поведении пользователей с помощью Analytics .
Настройте процесс аутентификации пользователя с помощью Authentication .
Храните данные, например информацию о пользователях, с помощью Cloud Firestore или Realtime Database .
Храните файлы, такие как фотографии и видео, с помощью Cloud Storage .
Запустите внутренний код, работающий в безопасной среде с помощью Cloud Functions .
Отправляйте уведомления с помощью Cloud Messaging .
Узнайте, когда и почему ваше приложение дает сбой, с помощью Crashlytics .
Узнайте о Firebase:
Посетите страницу Understand Firebase Projects , чтобы узнать больше о проектах Firebase и передовых методах ведения проектов.
Посетите раздел «Узнайте больше об Android и Firebase», если у вас есть вопросы о концепциях, которые вам незнакомы или характерны для разработки под Firebase и Android.
Изучите примеры приложений Firebase .
Получите практический опыт работы с Firebase Android Codelab .
Узнайте больше с помощью курса «Firebase за выходные» .
Подготовьтесь к запуску вашего приложения:
- Настройте оповещения о бюджете для вашего проекта в консоли Google Cloud .
- Отслеживайте панель использования и выставления счетов в консоли Firebase , чтобы получить общую картину использования вашего проекта в различных службах Firebase.
- Ознакомьтесь с контрольным списком запуска Firebase .
Возникли проблемы с Firebase и вашим проектом Android? Посетите страницу «Устранение неполадок и часто задаваемые вопросы по Android» .