تقدّم هذه الصفحة نصائح ومعلومات تحديد المشاكل الخاصة بنظام التشغيل Android وحلّها. التي قد تواجهها عند استخدام Firebase.
هل لديك تحديات أخرى أو لم تظهر مشكلتك الموضّحة أدناه؟ احرص على التحقق من الأسئلة الشائعة حول Firebase للحصول على المزيد من خدمات Firebase الأسئلة الشائعة الخاصة بالمنتج.
يمكنك أيضًا الاطّلاع على مستودع GitHub لحزمة تطوير البرامج (SDK) لنظام التشغيل Android لمنصة Firebase للحصول على قائمة مُحدّثة بالمشكلات التي تم الإبلاغ عنها واستكشاف الأخطاء وإصلاحها. ننصحك للإبلاغ عن المشاكل المتعلّقة بحزمة تطوير البرامج (SDK) لنظام التشغيل Android بمنصة Firebase أيضًا.
هل أحتاج إلى تقديم خوارزمية SHA-1 عند إضافة تطبيق Android إلى Firebase؟ مشروعك؟
معلومات SHA-1 مطلوبة بواسطة مصادقة Firebase (عند استخدام تسجيل الدخول إلى Google أو تسجيل رقم الهاتف) و روابط Firebase الديناميكية: إذا كنت لا تستخدم هذه الميزات، لن تحتاج إلى توفير خوارزمية 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
.
عندما أضيف حزمة تطوير برامج Firebase إلى مشروع Android، تظهر لي رسالة خطأ استدعاء الدعم المخصص وتفعيل إزالة السمات.
في أيار (مايو) 2021 (الإصدار 28.0.0 من Firebase BoM)، أوقف Firebase إمكانية إزالة المحتوى عن غيره مكتبات Android (اطّلِع على ملاحظة الإصدار).
يعني هذا التغيير أنّ إصدارات Gradle هي التي تستخدم الإصدار 4.2 من المكوّن الإضافي لنظام Gradle المتوافق مع Android (AGP) إلى تفعيل دعم Java 8 أو الإصدارات الأقدم. وبخلاف ذلك، عند إضافة حزمة تطوير البرامج (SDK) لمنصة 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.
- لقد أضفت
الملف المرجعي لشهادة SHA-1 من ملف تخزين مفاتيح الإصدار/الإنتاج
إلى تطبيق Android بمنصة Firebase في وحدة تحكُّم Firebase (انتقِل إلى
إعدادات المشروع ، مرِّر لأسفل إلى تطبيقاتك، ثم اختَر تطبيق Android). - لقد أضفت
الملف المرجعي لشهادة SHA-1 من Google Play Console
إلى تطبيق Android بمنصة Firebase في وحدة تحكُّم Firebase (انتقِل إلى
إعدادات المشروع ، مرِّر لأسفل إلى تطبيقاتك، ثم اختَر تطبيق Android).
كيفية إضافة مكونات Firebase الإضافية إلى مشروع Android باستخدام buildscript
بناء الجملة؟
يتضمّن Firebase مكوّنات Gradle الإضافية التالية:
اسم المكوِّن الإضافي | إحداثيات Maven | أحدث إصدار | الرقم التعريفي للمكوّن الإضافي |
---|---|---|---|
المكوّن الإضافي "خدمات Google Play" | com.google.gms:google-services |
4.4.2 | com.google.gms.google-services |
المكوّن الإضافي لتوزيع التطبيقات | com.google.firebase:firebase-appdistribution-gradle |
5.0.0 | com.google.firebase.appdistribution |
المكوّن الإضافي Crashlytics | com.google.firebase:firebase-crashlytics-gradle |
3.0.2 | com.google.firebase.crashlytics |
المكوّن الإضافي "تتبُّع الأداء" | com.google.firebase:perf-plugin |
1.4.2 | com.google.firebase.firebase-perf |
نوضّح في ما يلي كيفية إضافة مكوّن Firebase الإضافي إلى مشروع Android لا يزال يستخدم
بنية buildscript
:
في ملف Gradle على مستوى الجذر (على مستوى المشروع) (
<project>/build.gradle.kts
أو<project>/build.gradle
)، أضف المكون الإضافي باسم التبعية باستخدام إحداثيات Maven التالية: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
}
}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
}
}في ملف Gradle للوحدة (على مستوى التطبيق) (عادةً
<project>/<app-module>/build.gradle.kts
أو<project>/<app-module>/build.gradle
)، أضف المكون الإضافي باستخدام معرّف المكون الإضافي:plugins {
id("com.android.application")
// Add the ID of the plugin
id("FIREBASE_PLUGIN_ID ")
...
}plugins {
id 'com.android.application'
// Add the ID of the plugin
id 'FIREBASE_PLUGIN_ID '
...
}