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 najczęstszych pytań dotyczących Firebase lub konkretnych usług znajdziesz w głównym artykule z najczęstszymi pytaniami na temat Firebase.
Możesz też sprawdzić repozytorium GitHub pakietu SDK Firebase na Androida, aby uzyskać aktualną listę zgłoszonych problemów i rozwiązań. Zachęcamy do zgłaszania tam również własnych problemów związanych z pakietem SDK Firebase na Androida.
Pojawia się błąd informujący, że nie udało się znaleźć biblioteki ktx.
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 wydawać 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 API KTX z wydanych wcześniej modułów KTX, zalecamy przeniesienie aplikacji na interfejsy API KTX z modułów głównych. Więcej informacji znajdziesz w najczęstszych pytaniach na temat tej inicjatywy.
Jak rozwiązać błąd „Klient OAuth2 już istnieje dla tej nazwy pakietu i SHA-1 w innym projekcie”?
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 SHA-1. Dowiedz się, jak rozwiązać ten problem.
Gdy dodaję Firebase do projektu aplikacji na Androida, pojawia się błąd „Nie można znaleźć”.
Ten błąd zwykle oznacza, że w aplikacji brakuje co najmniej 1 odwołania do repozytorium Maven Google. Pamiętaj, aby w pliku konfiguracji Gradle uwzględnić repozytorium Maven firmy Google (google()).
- Jeśli Twój projekt używa składni
plugins, uwzględnij 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 w pliku build.gradle.kts lub build.gradle na poziomie projektu.
Gdy dodaję pakiet SDK Firebase do projektu aplikacji na Androida, pojawia się błąd dotyczący obsługi invoke-custom i włączania odlukrzania.
W maju 2021 r. (Firebase BoM w wersji 28.0.0) Firebase wyłączył odlukrzanie we wszystkich swoich bibliotekach na Androida (zobacz informacje o wersji).
Ta zmiana oznacza, że kompilacje Gradle, które używają wtyczki Androida do obsługi Gradle (AGP) w wersji 4.2 lub starszej, muszą mieć włączoną obsługę Javy 8. W przeciwnym razie podczas dodawania pakietu SDK Firebase w tych projektach aplikacji 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 rozwiązać ten problem, możesz wybrać jedną z 2 opcji:
- Dodaj wymienione w komunikacie o błędzie
compileOptions do pliku build.gradle.kts lub build.gradle na poziomie aplikacji.
- Zwiększ wartość
minSdkVersion w projekcie aplikacji na Androida do 26 lub wyższej.
Po opublikowaniu aplikacji funkcja Zaloguj się przez Google wyświetla błąd „12500:”. Jak go naprawić?
Może się tak zdarzyć z 2 powodów: nie podano adresu e-mail do kontaktu z zespołem 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 aplikacji 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.5.0 |
com.google.gms.google-services |
| Wtyczka App Distribution |
com.google.firebase:firebase-appdistribution-gradle |
5.3.1 |
com.google.firebase.appdistribution |
| Wtyczka Crashlytics |
com.google.firebase:firebase-crashlytics-gradle |
3.0.8 |
com.google.firebase.crashlytics |
| Wtyczka Performance Monitoring |
com.google.firebase:perf-plugin |
2.0.2 |
com.google.firebase.firebase-perf |
Aby dodać wtyczkę Firebase do projektu aplikacji 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) (zwykle <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'
...
}
Jakie informacje o oprogramowaniu open source należy umieścić w aplikacji?
Pakiet SDK Firebase na Androida zawiera pomocniczy element Activity do wyświetlania informacji o licencji.