На этой странице представлены советы и рекомендации по устранению неполадок, специфичных для 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 из основных модулей . Подробности см. в разделе часто задаваемых вопросов (FAQ) по этой инициативе .
Как мне устранить ошибку: «Для этого имени пакета и SHA-1 уже существует клиент OAuth2 в другом проекте»?
Эта ошибка возникает, если мы обнаружим, что другой проект 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 на уровне проекта.
При добавлении SDK Firebase в мой Android-проект возникает ошибка, связанная с поддержкой invoke-custom и включением десахаризации.
В мае 2021 года ( Firebase BoM v28.0.0) Firebase отключил десахаризацию для всех своих библиотек Android (см. примечания к выпуску ).
Это изменение означает, что для сборок Gradle, использующих плагин Android Gradle (AGP) версии 4.2 или более ранних, необходимо включить поддержку Java 8. В противном случае при добавлении SDK Firebase эти проекты 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.2.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.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 для отображения информации о лицензии.
