إضافة Firebase إلى مشروع Android

المتطلبات الأساسية

  • تثبيت استوديو Android أو تحديثه إلى أحدث إصدار منه.

  • تأكد من أن مشروعك يلبي هذه المتطلبات (لاحظ أن بعض المنتجات متطلبات أكثر صرامة):

    • استهداف المستوى 19 من واجهة برمجة التطبيقات (KitKat) أو أعلى
    • تستخدِم الإصدار 4.4 من نظام التشغيل Android أو إصدارًا أحدث.
    • الاستخدامات Jetpack (AndroidX)، الذي يتضمن استيفاء متطلبات الإصدار التالية:
      • com.android.tools.build:gradle، الإصدار 7.3.0 أو إصدار أحدث
      • compileSdkVersion 28 أو أحدث

  • إعداد جهاز فعلي أو استخدام المحاكي تشغيل تطبيقك.
    تجدر الإشارة إلى أنّ حِزم تطوير البرامج (SDK) لمنصة Firebase التي تعتمد على Google Play الخدمات تتطلب الجهاز أو أن يتم تثبيت خدمات Google Play على جهازك.

  • سجّل الدخول إلى Firebase باستخدام حسابك الحساب.

إذا لم يكن لديك مشروع على Android وكنت تريد فقط تجربة Firebase يمكنك تنزيل أحد نماذج البدء السريع لدينا.


يمكنك ربط تطبيق Android بمنصّة Firebase باستخدام أحد الخيارات التالية: الخيارات:

  • الخيار 1: (ننصح به) استخدِم سير عمل إعداد "وحدة تحكُّم Firebase".
  • الخيار 2: استخدام "استوديو Android" على Firebase "مساعد Google" (قد يتطلّب ذلك ضبط إعدادات إضافية)


الخيار 1: إضافة Firebase باستخدام وحدة تحكُّم Firebase

تتضمن إضافة Firebase إلى تطبيقك مهامًا في وحدة تحكم Firebase في مشروع Android المفتوح (على سبيل المثال، يمكنك تنزيل ملفات إعداد Firebase) من وحدة التحكّم، ثم انقلها إلى مشروع Android).

الخطوة 1: إنشاء مشروع على Firebase

يجب إنشاء منصّة Firebase لتتمكّن من إضافة منصة Firebase إلى تطبيقك على Android. مشروعك لربطه بتطبيق Android. زيارة الموقع يمكنك فهم مشاريع Firebase للحصول على مزيد من المعلومات حول. مشاريع Firebase:

الخطوة 2: تسجيل تطبيقك في Firebase

لاستخدام Firebase في تطبيق Android، يجب تسجيل تطبيقك في مشروع على Firebase. وعادةً ما يُطلق على تسجيل تطبيقك اسم "الإضافة". تطبيقك إلى مشروعك.

  1. انتقِل إلى وحدة تحكُّم Firebase.

  2. في منتصف صفحة النظرة العامة على المشروع، انقر على رمز Android. () أو إضافة تطبيق لبدء عملية الإعداد

  3. أدخل اسم حزمة التطبيق في حقل اسم حزمة Android.

  4. (اختياري) أدخِل معلومات أخرى عن التطبيق: اسم التطبيق وشهادة توقيع تصحيح الأخطاء SHA-1

  5. انقر على تسجيل التطبيق.

الخطوة 3: إضافة ملف إعداد Firebase

  1. تنزيل ملف إعداد Firebase لنظام التشغيل Android ثم إضافته (google-services.json) إلى تطبيقك:

    1. انقر على تنزيل google-services.json للحصول على نظام التشغيل Firebase Android. config.

    2. انقِل ملف الإعداد إلى الدليل الجذري للوحدة (على مستوى التطبيق) تطبيقك.

  2. لإتاحة الوصول إلى القيم في ملف إعداد google-services.json بحزم تطوير البرامج (SDK) لمنصّة Firebase، ستحتاج إلى مكوّن Gradle لخدمات Google (google-services).

    1. في ملف Gradle على مستوى الجذر (على مستوى المشروع) (<project>/build.gradle.kts أو <project>/build.gradle)، أضِف السمة المكون الإضافي لخدمات Google كملحق:

      Kotlin 

      plugins {
  id("com.android.application") version "7.3.0" apply false
  // ...

  // Add the dependency for the Google services Gradle plugin
  id("com.google.gms.google-services") version "4.4.2" apply false
}

      Groovy 

      plugins {
  id 'com.android.application' version '7.3.0' apply false
  // ...

  // Add the dependency for the Google services Gradle plugin
  id 'com.google.gms.google-services' version '4.4.2' apply false
}

    2. في ملف Gradle للوحدة (على مستوى التطبيق) (عادةً <project>/<app-module>/build.gradle.kts أو <project>/<app-module>/build.gradle)، لإضافة المكون الإضافي لخدمات Google:

      Kotlin 

      plugins {
  id("com.android.application")

  // Add the Google services Gradle plugin
  id("com.google.gms.google-services")
  // ...
}

      Groovy 

      plugins {
  id 'com.android.application'

  // Add the Google services Gradle plugin
  id 'com.google.gms.google-services'
  // ...
}

