На этой странице приведены советы и инструкции по устранению неполадок, связанных с Android, которые могут возникнуть при использовании Firebase.
Если у вас возникли другие проблемы или вы не нашли нужную информацию ниже, Ознакомьтесь с основным разделом часто задаваемых вопросов о Firebase, чтобы найти ответы на вопросы о Firebase в целом или об отдельных продуктах.
Актуальный список известных проблем и способы их устранения можно найти в репозитории Firebase Android SDK на GitHub. Вы также можете сообщать там о проблемах, связанных с Firebase Android SDK.
Я получаю сообщение об ошибке, в котором говорится, что не удалось распознать или найти библиотеку ktx.
Скорее всего, эта ошибка возникает из-за того, что вы используете Firebase BoM и указываете модуль KTX в качестве зависимости библиотеки продукта.
В июле 2025 года мы прекратили выпуск новых версий модулей KTX и удалили библиотеки KTX из Firebase Android BoM (версия 34.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 версии 28.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.5.0 |
com.google.gms.google-services |
| Плагин App Distribution |
com.google.firebase:firebase-appdistribution-gradle |
5.3.1 |
com.google.firebase.appdistribution |
| Плагин Crashlytics |
com.google.firebase:firebase-crashlytics-gradle |
3.0.8 |
com.google.firebase.crashlytics |
| Плагин Performance Monitoring |
com.google.firebase:perf-plugin |
2.0.2 |
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'
...
}
Какие уведомления о ПО с открытым исходным кодом нужно добавить в приложение?
В Firebase Android SDK есть вспомогательный класс Activity, который позволяет показывать информацию о лицензии.
