عیب‌یابی و پرسشگان برای Android و Firebase

خطایی دریافت می‌کنم مبنی بر اینکه کتابخانه ktx تجزیه نشد یا پیدا نشد.

این خطا احتمالاً به‌دلیل استفاده از Firebase BoM و مشخص کردن یک ماژول KTX به‌عنوان وابستگی کتابخانه محصول شما است.

در ژوئیه ۲۰۲۵، انتشار نسخه‌های جدید ماژول‌های KTX را متوقف کردیم و کتابخانه‌های KTX را از Firebase Android BoM (نسخه ۳۴.۰.۰) برداشتیم.

اگر از میاناهای برنامه‌سازی کاربردی KTX از واحدهای KTX که قبلاً منتشر شده‌اند استفاده می‌کنید، توصیه می‌کنیم برنامه‌تان را منتقل کنید تا به‌جای آن از میاناهای برنامه‌سازی کاربردی KTX از واحدهای اصلی استفاده کند. برای جزئیات، پرسشگان درباره این طرح را ببینید.

آیا هنگام افزودن برنامه Android به پروژه Firebase باید SHA-1 ارائه دهم؟

اطلاعات SHA-1 توسط Firebase Authentication (هنگام استفاده از ورود به سیستم Google یا ورود به سیستم با شماره تلفن) و Firebase Dynamic Links الزامی است. اگر از این ویژگی‌ها استفاده نمی‌کنید، لازم نیست SHA-1 ارائه دهید.

چگونه این خطا را برطرف کنم: «یک سرویس‌گیرنده OAuth2 ازقبل برای این نام بسته و SHA-1 در پروژه دیگری وجود دارد»؟

این خطا زمانی رخ می‌دهد که تشخیص دهیم پروژه Firebase یا Google Cloud دیگری حاوی شناسه کارخواه OAuth 2.0 با نام بسته و SHA-1 است که شما مشخص کرده‌اید. با نحوه برطرف کردن این خطا آشنا شوید.

وقتی Firebase را به پروژه Android خود اضافه می‌کنم، خطای «یافت نشد» دریافت می‌کنم.

این خطا معمولاً به این معنی است که برنامه شما فاقد یک یا چند مرجع به مخزن Maven متعلق به Google است. مطمئن شوید که مخزن Maven‏ (google()) Google را در فایل پیکربندی Gradle خود اضافه کرده‌اید.

• اگر پروژه‌تان از نحو plugins استفاده می‌کند، آن را در بخش plugins در فایل settings.gradle.kts یا settings.gradle خود اضافه کنید.
• اگر پروژه‌تان از نحو buildscript استفاده می‌کند، آن را در هر دو بخش buildscript و allprojects در فایل build.gradle.kts یا build.gradle در سطح پروژه اضافه کنید.

«ورود به سیستم با Google» پس‌از انتشار برنامه‌ام خطای «12500:» را نشان می‌دهد. چگونه آن را برطرف کنم؟

دو دلیل احتمالی برای این اتفاق وجود دارد: ایمیل پشتیبانی ارائه نکرده‌اید یا کلید SHA ندارید. برای رفع این خطا، مطمئن شوید همه این شرایط برقرار باشد:

• ایمیل پشتیبانی را به تنظیمات کلی پروژه در کنسول Firebase اضافه کرده‌اید.
• اثر انگشت گواهینامه SHA-1 را از keystore نسخه پخش/تولید به «برنامه Android» در Firebase در کنسول Firebase اضافه کرده‌اید (به settings تنظیمات پروژه بروید، به پایین پیمایش کنید تا به برنامه‌های شما برسید، و سپس «برنامه Android» خود را انتخاب کنید).
• اثر انگشت گواهینامه SHA-1 را از کنسول Google Play به برنامه Android Firebase خود در کنسول Firebase اضافه کرده‌اید (به settings تنظیمات پروژه بروید، به پایین پیمایش کنید تا به برنامه‌های شما برسید، و سپس برنامه Android خود را انتخاب کنید).

چگونه افزایه‌های Firebase را بااستفاده از نحو buildscript به پروژه Android اضافه کنم؟

Firebase افزایه‌های Gradle زیر را دارد:

در اینجا نحوه افزودن افزونه Firebase به پروژه Android که هنوز از نحو buildscript استفاده می‌کند آورده شده است:

1. در فایل 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
     }
   }
   

2. در فایل 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 حاوی یک کمک‌کننده Activity برای نمایش اطلاعات پروانه است.