Trang này cung cấp các mẹo và cách khắc phục sự cố đối với các vấn đề 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 những thách thức 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ề toàn bộ Firebase hoặc
câu hỏi thường gặp dành riêng cho sản phẩm.
Bạn cũng có thể xem
kho lưu trữ GitHub của SDK Firebase cho Android
để biết danh sách cập nhật về các vấn đề đã 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 của riêng mình tại đó!
Tôi gặp lỗi rằng 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
(v34.0.0).
Nếu bạn sử dụng API KTX từ các mô-đun KTX đã phát hành trước đó, chúng tôi khuyên bạn nên di chuyển ứng dụng để sử dụng API KTX từ các mô-đun chính. Để biết thông tin chi tiết, hãy xem
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: "Đã có một ứng dụng OAuth2 cho
tên gói và SHA-1 này 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 OAuth 2.0 có tên gói
và SHA-1 mà bạn đã chỉ định. Tìm hiểu cách
giải quyết 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 tham chiếu
đến 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 thêm cú pháp đó
vào phần plugins trong tệp settings.gradle.kts hoặc settings.gradle của bạn.
- Nếu dự án của bạn đang sử dụng cú pháp
buildscript, hãy thêm cú pháp đó vào cả phần buildscript và allprojects
trong tệp build.gradle.kts hoặc
build.gradle ở cấp dự án.
Khi thêm SDK Firebase vào dự án Android, tôi gặp lỗi về tính năng hỗ trợ invoke-custom và bật tính năng xử lý cấu trúc đặc biệt.
Vào tháng 5 năm 2021 (Firebase BoM v28.0.0), Firebase đã tắt tính năng xử lý cấu trúc đặc biệt cho tất cả các
thư viện Android
(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) v4.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ê từ thông báo lỗi vào tệp ở cấp ứng dụng
build.gradle.kts hoặc build.gradle.
- 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 thị 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ó 2 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 thiếu khoá SHA. Để khắc phục lỗi này, hãy
đảm bảo tất cả các điều kiện sau đều đúng:
Cách 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ã nhận dạng trình bổ trợ |
| Trình bổ trợ Dịch vụ Google Play |
com.google.gms:google-services |
4.4.4 |
com.google.gms.google-services |
| Trình bổ trợ App Distribution |
com.google.firebase:firebase-appdistribution-gradle |
5.2.1 |
com.google.firebase.appdistribution |
| Trình bổ trợ Crashlytics |
com.google.firebase:firebase-crashlytics-gradle |
3.0.7 |
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 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ợ làm
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 ở cấp 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 cách sử dụng
mã nhận dạng trình bổ trợ của 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 thông báo nguồn mở nào vào ứng dụng của mình?
SDK của Firebase cho Android chứa một
trợ giúp Activity
để hiển thị thông tin về giấy phép.
