تحديد المشاكل وحلّها الأسئلة الشائعة حول 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 Console إلى تطبيق 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'
       ...
   }