หน้านี้มีเคล็ดลับและวิธีแก้ปัญหาสำหรับปัญหาที่เฉพาะเจาะจงกับ Android ซึ่งคุณอาจพบเมื่อใช้ Firebase
หากพบปัญหาอื่นๆ หรือไม่เห็นปัญหาของคุณที่ระบุไว้ด้านล่าง โปรดดู
ที่ คำถามที่พบบ่อยหลักของ Firebase เพื่อดูคำถามที่พบบ่อยเกี่ยวกับ Firebase หรือ
ผลิตภัณฑ์โดยรวม
นอกจากนี้ คุณยังดูรายการปัญหาที่รายงานและวิธีแก้ปัญหาล่าสุดได้ใน
ที่เก็บ Firebase Android SDK GitHub
เราขอแนะนำให้คุณรายงานปัญหาที่เกี่ยวข้องกับ Firebase Android SDK ของคุณเองที่นั่นด้วย
ฉันได้รับข้อผิดพลาดว่าไลบรารี ktx แก้ไขไม่ได้หรือ
ไม่พบ
ข้อผิดพลาดนี้อาจเกิดขึ้นเนื่องจากคุณใช้ Firebase BoM และ
ระบุโมดูล KTX เป็นทรัพยากร Dependency ของไลบรารีผลิตภัณฑ์
ในเดือนกรกฎาคม 2025 เราได้หยุดเผยแพร่ KTX โมดูลเวอร์ชันใหม่
และนำ KTX ไลบรารีออกจาก Firebase Android BoM
(v34.0.0)
หากคุณใช้ KTX API จาก KTX โมดูลที่เผยแพร่ก่อนหน้านี้ เราขอแนะนำ
ให้คุณ ย้ายข้อมูลแอปไปใช้ KTX API จากโมดูลหลัก
แทน ดูรายละเอียดได้ใน
คำถามที่พบบ่อยเกี่ยวกับความคิดริเริ่มนี้.
ฉันจะแก้ไขข้อผิดพลาดนี้ได้อย่างไร: "มีไคลเอนต์ OAuth2 สำหรับชื่อแพ็กเกจและ SHA-1 นี้อยู่ในโปรเจ็กต์อื่นอยู่แล้ว"
ข้อผิดพลาดนี้เกิดขึ้นหากเราระบุว่าโปรเจ็กต์ Firebase หรือ Google Cloud
อื่นมีรหัสไคลเอนต์ OAuth 2.0 ที่มีชื่อแพ็กเกจ
และ SHA-1 ที่คุณระบุ ดูวิธีแก้ไขข้อผิดพลาดนี้
เมื่อเพิ่ม Firebase ลงในโปรเจ็กต์ Android ฉันได้รับข้อผิดพลาด "ไม่พบ"
ข้อผิดพลาดนี้มักจะหมายความว่าแอปของคุณไม่มีการอ้างอิงที่เก็บ Maven ของ Google อย่างน้อย 1 รายการ
โปรดตรวจสอบว่าได้รวมที่เก็บ Maven ของ Google
(google()) ไว้ในไฟล์การกำหนดค่า Gradle แล้ว
- หากโปรเจ็กต์ใช้ไวยากรณ์
plugins ให้รวมไว้ในส่วน plugins ในไฟล์ settings.gradle.kts หรือ settings.gradle
- หากโปรเจ็กต์ใช้ไวยากรณ์
buildscript ให้รวม
ไว้ในส่วน buildscript และ allprojects
ในไฟล์ build.gradle.kts หรือ
build.gradle ระดับโปรเจ็กต์
เมื่อเพิ่ม Firebase SDK ลงในโปรเจ็กต์ Android ฉันได้รับข้อผิดพลาดเกี่ยวกับ
การรองรับ invoke-custom และการเปิดใช้ desugaring
ในเดือนพฤษภาคม 2021 (Firebase BoM v28.0.0) Firebase ได้ปิดใช้ desugaring สำหรับไลบรารี Android ทั้งหมด
(ดูหมายเหตุประจำรุ่น)
การเปลี่ยนแปลงนี้หมายความว่าบิลด์ Gradle ที่ใช้ปลั๊กอิน Android Gradle (AGP) v4.2 หรือเวอร์ชันก่อนหน้าต้องเปิดใช้การรองรับ Java 8 มิเช่นนั้น เมื่อเพิ่ม Firebase SDK โปรเจ็กต์ 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:" หลังจากที่ฉันเผยแพร่แอป ฉันจะแก้ไขได้อย่างไร
ข้อผิดพลาดนี้อาจเกิดขึ้นได้ 2 สาเหตุ ได้แก่ คุณไม่ได้ระบุอีเมลติดต่อขอรับความช่วยเหลือ
หรือคุณไม่มีคีย์ 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.7 |
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) ให้เพิ่มปลั๊กอินเป็น
ทรัพยากร Dependency โดยใช้พิกัด 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
สำหรับการแสดงข้อมูลใบอนุญาต