Na tej stronie znajdziesz wskazówki i rozwiązania problemów związanych z Androidem, które mogą wystąpić podczas korzystania z Firebase.
Masz inne problemy lub nie widzisz swojego problemu na liście poniżej? Więcej informacji o Firebase i poszczególnych usługach znajdziesz w głównych najczęstszych pytaniach dotyczących Firebase.
Aktualną listę zgłoszonych problemów i rozwiązań znajdziesz w repozytorium GitHub pakietu SDK Firebase na Androida. Zachęcamy do zgłaszania tam również własnych problemów związanych z pakietem Firebase Android SDK.
Wyświetla się błąd informujący, że nie udało się rozpoznać biblioteki ktx lub nie można jej znaleźć.
Ten błąd prawdopodobnie występuje, ponieważ używasz Firebase BoM i określasz moduł KTX jako zależność biblioteki produktów.
W lipcu 2025 r. przestaliśmy publikować nowe wersje modułów KTX i usunęliśmy biblioteki KTX z Firebase Android BoM (wersja 34.0.0).
Jeśli używasz interfejsów KTX API z wcześniej opublikowanych modułów KTX, zalecamy przeniesienie aplikacji, aby zamiast tego korzystała z interfejsów KTX API z modułów głównych. Więcej informacji znajdziesz w najczęstszych pytaniach dotyczących tej inicjatywy.
Jak rozwiązać ten błąd: „W innym projekcie istnieje już klient OAuth2 dla tej nazwy pakietu oraz tego certyfikatu SHA-1”?
Ten błąd występuje, gdy wykryjemy, że inny projekt Firebase lub Google Cloud
zawiera identyfikator klienta OAuth 2.0 z podaną przez Ciebie nazwą pakietu
i certyfikatem SHA-1. Dowiedz się, jak rozwiązać ten problem.
Gdy dodaję Firebase do projektu na Androida, pojawia się błąd „Nie można znaleźć”.
Ten błąd zwykle oznacza, że w aplikacji brakuje co najmniej jednego odwołania do repozytorium Maven Google. W pliku konfiguracji Gradle uwzględnij repozytorium Maven firmy Google (google()).
- Jeśli Twój projekt korzysta ze składni
plugins, umieść ją w sekcji plugins w pliku settings.gradle.kts lub settings.gradle.
- Jeśli Twój projekt używa składni
buildscript, uwzględnij ją w sekcjach buildscript i allprojects pliku build.gradle.kts lub build.gradle na poziomie projektu.
Gdy dodaję pakiet SDK Firebase do projektu na Androida, pojawia się błąd dotyczący obsługi wywołania niestandardowego i włączania desugaryzacji.
W maju 2021 r. (Firebase BoM wersja 28.0.0) Firebase wyłączył desugaryzację we wszystkich bibliotekach Androida (patrz informacje o wersji).
Oznacza to, że kompilacje Gradle, które korzystają z wtyczki Androida do Gradle w wersji 4.2 lub starszej, muszą włączyć obsługę języka Java 8. W przeciwnym razie podczas dodawania pakietu SDK Firebase w tych projektach na Androida wystąpi błąd kompilacji:
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.
Aby naprawić błąd kompilacji, możesz wykonać jedną z tych czynności:
- Dodaj wymieniony znak
compileOptions z komunikatu o błędzie do pliku na poziomie aplikacji
build.gradle.kts lub build.gradle.
- Zwiększ
minSdkVersion w projekcie na Androida do poziomu 26 lub wyższego.
Po opublikowaniu aplikacji funkcja Zaloguj się przez Google wyświetla błąd „12500:”. Jak to naprawić?
Może się tak zdarzyć z 2 powodów: nie podano adresu e-mail do pomocy lub brakuje klucza SHA. Aby naprawić ten błąd, upewnij się, że wszystkie te warunki są spełnione:
Jak dodać wtyczki Firebase do projektu na Androida za pomocą składni buildscript?
Firebase ma te wtyczki Gradle:
| Nazwa wtyczki |
Współrzędne Maven |
Najnowsza wersja |
Identyfikator wtyczki |
| Wtyczka Usług Google Play |
com.google.gms:google-services |
4.4.4 |
com.google.gms.google-services |
| App Distribution wtyczka |
com.google.firebase:firebase-appdistribution-gradle |
5.2.0 |
com.google.firebase.appdistribution |
| Crashlytics wtyczka |
com.google.firebase:firebase-crashlytics-gradle |
3.0.6 |
com.google.firebase.crashlytics |
| Performance Monitoring wtyczka |
com.google.firebase:perf-plugin |
2.0.2 |
com.google.firebase.firebase-perf |
Aby dodać wtyczkę Firebase do projektu na Androida, który nadal używa składni buildscript:
W pliku Gradle na poziomie głównym (poziomie projektu) (<project>/build.gradle.kts lub <project>/build.gradle) dodaj wtyczkę jako zależność, używając jej współrzędnych 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
}
}
W pliku Gradle modułu (na poziomie aplikacji) (zazwyczaj <project>/<app-module>/build.gradle.kts lub <project>/<app-module>/build.gradle) dodaj wtyczkę, używając jej identyfikatora:
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'
...
}
