Trang này cung cấp các mẹo và cách khắc phục sự cố dành riêng cho Android mà bạn có thể gặp phải khi sử dụng Firebase.
Bạn gặp phải vấn đề khác hoặc không thấy vấn đề của mình được nêu bên dưới? Hãy nhớ xem Câu hỏi thường gặp chính về Firebase để biết thêm câu hỏi thường gặp về Firebase hoặc sản phẩm cụ thể.
Bạn cũng có thể xem
kho lưu trữ GitHub của SDK Firebase cho Android
để biết danh sách mới nhất về các vấn đề được báo cáo và cách khắc phục sự cố. Bạn cũng nên gửi các vấn đề liên quan đến SDK của Firebase cho Android tại đó!
Tôi gặp lỗi cho biết thư viện ktx không phân giải được hoặc không tìm thấy.
Lỗi này có thể là do bạn đang sử dụng Firebase BoM và chỉ định một mô-đun KTX làm phần phụ thuộc thư viện sản phẩm.
Vào tháng 7 năm 2025, chúng tôi đã ngừng phát hành các phiên bản mới của mô-đun KTX và xoá các thư viện KTX khỏi Firebase Android BoM (phiên bản 34.0.0).
Nếu bạn sử dụng API KTX từ các mô-đun KTX đã phát hành trước đó, bạn nên di chuyển ứng dụng của mình để sử dụng API KTX từ các mô-đun chính. Để biết thông tin chi tiết, hãy xem phần
Câu hỏi thường gặp về sáng kiến này.
Làm cách nào để giải quyết lỗi này: "Một ứng dụng OAuth2 đã tồn tại cho tên gói này và SHA-1 trong một dự án khác"?
Lỗi này xảy ra nếu chúng tôi phát hiện thấy một dự án Firebase hoặc Google Cloud khác
chứa mã ứng dụng khách OAuth 2.0 có tên gói
và SHA-1 mà bạn đã chỉ định. Tìm hiểu cách
khắc phục lỗi này.
Khi thêm Firebase vào dự án Android, tôi gặp lỗi "Không tìm thấy".
Lỗi này thường có nghĩa là ứng dụng của bạn thiếu một hoặc nhiều tệp đối chiếu
với kho lưu trữ Maven của Google. Hãy nhớ thêm kho lưu trữ Maven của Google (google()) vào tệp Cấu hình Gradle.
- Nếu dự án của bạn đang sử dụng cú pháp
plugins, hãy đưa cú pháp đó vào phần plugins trong tệp settings.gradle.kts hoặc settings.gradle.
- Nếu dự án của bạn đang sử dụng cú pháp
buildscript, hãy thêm cú pháp này vào cả hai mục buildscript và allprojects trong tệp build.gradle.kts hoặc build.gradle cấp dự án.
Khi thêm Firebase SDK vào dự án Android, tôi gặp lỗi về việc hỗ trợ invoke-custom và bật tính năng đơn giản hoá cú pháp.
Vào tháng 5 năm 2021 (Firebase BoM phiên bản 28.0.0), Firebase đã tắt tính năng đơn giản hoá cú pháp cho tất cả thư viện Android của mình (xem ghi chú phát hành).
Thay đổi này có nghĩa là các bản dựng Gradle sử dụng trình bổ trợ Android cho Gradle (AGP) phiên bản 4.2 trở xuống cần bật tính năng hỗ trợ Java 8. Nếu không, khi thêm Firebase SDK,
các dự án Android này sẽ gặp lỗi bản dựng sau:
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.
Để khắc phục lỗi bản dựng này, bạn có thể làm theo một trong hai cách sau:
- Thêm
compileOptions được liệt kê trong thông báo lỗi vào tệp build.gradle.kts hoặc build.gradle cấp ứng dụng.
- Tăng
minSdkVersion cho dự án Android lên 26 trở lên.
Tính năng Đăng nhập bằng Google hiện lỗi "12500:" sau khi tôi phát hành ứng dụng. Làm cách nào để khắc phục lỗi này?
Có hai lý do có thể khiến điều này xảy ra: bạn chưa cung cấp email hỗ trợ hoặc bạn thiếu khoá SHA. Để khắc phục lỗi này, hãy đảm bảo rằng tất cả các điều kiện sau đều đúng:
Làm cách nào để thêm trình bổ trợ Firebase vào dự án Android bằng cú pháp buildscript?
Firebase có các trình bổ trợ Gradle sau:
| Tên trình bổ trợ |
Toạ độ Maven |
Phiên bản mới nhất |
Mã trình bổ trợ |
| Trình bổ trợ Dịch vụ Google Play |
com.google.gms:google-services |
4.5.0 |
com.google.gms.google-services |
| Trình bổ trợ App Distribution |
com.google.firebase:firebase-appdistribution-gradle |
5.3.1 |
com.google.firebase.appdistribution |
| Trình bổ trợ Crashlytics |
com.google.firebase:firebase-crashlytics-gradle |
3.0.8 |
com.google.firebase.crashlytics |
| Trình bổ trợ Performance Monitoring |
com.google.firebase:perf-plugin |
2.0.2 |
com.google.firebase.firebase-perf |
Sau đây là cách thêm trình bổ trợ Firebase vào một dự án Android vẫn sử dụng cú pháp buildscript:
Trong tệp Gradle ở cấp gốc (cấp dự án) (<project>/build.gradle.kts hoặc <project>/build.gradle), hãy thêm trình bổ trợ dưới dạng phần phụ thuộc bằng cách sử dụng toạ độ Maven của trình bổ trợ:
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
}
}
Trong tệp Gradle mô-đun (cấp ứng dụng) (thường là <project>/<app-module>/build.gradle.kts hoặc <project>/<app-module>/build.gradle), hãy thêm trình bổ trợ bằng mã nhận dạng trình bổ trợ:
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'
...
}
Tôi nên đưa những thông báo nào về nguồn mở vào ứng dụng của mình?
SDK của Firebase cho Android có chứa một trình trợ giúp Activity để hiển thị thông tin giấy phép.
