На этой странице представлены советы и рекомендации по устранению неполадок, характерных для Android, с которыми вы можете столкнуться при использовании Firebase.
Возникли другие проблемы или вы не нашли описание своей проблемы ниже? Обязательно ознакомьтесь с основными часто задаваемыми вопросами по Firebase, чтобы найти больше ответов на часто задаваемые вопросы по Firebase или по конкретному продукту.
Вы также можете ознакомиться с актуальным списком выявленных проблем и способов их устранения в репозитории Firebase Android SDK на GitHub . Мы также рекомендуем вам сообщать о своих проблемах, связанных с Firebase Android SDK!
Я получаю сообщение об ошибке, указывающее на то, что библиотека ktx не может быть разрешена или не может быть найдена.
Эта ошибка, скорее всего, возникает из-за того, что вы используете Firebase BoM и указываете модуль KTX в качестве зависимости библиотеки продукта.
В июле 2025 года мы прекратили выпуск новых версий модулей KTX и удалили библиотеки KTX из Firebase Android BoM (v34.0.0).
Если вы используете API KTX из ранее выпущенных модулей KTX, мы рекомендуем вам перенести приложение на использование API KTX из основных модулей . Подробнее см. в разделе часто задаваемых вопросов об этой инициативе .
Как устранить эту ошибку: «Клиент OAuth2 для этого имени пакета и SHA-1 уже существует в другом проекте»?
Эта ошибка возникает, если мы обнаруживаем, что другой проект Firebase или Google Cloud содержит идентификатор клиента OAuth 2.0 с указанным вами именем пакета и SHA-1. Узнайте, как устранить эту ошибку .
При добавлении Firebase в мой проект Android возникает ошибка «Не удалось найти».
Эта ошибка обычно означает, что в вашем приложении отсутствует одна или несколько ссылок на репозиторий Maven от Google. Убедитесь, что репозиторий Maven от Google ( google() ) включен в файл конфигурации Gradle.
- Если ваш проект использует синтаксис
plugins , включите его в раздел plugins в файле settings.gradle.kts или settings.gradle . - Если ваш проект использует синтаксис
buildscript , включите его в разделы buildscript и allprojects в файле build.gradle.kts или build.gradle уровня проекта.
Когда я добавляю Firebase SDK в свой проект Android, я получаю ошибку о поддержке invoke-custom и включении десугаринга.
В мае 2021 года ( Firebase BoM v28.0.0) Firebase отключила десахаризацию для всех своих библиотек Android (см. примечание к выпуску ).
Это изменение означает, что для сборок Gradle, использующих плагин Android Gradle (AGP) версии 4.2 или более ранней, необходимо включить поддержку Java 8. В противном случае при добавлении Firebase SDK эти проекты Android получат следующую ошибку сборки:
D8: Invoke-customs are only supported starting with Android O (--min-api 26)
Caused by: com.android.builder.dexing.DexArchiveBuilderException: Error while dexing.
The dependency contains Java 8 bytecode. Please enable desugaring by adding the following to build.gradle
android {
compileOptions {
sourceCompatibility 1.8
targetCompatibility 1.8
}
}
See https://developer.android.com/studio/write/java8-support.html for details.
Alternatively, increase the minSdkVersion to 26 or above.
Чтобы исправить эту ошибку сборки, вы можете воспользоваться одним из двух вариантов:
- Добавьте указанные
compileOptions из сообщения об ошибке в файл build.gradle.kts или build.gradle уровня приложения . - Увеличьте
minSdkVersion для вашего Android-проекта до 26 или выше.
После того, как я выпустил приложение, при входе через Google появляется ошибка «12500:». Как это исправить?
Это может произойти по двум причинам: вы не указали адрес электронной почты службы поддержки или у вас отсутствует ключ SHA. Чтобы исправить эту ошибку, убедитесь, что выполняются все следующие условия:
Как добавить плагины Firebase в проект Android, используя синтаксис buildscript ?
Firebase имеет следующие плагины Gradle:
| Имя плагина | Координаты Maven | Последняя версия | Идентификатор плагина |
|---|
| Плагин сервисов Google Play | com.google.gms:google-services | 4.4.4 | com.google.gms.google-services |
| Плагин App Distribution | com.google.firebase:firebase-appdistribution-gradle | 5.1.1 | com.google.firebase.appdistribution |
| Плагин Crashlytics | com.google.firebase:firebase-crashlytics-gradle | 3.0.6 | com.google.firebase.crashlytics |
| Плагин Performance Monitoring | com.google.firebase:perf-plugin | 2.0.1 | com.google.firebase.firebase-perf |
Вот как добавить плагин Firebase в проект Android, который по-прежнему использует синтаксис buildscript :
В файле Gradle корневого уровня (уровня проекта) ( <project>/build.gradle.kts или <project>/build.gradle ) добавьте плагин как зависимость, используя его координаты Maven:
Kotlin
buildscript {
repositories {
// Make sure that you have the following two repositories
google() // Google's Maven repository
mavenCentral() // Maven Central repository
}
dependencies {
...
// Add the Maven coordinates and latest version of the plugin
classpath ("PLUGIN_MAVEN_COORDINATES:PLUGIN_VERSION")
}
}
allprojects {
...
repositories {
// Make sure that you have the following two repositories
google() // Google's Maven repository
mavenCentral() // Maven Central repository
}
}
Groovy
buildscript {
repositories {
// Make sure that you have the following two repositories
google() // Google's Maven repository
mavenCentral() // Maven Central repository
}
dependencies {
...
// Add the Maven coordinates and latest version of the plugin
classpath 'PLUGIN_MAVEN_COORDINATES:PLUGIN_VERSION'
}
}
allprojects {
...
repositories {
// Make sure that you have the following two repositories
google() // Google's Maven repository
mavenCentral() // Maven Central repository
}
}
В файле Gradle вашего модуля (уровня приложения) (обычно <project>/<app-module>/build.gradle.kts или <project>/<app-module>/build.gradle ) добавьте плагин, используя его идентификатор плагина:
Kotlin
plugins {
id("com.android.application")
// Add the ID of the plugin
id("FIREBASE_PLUGIN_ID")
...
}
Groovy
plugins {
id 'com.android.application'
// Add the ID of the plugin
id 'FIREBASE_PLUGIN_ID'
...
}