الخطوة 4: إضافة حِزم تطوير البرامج (SDK) لمنصّة Firebase إلى تطبيقك

  1. في ملف Gradle للوحدة (على مستوى التطبيق) (عادةً <project>/<app-module>/build.gradle.kts أو <project>/<app-module>/build.gradle)، وأضف التبعيات منتجات Firebase تريد استخدامها في تطبيقك. ننصح باستخدام منصة Android BoM في Firebase للتحكّم فيها لإصدارات المكتبة.

    تفعيل الإحصاءات 

    dependencies {
  // ...

  // Import the Firebase BoM
  implementation(platform("com.google.firebase:firebase-bom:33.1.2"))

  // When using the BoM, you don't specify versions in Firebase library dependencies

  // Add the dependency for the Firebase SDK for Google Analytics
  implementation("com.google.firebase:firebase-analytics")

  // TODO: Add the dependencies for any other Firebase products you want to use
  // See https://firebase.google.com/docs/android/setup#available-libraries
  // For example, add the dependencies for Firebase Authentication and Cloud Firestore
  implementation("com.google.firebase:firebase-auth")
  implementation("com.google.firebase:firebase-firestore")
}

    من خلال استخدام BoM Android في Firebase، سيستخدم تطبيقك دائمًا الإصدارات المتوافقة من Firebase Android المكتبات.

    هل تبحث عن وحدة مكتبة خاصة بلغة Kotlin؟ ستبدأ بعد تشرين الأول (أكتوبر) 2023 (الإصدار 32.5.0 من Firebase BoM)، بإمكان مطوّري برامج Kotlin وJava تعتمد على وحدة المكتبة الرئيسية (لمزيد من التفاصيل، راجع الأسئلة الشائعة حول هذه المبادرة).

    عدم تفعيل الإحصاءات 

    dependencies {
  // ...

  // Import the Firebase BoM
  implementation(platform("com.google.firebase:firebase-bom:33.1.2"))

  // When using the BoM, you don't specify versions in Firebase library dependencies

  // TODO: Add the dependencies for Firebase products you want to use
  // See https://firebase.google.com/docs/android/setup#available-libraries
  // For example, add the dependencies for Firebase Authentication and Cloud Firestore
  implementation("com.google.firebase:firebase-auth")
  implementation("com.google.firebase:firebase-firestore")
}

    من خلال استخدام BoM Android في Firebase، سيستخدم تطبيقك دائمًا الإصدارات المتوافقة من Firebase Android المكتبات.

    هل تبحث عن وحدة مكتبة خاصة بلغة Kotlin؟ ستبدأ بعد تشرين الأول (أكتوبر) 2023 (الإصدار 32.5.0 من Firebase BoM)، بإمكان مطوّري برامج Kotlin وJava تعتمد على وحدة المكتبة الرئيسية (لمزيد من التفاصيل، راجع الأسئلة الشائعة حول هذه المبادرة).

  2. بعد إضافة التبعيات للمنتجات التي تريد استخدامها، قم بمزامنة مشروع Android مع ملفات Gradle

وهذا كل ما في الأمر! يمكنك التخطّي للاطّلاع على الاقتراحات الخطوات التالية.

إذا كنت تواجه مشكلة في عملية الإعداد، يُرجى الانتقال إلى تحديد مشاكل Android وحلّها الأسئلة الشائعة:


الخيار 2: إضافة Firebase باستخدام "مساعد Firebase"

يسجِّل مساعد Firebase لتطبيقك بمشروع Firebase وإضافة ملفات Firebase والمكوّنات الإضافية اللازمة ومعلومات عن مشروعك على Android، كل ذلك من داخل "استوديو Android".

  1. افتح مشروع Android في "استوديو Android" ثم تأكَّد من باستخدام أحدث إصدار من "استوديو Android" و"مساعد Firebase":

    • Windows / Linux: مساعدة > البحث عن تحديثات
    • macOS: Android Studio > البحث عن تحديثات

  2. افتح "مساعد Firebase": الأدوات >. Firebase:

  3. في لوحة مساعد Google، اختَر أحد منتجات Firebase لإضافته إلى تطبيقك. وسِّع قسم الدليل التوجيهي، ثم انقر على رابط الدليل التوجيهي. (على سبيل المثال، إحصاءات Google > تسجيل حدث في "إحصاءات Google").

    1. انقر على الربط بمنصة Firebase لربط مشروع Android بمنصّة Firebase.

    2. انقر على الزر لإضافة منتج Firebase المطلوب (على سبيل المثال، إضافة "إحصاءات Google" إلى تطبيقك).

  4. قم بمزامنة تطبيقك للتأكد من أن جميع التبعيات لديها الإصدارات اللازمة.

  5. في لوحة مساعد Google، اتّبِع تعليمات الإعداد المتبقية منتج Firebase الذي اخترته.

  6. يمكنك إضافة العدد الذي تريده من منتجات Firebase من خلال Firebase. مساعد Google!

