این صفحه نکات و عیب‌یابی‌هایی را برای مشکلات خاص اندروید که ممکن است هنگام استفاده از Firebase با آنها مواجه شوید، ارائه می‌دهد.
چالش‌های دیگری دارید یا مشکل خود را در زیر مشاهده نمی‌کنید؟ برای سوالات متداول بیشتر در مورد Firebase یا محصول خاص، حتماً به بخش اصلی سوالات متداول Firebase مراجعه کنید.
همچنین می‌توانید برای مشاهده‌ی لیست به‌روز مشکلات گزارش‌شده و عیب‌یابی، به مخزن گیت‌هاب Firebase Android SDK مراجعه کنید. پیشنهاد می‌کنیم مشکلات مربوط به Firebase Android SDK خود را نیز در آنجا ثبت کنید!
من با خطایی مواجه می‌شوم که می‌گوید کتابخانه ktx نتوانسته آن را حل کند یا پیدا نشده است.
این خطا احتمالاً به این دلیل است که شما از Firebase BoM استفاده می‌کنید و یک ماژول KTX را به عنوان وابستگی کتابخانه محصول خود مشخص می‌کنید.
در ژوئیه ۲۰۲۵، انتشار نسخه‌های جدید ماژول‌های KTX را متوقف کردیم و کتابخانه‌های KTX را از Firebase Android BoM (نسخه ۳۴.۰.۰) حذف کردیم.
اگر از APIهای KTX ماژول‌های KTX که قبلاً منتشر شده‌اند استفاده می‌کنید، توصیه می‌کنیم برنامه خود را به APIهای KTX ماژول‌های اصلی منتقل کنید . برای جزئیات بیشتر، به سوالات متداول در مورد این طرح مراجعه کنید.
چگونه می‌توانم این خطا را حل کنم: "یک کلاینت OAuth2 از قبل برای این نام بسته و SHA-1 در پروژه دیگری وجود دارد"؟
این خطا زمانی رخ می‌دهد که تشخیص دهیم پروژه دیگری از Firebase یا Google Cloud حاوی شناسه کلاینت OAuth 2.0 با نام بسته و SHA-1 مشخص شده توسط شما است. نحوه رفع این خطا را بیاموزید.
وقتی Firebase را به پروژه اندرویدم اضافه می‌کنم، خطای «پیدا نشد» (Could not find) دریافت می‌کنم.
این خطا معمولاً به این معنی است که برنامه شما یک یا چند ارجاع به مخزن Maven گوگل را از دست داده است. مطمئن شوید که مخزن Maven گوگل ( google() ) را در فایل پیکربندی Gradle خود وارد کرده‌اید.
- اگر پروژه شما از سینتکس
plugins استفاده می‌کند، آن را در بخش plugins در فایل settings.gradle.kts یا settings.gradle خود قرار دهید. - اگر پروژه شما از سینتکس
buildscript استفاده می‌کند، آن را هم در بخش‌های buildscript و هم در allprojects در فایل build.gradle.kts یا build.gradle در سطح پروژه خود قرار دهید.
وقتی یک SDK فایربیس به پروژه اندرویدم اضافه می‌کنم، در مورد پشتیبانی از invoke-custom و فعال کردن desugaring خطایی دریافت می‌کنم.
در ماه مه 2021 ( Firebase BoM نسخه 28.0.0)، فایربیس desugaring را برای همه کتابخانه‌های اندروید خود غیرفعال کرد (به یادداشت انتشار مراجعه کنید).
این تغییر به این معنی است که نسخه‌های Gradle که از افزونه Android Gradle (AGP) نسخه ۴.۲ یا قدیمی‌تر استفاده می‌کنند، باید پشتیبانی از Java 8 را فعال کنند. در غیر این صورت، هنگام اضافه کردن Firebase SDK، این پروژه‌های اندروید با خطای ساخت زیر مواجه می‌شوند:
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 برای پروژه اندروید خود به ۲۶ یا بالاتر افزایش دهید.
بعد از انتشار برنامه، خطای "12500:" در قسمت ورود به سیستم گوگل نمایش داده می‌شود. چگونه می‌توانم آن را برطرف کنم؟
دو دلیل ممکن برای این اتفاق وجود دارد: شما ایمیل پشتیبانی ارائه نکرده‌اید یا کلید SHA را گم کرده‌اید. برای رفع این خطا، مطمئن شوید که همه این شرایط برقرار است:
چگونه افزونه‌های Firebase را با استفاده از سینتکس buildscript به یک پروژه اندروید اضافه کنیم؟
فایربیس افزونه‌های Gradle زیر را دارد:
| نام افزونه | مختصات ماون | آخرین نسخه | شناسه افزونه |
|---|
| افزونه خدمات گوگل پلی | com.google.gms:google-services | ۴.۴.۴ | com.google.gms.google-services |
| افزونه App Distribution | com.google.firebase:firebase-appdistribution-gradle | ۵.۲.۰ | com.google.firebase.appdistribution |
| افزونه Crashlytics | com.google.firebase:firebase-crashlytics-gradle | ۳.۰.۶ | com.google.firebase.crashlytics |
| افزونه Performance Monitoring | com.google.firebase:perf-plugin | ۲.۰.۲ | com.google.firebase.firebase-perf |
در اینجا نحوه اضافه کردن یک افزونه Firebase به یک پروژه اندروید که هنوز از سینتکس buildscript استفاده می‌کند، آورده شده است:
در فایل Gradle سطح ریشه (سطح پروژه) خود ( <project>/build.gradle.kts یا <project>/build.gradle )، افزونه را به عنوان یک وابستگی با استفاده از مختصات 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'
...
}
