تحديد المشاكل وحلّها الأسئلة الشائعة حول Android وFirebase

تظهر لي رسالة خطأ تفيد بأنّه تعذّر حلّ مكتبة ktx أو تعذّر العثور عليها.

يحدث هذا الخطأ على الأرجح لأنّك تستخدم Firebase BoM وتحدّد وحدة KTX كاعتمادية لمكتبة المنتج.

في يوليو 2025، توقفنا عن إصدار نُسخ جديدة من وحدات KTX، وأزلنا مكتبات KTX من Firebase Android BoM (الإصدار 34.0.0).

إذا كنت تستخدم واجهات برمجة تطبيقات KTX من وحدات KTX التي تم إصدارها سابقًا، ننصحك بنقل تطبيقك لاستخدام واجهات برمجة تطبيقات KTX من الوحدات الرئيسية بدلاً من ذلك. لمعرفة التفاصيل، يُرجى الاطّلاع على الأسئلة الشائعة حول هذه المبادرة.

هل أحتاج إلى تقديم SHA-1 عند إضافة تطبيق Android إلى مشروع Firebase؟

معلومات 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 على مستوى المشروع.

تظهر رسالة الخطأ "12500:" في ميزة "تسجيل الدخول باستخدام حساب Google" بعد إصدار تطبيقي. كيف يمكنني حلّ هذه المشكلة؟

هناك سببان محتملان لحدوث ذلك: لم تقدّم عنوان بريد إلكتروني مخصّصًا للدعم أو لم يتوفّر لديك مفتاح SHA. لإصلاح هذا الخطأ، تأكَّد من استيفاء جميع الشروط التالية:

• لقد أضفت عنوان بريد إلكتروني مخصّصًا للدعم إلى الإعدادات العامة لمشروعك في وحدة تحكّم "Firebase".
• لقد أضفت الملف المرجعي لشهادة SHA-1 من مخزن مفاتيح الإصدار/الإنتاج إلى تطبيق Android على Firebase في وحدة تحكّم Firebase (انتقِل إلى settings إعدادات المشروع، ثم انتقِل للأسفل إلى تطبيقاتك، ثم اختَر تطبيق Android).
• أضفت الملف المرجعي لشهادة SHA-1 من وحدة تحكّم Google Play إلى تطبيق Android على Firebase في وحدة تحكّم Firebase (انتقِل إلى settings إعدادات المشروع، وانتقِل للأسفل إلى تطبيقاتك، ثم اختَر تطبيق Android).

كيف يمكن إضافة مكوّنات Firebase الإضافية إلى مشروع Android باستخدام بنية buildscript؟

يحتوي 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 SDK مساعدًا Activity لعرض معلومات الترخيص.