وهذا كل ما في الأمر! ننصحك بالاطّلاع على الفيديوهات المقترَحة الخطوات التالية.

إذا كنت تواجه مشكلة في عملية الإعداد، يُرجى الانتقال إلى تحديد مشاكل Android وحلّها الأسئلة الشائعة:


المكتبات المتاحة

يسرد هذا القسم منتجات Firebase المتوافقة مع Android وأجهزة Gradle المرتبطة بها. والتبعيات لديك. اطّلِع على المزيد من المعلومات عن مكتبات Android التالية من Firebase:

  • المستندات المرجعية (Kotlin+KTX | Java)

  • حزمة تطوير البرامج (SDK) لنظام التشغيل Android لمنصة Firebase مستودع GitHub

يُرجى العلم أنّه عند استخدام قائمة بنود Android لمنصة Firebase، لا يمكنك تحديد إصدارات مكتبة فردية عند الإعلان عن مكتبة Firebase. والتبعيات في ملف تهيئة إصدار Gradle.

الخدمة أو المنتج تبعية Gradle أحدث
إصدار		 هل تريد إضافة "إحصاءات Google"؟
قائمة مواد Android في Firebase
(قائمة المواد)		 com.google.firebase:firebase-bom

يحتوي أحدث إصدار من قائمة BoM في Firebase على أحدث الإصدارات. لكل من مكتبة Firebase Android. لمعرفة إصدارات المكتبة بنسخة محددة من BoM، فراجع ملاحظات الإصدار لنسخة BoM هذه.

 33.1.2
AdMob com.google.android.gms:play-services-ads 23.2
إحصاءات Google com.google.firebase:firebase-analytics 22.0.2
موفِّر خدمة مخصّص لميزة "فحص التطبيقات" com.google.firebase:firebase-appcheck 18.0.0
موفِّر تصحيح أخطاء التطبيق com.google.firebase:firebase-appcheck-debug 18.0.0
موفّر Play Integrity لميزة "التحقّق من التطبيقات" com.google.firebase:firebase-appcheck-playintegrity 18.0.0
توزيع التطبيقات com.google.firebase:firebase-appdistribution الإصدار التجريبي 16.0.0-13
واجهة برمجة التطبيقات لتوزيع التطبيقات com.google.firebase:firebase-appdistribution-api الإصدار التجريبي 16.0.0-13
مكوِّن إضافي لتوزيع التطبيقات com.google.firebase:firebase-appdistribution-gradle 5.0.0
المصادقة com.google.firebase:firebase-auth 23.0.0
Cloud Firestore com.google.firebase:firebase-firestore 25.0.0
حزمة تطوير البرامج (SDK) الخاصة بإصدار Cloud Functions لبرنامج Firebase com.google.firebase:دوال firebase 21.0.0
المراسلة عبر السحابة الإلكترونية com.google.firebase:firebase-messaging 24.0.0
التخزين في السحابة الإلكترونية com.google.firebase:firebase-storage 21.0.0
Crashlytics com.google.firebase:firebase-crashlytics 19.0.3
Crashlytics NDK com.google.firebase:firebase-crashlytics-ndk 19.0.3
المكوّن الإضافي Crashlytics com.google.firebase:firebase-crashlytics-gradle 3.0.2
دعم وحدات الميزات الديناميكية com.google.firebase:firebase-dynamic-module-support 16.0.0-تجريبي03
الروابط الديناميكية com.google.firebase:firebase-dynamic-links 22.1.0
المراسلة داخل التطبيق com.google.firebase:firebase-inappmessaging 21.0.0
(مطلوب)
عرض الرسائل داخل التطبيق com.google.firebase:firebase-inappmessaging-display 21.0.0
(مطلوب)
عمليات تثبيت Firebase com.google.firebase:firebase-installations 18.0.0
واجهة برمجة التطبيقات لأداة تنزيل نماذج تعلُّم الآلة من Firebase com.google.firebase:firebase-ml-modeldownloader 25.0.0
مراقبة الأداء com.google.firebase:firebase-perf 21.0.1
المكوّن الإضافي "مراقبة الأداء" com.google.firebase:perf-plugin 1.4.2
قاعدة بيانات الوقت الفعلي com.google.firebase:firebase-database 21.0.0
الإعداد عن بُعد com.google.firebase:firebase-config 22.0.0
Vertex AI لبرنامج Firebase com.google.firebase:firebase-vertexai 16.0.0-تجريبي03
المكوّن الإضافي "خدمات Google Play" com.google.gms:google-services 4.4.2
المكتبات التي تم إيقافها نهائيًا
موفّر خدمة App Check SafetyNet com.google.firebase:firebase-appcheck-safetynet 16.1.2
فهرسة التطبيقات com.google.firebase:firebase-appindexing 20.0.0

