تحديد المشاكل وحلّها الأسئلة الشائعة حول 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 إلى تطبيق Firebase على Android في Firebase console (انتقِل إلى 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 لعرض معلومات الترخيص.