Требования
Установите или обновите Android Studio до последней версии.
Убедитесь, что ваш проект соответствует этим требованиям (обратите внимание, что для некоторых продуктов могут действовать более строгие требования):
- Целевой уровень API – 24 (Nougat) или выше.
- Android 7.0 или более поздней версии;
- Использует Jetpack (AndroidX), в том числе следующие версии:
com.android.tools.build:gradleверсии 7.3.0 или более поздней;compileSdkVersion28 или более поздней версии;
Настройте физическое устройство или используйте эмулятор для запуска приложения.
Обратите внимание, что для Firebase SDK, зависящих от Google Play services, на устройстве или эмуляторе должен быть установлен Google Play services.
Если у вас нет проекта для Android и вы просто хотите попробовать продукт Firebase, скачайте один из наших примеров для быстрого запуска.
Вы можете подключить приложение Android к Firebase одним из следующих способов:
- Вариант 1 (рекомендуется). Используйте рабочий процесс настройки консоли Firebase.
- Вариант 2. Используйте Firebase Assistant в Android Studio (может потребоваться дополнительная настройка).
Вариант 1. Добавьте Firebase с помощью консоли Firebase.
Чтобы добавить Firebase в приложение, нужно выполнить действия как в консоли Firebase, так и в вашем открытом проекте для Android. Например, вам потребуется скачать файлы конфигурации Firebase из консоли, а затем переместить их в проект для Android.
Шаг 1. Создайте проект Firebase
Прежде чем добавить Firebase в приложение для Android, создайте проект Firebase. Подробнее о проектах Firebase…
Шаг 2. Зарегистрируйте приложение в Firebase
Чтобы использовать Firebase в приложении для Android, необходимо зарегистрировать приложение в проекте Firebase. Регистрация приложения часто называется "добавлением" приложения в проект.
Перейдите в консоль Firebase.
На странице Project Overview (Обзор проекта) нажмите на значок Android () или Add app (Добавить приложение). Будет запущен мастер настройки.
В поле Название пакета Android укажите название пакета приложения.
Необязательно. Введите псевдоним приложения – внутренний идентификатор, который будет виден только вам в консоли Firebase.
Нажмите Register app (Зарегистрировать приложение).
Шаг 3. Добавьте файл конфигурации Firebase
Скачайте и добавьте в базу кода файл конфигурации Firebase для приложения (
):google-services.json Нажмите Download google-services.json (Скачать google-services.json), чтобы получить файл конфигурации Firebase для приложения.
Переместите файл конфигурации в корневой каталог модуля (на уровне приложения).
Чтобы сделать значения в файле конфигурации
доступными для Firebase SDK, вам понадобится плагин Google Services Gradle (google-services.json ).google-services В файле Gradle корневого уровня (уровня проекта) (
<project>/build.gradle.ktsили<project>/build.gradle) добавьте плагин сервисов Google для Gradle в качестве зависимости: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.6.0" 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.6.0' apply false }
В файл Gradle модуля (на уровне приложения) (обычно
<project>/<app-module>/build.gradle.ktsили<project>/<app-module>/build.gradle) добавьте плагин 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:35.2.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:35.2.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 Assistant регистрирует приложение в проекте Firebase и добавляет необходимые файлы, плагины и зависимости Firebase в проект для Android. Все это происходит в Android Studio.
Откройте проект для Android в Android Studio и убедитесь, что вы используете последние версии Android Studio и Firebase Assistant.
- Windows/Linux: Help (Справка) > Check for updates (Проверить наличие обновлений).
- macOS: Android Studio > Check for updates (Проверить наличие обновлений).
Откройте Firebase Assistant: Tools (Инструменты) > Firebase.
На панели Assistant (Помощник) выберите продукт Firebase, который хотите добавить в приложение. Разверните раздел и нажмите на ссылку руководства, например
Analytics > Log an Analytics event (Зарегистрировать событие Аналитики) .Нажмите Connect to Firebase (Подключиться к Firebase), чтобы связать проект для Android с Firebase.
Нажмите кнопку, чтобы добавить нужный продукт Firebase (например,
Добавить Analytics в приложение ).
Синхронизируйте приложение, чтобы убедиться, что для всех зависимостей есть необходимые версии.
На панели Assistant (Ассистент) следуйте инструкциям по настройке выбранного продукта Firebase.
Добавьте другие продукты Firebase с помощью Firebase Assistant.
Готово! Ознакомьтесь с рекомендациями.
Если у вас возникли проблемы с настройкой, посетите страницу Устранение неполадок и часто задаваемые вопросы (Android).
Доступные библиотеки
В этом разделе перечислены продукты Firebase, поддерживаемые для Android, и их зависимости Gradle. Подробнее об этих библиотеках Firebase для Android:
Firebase Android SDK Хранилище GitHub
Обратите внимание, что при использовании Firebase Android BoM вам не нужно указывать версии отдельных библиотек, когда вы объявляете зависимости библиотек Firebase в файле конфигурации сборки Gradle.
| Товар или услуга | Зависимость Gradle | Последняя версия |
Добавить Analytics? | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| Firebase Android BoM (Bill of Materials) |
com.google.firebase:firebase-bom
Последняя версия Firebase BoM содержит последние версии всех библиотек Firebase для Android. Чтобы узнать, какие версии библиотек сопоставлены с определенной версией BoM, ознакомьтесь с примечаниями к выпуску этой версии BoM. |
35.2.0 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Плагин Gradle для сервисов Google | com.google.gms:google-services | 4.6.0 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| AdMob | com.google.android.gms:play-services-ads | 25.5.0 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Firebase AI Logic 1 | com.google.firebase:firebase-ai | 18.2.0 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Firebase AI Logic On-Device | com.google.firebase:firebase-ai-ondevice | 16.0.0-beta08 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Firebase AI KSP | com.google.firebase:firebase-ai-ksp-processor | 17.0.0 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Analytics | com.google.firebase:firebase-analytics | 24.0.0 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| App Check специальный поставщик | com.google.firebase:firebase-appcheck | 20.1.0 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Отладочный поставщик App Check | com.google.firebase:firebase-appcheck-debug | 20.1.0 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| App Check Поставщик Play Integrity | com.google.firebase:firebase-appcheck-playintegrity | 20.1.0 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Поставщик App Check reCAPTCHA | com.google.firebase:firebase-appcheck-recaptcha | 20.1.0 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| App Distribution | com.google.firebase:firebase-appdistribution | 16.0.0-beta21 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| App Distribution API | com.google.firebase:firebase-appdistribution-api | 16.0.0-beta21 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Плагин App Distribution | com.google.firebase:firebase-appdistribution-gradle | 5.3.1 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Authentication | com.google.firebase:firebase-auth | 25.0.0 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Cloud Firestore | com.google.firebase:firebase-firestore | 27.2.0 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Cloud Functions for Firebase Client SDK | com.google.firebase:firebase-functions | 23.0.0 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Cloud Messaging | com.google.firebase:firebase-messaging | 26.0.2 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Cloud Storage | com.google.firebase:firebase-storage | 23.0.0 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Crashlytics | com.google.firebase:firebase-crashlytics | 21.1.0 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Crashlytics NDK | com.google.firebase:firebase-crashlytics-ndk | 21.1.0 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Плагин Crashlytics | com.google.firebase:firebase-crashlytics-gradle | 3.0.8 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Поддержка динамических модулей функций | com.google.firebase:firebase-dynamic-module-support | 16.0.0-beta05 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| In-App Messaging | com.google.firebase:firebase-inappmessaging | 23.0.0 | (обязательно) |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| In-App Messaging медийная реклама | com.google.firebase:firebase-inappmessaging-display | 23.0.0 | (обязательно) |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Firebase установок | com.google.firebase:firebase-installations | 20.0.0 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Performance Monitoring | com.google.firebase:firebase-perf | 23.0.1 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Плагин Performance Monitoring | com.google.firebase:perf-plugin | 2.0.2 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Firebase Phone Number Verification | com.google.firebase:firebase-pnv | 17.0.0 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Realtime Database | com.google.firebase:firebase-database | 23.0.0 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Remote Config | com.google.firebase:firebase-config | 24.0.1 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| SQL Connect 2 | com.google.firebase:firebase-dataconnect | 18.0.1 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| УСТАРЕВШИЕ ИЛИ НЕПОДДЕРЖИВАЕМЫЕ БИБЛИОТЕКИ | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Dynamic Links | com.google.firebase:firebase-dynamic-links | 22.1.0 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
Модули Firebase KTX больше не поддерживаются
|
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
Библиотеки Firebase ML и Firebase ML Kit
|
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
1 Приложение Firebase AI Logic ранее называлось Vertex AI in Firebase и имело пакет com.google.firebase:firebase-vertexai.
2 Firebase SQL Connect ранее назывался Firebase Data Connect.
Дальнейшие действия
Добавьте сервисы Firebase в приложение:
Создавайте функции на основе генеративного ИИ с моделями Gemini, используя Firebase AI Logic.
Получайте статистику о поведении пользователей с помощью Analytics.
Настройте процесс аутентификации пользователей с помощью Authentication.
Храните данные, например информацию о пользователях, с помощью Cloud Firestore или Realtime Database.
Храните файлы, например фото и видео, в Cloud Storage.
Запускайте серверный код, который выполняется в безопасной среде, с помощью Cloud Functions.
Отправлять уведомления с помощью Cloud Messaging.
Узнайте, когда и почему происходит сбой в работе приложения, с помощью Crashlytics.
Подробнее о Firebase:
Подробнее о проектах Firebase и рекомендациях по работе с ними…
Если у вас есть вопросы о незнакомых понятиях или особенностях разработки для Firebase и Android, посетите страницу Подробнее об Android и Firebase.
Ознакомьтесь с примерами приложений Firebase.
Подробнее об этом можно узнать из курса Firebase in a Weekend.
Подготовьтесь к запуску приложения:
- Настройте оповещения о бюджете для проекта в консоли Google Cloud.
- Следите за панелью управления Использование и оплата в консоли Firebase, чтобы получать общую картину использования вашего проекта в нескольких сервисах Firebase.
- Ознакомьтесь с контрольным списком для запуска Firebase.
Возникли проблемы с Firebase и проектом для Android? Ознакомьтесь с часто задаваемыми вопросами и инструкциями по устранению неполадок на устройствах Android.