با مجموعه‌ها، منظم بمانید
ذخیره و طبقه‌بندی محتوا براساس اولویت‌های شما.
این صفحه نکات و عیب‌یابی مشکلات خاص Android را ارائه می‌دهد که ممکن است هنگام استفاده از Firebase با آن مواجه شوید.
چالش های دیگری دارید یا مشکل خود را در زیر نمی بینید؟ حتماً سؤالات متداول اصلی Firebase را برای سؤالات متداول pan-Firebase یا محصول خاص بررسی کنید.
همچنین می‌توانید مخزن Firebase Android SDK GitHub را برای لیستی به‌روز از مشکلات گزارش‌شده و عیب‌یابی بررسی کنید. ما شما را تشویق می کنیم که مسائل مربوط به Firebase Android SDK خود را نیز در آنجا ثبت کنید!
من یک خطا دریافت می کنم که کتابخانه ktx نتوانست آن را برطرف کند یا پیدا نشد.
این خطا احتمالاً به این دلیل است که شما از Firebase BoM استفاده می کنید و یک ماژول KTX را به عنوان وابستگی کتابخانه محصول خود مشخص می کنید.
در جولای 2025، انتشار نسخه‌های جدید ماژول‌های KTX را متوقف کردیم و کتابخانه‌های KTX را از Firebase Android BoM (v34.0.0) حذف کردیم.
اگر از ماژول‌های KTX از ماژول‌های KTX که قبلاً منتشر شده استفاده می‌کنید، توصیه می‌کنیم برنامه خود را برای استفاده از APIهای KTX از ماژول‌های اصلی منتقل کنید . برای جزئیات، به سؤالات متداول در مورد این ابتکار مراجعه کنید.
آیا هنگام افزودن یک برنامه Android به پروژه Firebase باید SHA-1 ارائه کنم؟
چگونه این خطا را برطرف کنم: "یک سرویس گیرنده OAuth2 از قبل برای این نام بسته و SHA-1 در پروژه دیگری وجود دارد"؟
اگر متوجه شویم که پروژه Firebase یا Google Cloud دیگری حاوی شناسه مشتری OAuth 2.0 با نام بسته و SHA-1 است که شما مشخص کرده‌اید، این خطا رخ می‌دهد. یاد بگیرید چگونه این خطا را برطرف کنید .
وقتی Firebase را به پروژه اندروید خود اضافه می‌کنم، با خطای "نمی‌توان یافت" مواجه می‌شوم.
این خطا معمولاً به این معنی است که برنامه شما یک یا چند مرجع به مخزن Maven Google ندارد. مطمئن شوید که مخزن Maven Google ( google() ) را در فایل پیکربندی Gradle خود قرار دهید.
اگر پروژه شما از نحو plugins استفاده می کند، آن را در قسمت plugins در فایل settings.gradle.kts یا settings.gradle خود قرار دهید.
اگر پروژه شما از نحو buildscript استفاده می کند، آن را در هر دو بخش buildscript و allprojects در build.gradle.kts یا فایل build.gradle سطح پروژه خود قرار دهید.
وقتی یک Firebase SDK را به پروژه اندروید خود اضافه می‌کنم، با خطایی در مورد پشتیبانی سفارشی فراخوانی و فعال کردن قندزدایی مواجه می‌شوم.
در می 2021 ( Firebase BoM v28.0.0)، Firebase شیرین کردن قند را برای همه کتابخانه‌های Android خود غیرفعال کرد (به یادداشت انتشار مراجعه کنید).
این تغییر به این معنی است که ساخت‌های Gradle که از افزونه Android Gradle (AGP) نسخه 4.2 یا نسخه‌های قبلی استفاده می‌کنند، باید پشتیبانی از جاوا 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 پروژه اندروید خود را به 26 یا بالاتر افزایش دهید.
پس از انتشار برنامه، ورود به سیستم Google خطای "12500:" را نشان می دهد. چطوری درستش کنم؟
دو دلیل احتمالی وجود دارد که چرا این اتفاق می افتد: ایمیل پشتیبانی ارائه نکرده اید یا کلید SHA را از دست داده اید. برای رفع این خطا، مطمئن شوید که همه این شرایط درست است:
در اینجا نحوه افزودن یک افزونه Firebase به یک پروژه اندرویدی که همچنان از دستور buildscript استفاده می کند، آمده است:
در فایل Gradle سطح ریشه (سطح پروژه) خود ( <project>/build.gradle.kts یا <project>/build.gradle )، افزونه را به عنوان یک وابستگی با استفاده از مختصات Maven آن اضافه کنید:
Kotlin
buildscript{repositories{// Make sure that you have the following two repositoriesgoogle()// Google's Maven repositorymavenCentral()// Maven Central repository}dependencies{...// Add the Maven coordinates and latest version of the pluginclasspath("PLUGIN_MAVEN_COORDINATES:PLUGIN_VERSION")}}allprojects{...repositories{// Make sure that you have the following two repositoriesgoogle()// Google's Maven repositorymavenCentral()// Maven Central repository}}
Groovy
buildscript{repositories{// Make sure that you have the following two repositoriesgoogle()// Google's Maven repositorymavenCentral()// Maven Central repository}dependencies{...// Add the Maven coordinates and latest version of the pluginclasspath'PLUGIN_MAVEN_COORDINATES:PLUGIN_VERSION'}}allprojects{...repositories{// Make sure that you have the following two repositoriesgoogle()// Google's Maven repositorymavenCentral()// 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 pluginid("FIREBASE_PLUGIN_ID")...}
Groovy
plugins{id'com.android.application'// Add the ID of the pluginid'FIREBASE_PLUGIN_ID'...}
تاریخ آخرین بهروزرسانی 2025-07-21 بهوقت ساعت هماهنگ جهانی.
[[["درک آسان","easyToUnderstand","thumb-up"],["مشکلم را برطرف کرد","solvedMyProblem","thumb-up"],["غیره","otherUp","thumb-up"]],[["اطلاعاتی که نیاز دارم وجود ندارد","missingTheInformationINeed","thumb-down"],["بیشازحد پیچیده/ مراحل بسیار زیاد","tooComplicatedTooManySteps","thumb-down"],["قدیمی","outOfDate","thumb-down"],["مشکل ترجمه","translationIssue","thumb-down"],["مشکل کد / نمونهها","samplesCodeIssue","thumb-down"],["غیره","otherDown","thumb-down"]],["تاریخ آخرین بهروزرسانی 2025-07-21 بهوقت ساعت هماهنگ جهانی."],[],[],null,["\u003cbr /\u003e\n\nThis page offers tips and troubleshooting for Android-specific issues\nthat you might encounter when using Firebase.\n\nHave other challenges or don't see your issue outlined below? Make sure to check\nout the [main Firebase FAQ](/support/faq) for more pan-Firebase or\nproduct-specific FAQ.\n\nYou can also check out the\n[Firebase Android SDK GitHub repo](https://github.com/firebase/firebase-android-sdk/issues)\nfor an up-to-date list of reported issues and troubleshooting. We encourage you\nto file your own Firebase Android SDK related issues there, too! \n\nI'm getting an error that the `ktx` library failed to resolve or\ncould not be found.\n\nThis error is likely because you're using the Firebase BoM and\nspecifying a KTX module as your product library dependency.\n\n**In July 2025, we stopped releasing new versions of the KTX modules,\nand we removed the KTX libraries from the Firebase Android BoM\n(v34.0.0).**\n\nIf you use KTX APIs from previously released KTX modules, we recommend\nthat you ***migrate your app to use KTX APIs from the main modules\ninstead*** . For details, see the\n[FAQ about this initiative](/docs/android/kotlin-migration). \n\nDo I need to provide a SHA-1 when adding an Android app to a Firebase\nproject?\n\n[SHA-1 information](//developers.google.com/android/guides/client-auth)\nis required by Firebase Authentication (when using\n[Google signin](/docs/auth/android/google-signin) or\n[phone number signin](/docs/auth/android/phone-auth)) and\n[Firebase Dynamic Links](/docs/dynamic-links). If you're not using\nthese features, you don't have to provide a SHA-1. \n\nHow do I resolve this error: \"An OAuth2 client already exists for this\npackage name and SHA-1 in another project\"?\n\nThis error occurs if we detect that another Firebase or Google Cloud\nproject contains an OAuth 2.0 client ID with the package name\nand SHA-1 that you specified. Learn how to\n[resolve this error](//support.google.com/firebase/answer/6401008). \n\nWhen I add Firebase to my Android project, I get a \"Could not find\" error.\n\nThis error usually means that your app is missing one or more references\nto Google's Maven repository. Make sure to include Google's Maven repository\n(`google()`) in your Gradle Configuration file.\n\n- If your project is using the `plugins` syntax, include it in the `plugins` section in your `settings.gradle.kts` or `settings.gradle` file.\n- If your project is using the `buildscript` syntax, include it in both the `buildscript` and `allprojects` sections in your project-level `build.gradle.kts` or `build.gradle` file.\n\n\u003cbr /\u003e\n\n\u003cbr /\u003e\n\nWhen I add a Firebase SDK to my Android project, I get an error about\ninvoke-custom support and enabling desugaring.\n\n\u003cbr /\u003e\n\nIn May 2021 (Firebase BoM v28.0.0), Firebase disabled desugaring for all its\nAndroid libraries\n(see [release note](/support/release-notes/android#2021-05-11)).\n\nThis change means that Gradle builds that use Android Gradle plugin (AGP) v4.2\nor earlier need to enable Java 8 support. Otherwise, when adding a Firebase SDK,\nthese Android projects get the following build failure: \n\n```\nD8: Invoke-customs are only supported starting with Android O (--min-api 26)\nCaused by: com.android.builder.dexing.DexArchiveBuilderException: Error while dexing.\nThe dependency contains Java 8 bytecode. Please enable desugaring by adding the following to build.gradle\nandroid {\n compileOptions {\n sourceCompatibility 1.8\n targetCompatibility 1.8\n }\n}\nSee https://developer.android.com/studio/write/java8-support.html for details.\nAlternatively, increase the minSdkVersion to 26 or above.\n```\n\nTo fix this build failure, you can follow one of two options:\n\n- Add the listed `compileOptions` from the error message to your **app-level** `build.gradle.kts` or `build.gradle` file.\n- Increase the `minSdkVersion` for your Android project to 26 or above.\n\n\u003cbr /\u003e\n\n\u003cbr /\u003e\n\nGoogle Sign-in is showing the error \"12500:\" after I released my app. How\ndo I fix it?\n\n\nThere are two possible reasons why this would happen: you haven't provided a\nsupport email or you're missing a SHA key. In order to fix this error, make\nsure **all** of these conditions are true:\n\n- You've added a support email to the [General Settings of your project](https://console.firebase.google.com/project/_/settings/general/) in the Firebase console.\n- You've added the [SHA-1 Certificate fingerprint from your release/production keystore](https://developers.google.com/android/guides/client-auth#using_keytool_on_the_certificate) to your Firebase Android App in the Firebase console (go to settings [**Project settings**](//console.firebase.google.com/project/_/settings/general/), scroll down to *Your apps*, and then select your Android App).\n- You've added the [SHA-1 Certificate fingerprint from the Google Play Console](https://developer.android.com/studio/publish/app-signing#api-providers) to your Firebase Android App in the Firebase console (go to settings [**Project settings**](//console.firebase.google.com/project/_/settings/general/), scroll down to *Your apps*, and then select your Android App).\n\n\u003cbr /\u003e\n\n\u003cbr /\u003e\n\n\u003cbr /\u003e\n\nHow to add Firebase plugins to an Android project using the `buildscript`\nsyntax?\n\n\u003cbr /\u003e\n\n| **Tip:** Consider [migrating from `buildscript` to `plugin` syntax](https://developer.android.com/build/migrate-to-kotlin-dsl#migrate-buildscript) as this allows Android Studio to perform code completion and provide other helpful suggestions.\n\nFirebase has the following Gradle plugins:\n\n| Plugin name | Maven coordinates | Latest version | Plugin ID |\n|-------------------------------|-------------------------------------------------------|----------------|---------------------------------------|\n| Google Play services plugin | `com.google.gms:google-services` | 4.4.3 | `com.google.gms.google-services` |\n| App Distribution plugin | `com.google.firebase:firebase-appdistribution-gradle` | 5.1.1 | `com.google.firebase.appdistribution` |\n| Crashlytics plugin | `com.google.firebase:firebase-crashlytics-gradle` | 3.0.6 | `com.google.firebase.crashlytics` |\n| Performance Monitoring plugin | `com.google.firebase:perf-plugin` | 2.0.1 | `com.google.firebase.firebase-perf` |\n\n\u003cbr /\u003e\n\nHere's how to add a Firebase plugin to an Android project that still uses the\n`buildscript` syntax:\n\n1. In your **root-level (project-level)** Gradle file\n (`\u003cproject\u003e/build.gradle.kts` or `\u003cproject\u003e/build.gradle`), add the plugin as\n a dependency using its Maven coordinates:\n\n Kotlin \n\n buildscript {\n\n repositories {\n // Make sure that you have the following two repositories\n google() // Google's Maven repository\n mavenCentral() // Maven Central repository\n }\n\n dependencies {\n ...\n\n // Add the Maven coordinates and latest version of the plugin\n classpath (\"\u003cvar translate=\"no\"\u003ePLUGIN_MAVEN_COORDINATES\u003c/var\u003e:\u003cvar translate=\"no\"\u003ePLUGIN_VERSION\u003c/var\u003e\")\n }\n }\n\n allprojects {\n ...\n\n repositories {\n // Make sure that you have the following two repositories\n google() // Google's Maven repository\n mavenCentral() // Maven Central repository\n }\n }\n\n Groovy \n\n buildscript {\n\n repositories {\n // Make sure that you have the following two repositories\n google() // Google's Maven repository\n mavenCentral() // Maven Central repository\n }\n\n dependencies {\n ...\n\n // Add the Maven coordinates and latest version of the plugin\n classpath '\u003cvar translate=\"no\"\u003ePLUGIN_MAVEN_COORDINATES\u003c/var\u003e:\u003cvar translate=\"no\"\u003ePLUGIN_VERSION\u003c/var\u003e'\n }\n }\n\n allprojects {\n ...\n\n repositories {\n // Make sure that you have the following two repositories\n google() // Google's Maven repository\n mavenCentral() // Maven Central repository\n }\n }\n\n2. In your **module (app-level)** Gradle file (usually\n `\u003cproject\u003e/\u003capp-module\u003e/build.gradle.kts` or\n `\u003cproject\u003e/\u003capp-module\u003e/build.gradle`), add the plugin using its\n plugin ID:\n\n Kotlin \n\n plugins {\n id(\"com.android.application\")\n\n // Add the ID of the plugin\n id(\"\u003cvar translate=\"no\"\u003eFIREBASE_PLUGIN_ID\u003c/var\u003e\")\n ...\n }\n\n Groovy \n\n plugins {\n id 'com.android.application'\n\n // Add the ID of the plugin\n id '\u003cvar translate=\"no\"\u003eFIREBASE_PLUGIN_ID\u003c/var\u003e'\n ...\n }\n\n\u003cbr /\u003e\n\n\u003cbr /\u003e"]]