وحدات KTX من Firebase

إحصاءات Google com.google.firebase:firebase-analytics-ktx 22.0.2
موفِّر خدمة مخصّص لميزة "فحص التطبيقات" com.google.firebase:firebase-appcheck-ktx 18.0.0
واجهة برمجة التطبيقات لتوزيع التطبيقات com.google.firebase:firebase-appdistribution-api-ktx الإصدار التجريبي 16.0.0-13
المصادقة com.google.firebase:firebase-auth-ktx 23.0.0
Cloud Firestore com.google.firebase:firebase-firestore-ktx 25.0.0
حزمة تطوير البرامج (SDK) الخاصة بإصدار Cloud Functions لبرنامج Firebase com.google.firebase:firebase-functions-ktx 21.0.0
المراسلة عبر السحابة الإلكترونية com.google.firebase:firebase-messaging-ktx 24.0.0
التخزين في السحابة الإلكترونية com.google.firebase:firebase-storage-ktx 21.0.0
Crashlytics com.google.firebase:firebase-crashlytics-ktx 19.0.3
الروابط الديناميكية com.google.firebase:firebase-dynamic-links-ktx 22.1.0
المراسلة داخل التطبيق com.google.firebase:firebase-inappmessaging-ktx 21.0.0
(مطلوب)
عرض الرسائل داخل التطبيق com.google.firebase:firebase-inappmessaging-display-ktx 21.0.0
(مطلوب)
عمليات تثبيت Firebase com.google.firebase:firebase-installations-ktx 18.0.0
واجهة برمجة التطبيقات لأداة تنزيل نماذج تعلُّم الآلة من Firebase com.google.firebase:firebase-ml-modeldownloader-ktx 25.0.0
مراقبة الأداء com.google.firebase:firebase-perf-ktx 21.0.1
قاعدة بيانات الوقت الفعلي com.google.firebase:firebase-database-ktx 21.0.0
الإعداد عن بُعد com.google.firebase:firebase-config-ktx 22.0.0

مكتبات حزمة تعلُّم الآلة من Firebase

واجهات برمجة التطبيقات للنماذج المخصّصة لتعلُّم الآلة من Firebase com.google.firebase:firebase-ml-model-interpreter 22.0.4
واجهات برمجة التطبيقات لمنصة Firebase ML Vision com.google.firebase:firebase-ml-vision 24 نوفمبر
تعلُّم الآلة من Firebase: نموذج تصنيف الصور com.google.firebase:firebase-ml-vision-image-label-model 20.0.2
تعلُّم الآلة من Firebase: نموذج التتبُّع ورصد العناصر com.google.firebase:firebase-ml-vision-object-detection-model 19.0.6
تعلُّم الآلة من Firebase: نموذج التعرّف على الوجوه com.google.firebase:firebase-ml-vision-face-model 20.0.2
تعلُّم الآلة من Firebase: نموذج فحص الرموز الشريطية com.google.firebase:firebase-ml-vision-barcode-model 16.1.2
تعلُّم الآلة من Firebase: واجهة برمجة التطبيقات AutoML Vision Edge com.google.firebase:firebase-ml-vision-automl 18.0.6
تعلُّم الآلة في Firebase: واجهات برمجة التطبيقات للّغات الطبيعية com.google.firebase:firebase-ml-natural-language 22.0.1
تعلُّم الآلة في Firebase: نموذج تعريف اللغة com.google.firebase:firebase-ml-natural-language-language-id-model 20.0.8
تعلُّم الآلة من Firebase: نموذج "ترجمة Google" com.google.firebase:firebase-ml-natural-language-translate-model 20.0.9
تعلُّم الآلة من Firebase: نموذج الرد السريع com.google.firebase:firebase-ml-natural-language-smart-reply-model 20.0.8


الخطوات التالية

إضافة خدمات Firebase إلى تطبيقك:

تعرَّف على Firebase: