تحديد المشاكل وحلّها الأسئلة الشائعة حول Android وFirebase
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
تقدّم هذه الصفحة نصائح وخطوات تحديد المشاكل وحلّها المتعلّقة بنظام التشغيل Android
التي قد تواجهها عند استخدام Firebase.
هل لديك مشاكل أخرى أو لا تظهر مشكلتك الموضّحة أدناه؟ يُرجى الاطّلاع على الأسئلة الشائعة الرئيسية حول Firebase للحصول على المزيد من الأسئلة الشائعة حول Firebase بشكل عام أو
حول منتج معيّن.
يمكنك أيضًا الاطّلاع على
مستودع GitHub لحزمة تطوير البرامج (SDK) لمنصّة Firebase على Android
للحصول على قائمة محدّثة بالمشاكل التي تم الإبلاغ عنها وتحديد المشاكل وحلّها. ننصحك
بإرسال مشاكلك المتعلّقة بحزمة تطوير البرامج (SDK) لنظام التشغيل Android من Firebase إلى هذا الرابط أيضًا.
هل عليّ تقديم دالة SHA-1 عند إضافة تطبيق Android إلى أحد مشاريع Firebase؟
كيف يمكنني حلّ هذا الخطأ: "يوجد عميل 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 على مستوى المشروع.
عند إضافة حزمة تطوير برامج (SDK) لمنصة Firebase إلى مشروع Android، أتلقّى خطأ بشأن
توفّر invoke-custom وتفعيل إزالة المعالجة السكرية.
في أيار (مايو) 2021 (Firebase BoM الإصدار 28.0.0)، أوقف Firebase ميزة إزالة رمز Sugar لجميع مكتبات Android
(راجِع ملاحظة الإصدار).
يعني هذا التغيير أنّ عمليات إنشاء Gradle التي تستخدم الإصدار 4.2
من المكوّن الإضافي لنظام Gradle المتوافق مع Android (AGP) أو إصدارًا أقدم يجب أن تفعّل ميزة توافق Java 8. بخلاف ذلك، عند إضافة حزمة تطوير برامج Firebase،
تواجه مشاريع 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 لمشروع Android إلى 26 أو إصدار أحدث.
يعرض رمز تسجيل الدخول بحساب Google الخطأ "12500:" بعد طرح تطبيقي. كيف
يمكنني حلّ هذه المشكلة؟
هناك سببان محتملان لحدوث ذلك: عدم تقديم عنوان بريد إلكتروني
للتواصل مع فريق الدعم أو عدم توفُّر مفتاح SHA. لإصلاح هذا الخطأ، يُرجى
التأكّد من جميع الشروط التالية:
في ما يلي كيفية إضافة مكوّن إضافي في Firebase إلى مشروع Android لا يزال يستخدم بنية
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-03-07 (حسب التوقيت العالمي المتفَّق عليه)
[[["يسهُل فهم المحتوى.","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-03-07 (حسب التوقيت العالمي المتفَّق عليه)"],[],[]]