إضافة Firebase إلى مشروع Android الخاص بك

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

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

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

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

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

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


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

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



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

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

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

قبل إضافة Firebase إلى تطبيقك على Android، يجب إنشاء مشروع في Firebase لربطه بتطبيق 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.

    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.1" 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.1' 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 التي تريد استخدامها في تطبيقك. وننصحك باستخدام مشروع Firebase Android BoM للتحكّم في إصدارات المكتبة.

    تم تفعيل "إحصاءات Google"

    dependencies {
      // ...
    
      // Import the Firebase BoM
      implementation(platform("com.google.firebase:firebase-bom:33.0.0"))
    
      // 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")
    }
    

    باستخدام مشروع تمويل Firebase Android، سيستخدم تطبيقك دائمًا إصدارات متوافقة من مكتبات Firebase لأجهزة Android.

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

    "إحصاءات Google" غير مفعّلة

    dependencies {
      // ...
    
      // Import the Firebase BoM
      implementation(platform("com.google.firebase:firebase-bom:33.0.0"))
    
      // 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")
    }
    

    باستخدام مشروع تمويل Firebase Android، سيستخدم تطبيقك دائمًا إصدارات متوافقة من مكتبات Firebase لأجهزة Android.

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

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

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

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



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

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

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

    • نظاما التشغيل Windows / Linux: مساعدة > البحث عن تحديثات
    • نظام التشغيل macOS: استوديو Android > البحث عن تحديثات
  2. افتح "مساعد Firebase": الأدوات > Firebase.

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

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

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

  4. عليك مزامنة تطبيقك للتأكُّد من احتواء جميع التبعيات على الإصدارات اللازمة.

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

  6. يمكنك إضافة أي عدد تريده من منتجات Firebase عبر "مساعد Firebase".

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

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



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

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

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

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

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

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

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

33.0.0
AdMob com.google.android.gms:play-services-ads 23.0.0
إحصاءات Google com.google.firebase:firebase-analytics 22.0.0
مقدّم خدمة App Check 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-تجريبي12
App Distribution API com.google.firebase:firebase-appdistribution-api الإصدار 16.0.0-تجريبي12
المكوّن الإضافي لتوزيع التطبيقات 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
وظائف Cloud لحزمة تطوير البرامج (SDK) لعميل Firebase com.google.firebase:firebase-functions 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.0
Crashlytics NDK com.google.firebase:firebase-crashlytics-ndk 19.0.0
مكوّن Crashlytics الإضافي com.google.firebase:firebase-crashlytics-gradle 3.0.0
إتاحة استخدام وحدة الميزات الديناميكية com.google.firebase:firebase- Dynamic-موز -support الإصدار 16.0.0-تجريبي03
الروابط الديناميكية com.google.firebase:firebase- Dynamic-links 22.0.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.0
المكوّن الإضافي "مراقبة الأداء" com.google.firebase:perf- الافتراضي 1.4.2
قاعدة بيانات الوقت الفعلي com.google.firebase:firebase-database 21.0.0
الإعداد عن بُعد com.google.firebase:firebase-config 22.0.0
المكوّن الإضافي "خدمات Google Play" com.google.gms:google-services 4.4.1
المكتبات التي تم إيقافها نهائيًا
موفّر خدمة SafetyNet بشأن التحقّق من التطبيقات com.google.firebase:firebase-appcheck-safetynet 16.1.2
فهرسة التطبيقات com.google.firebase:firebase-appindexing 20.0.0

وحدات Firebase KTX

إحصاءات Google com.google.firebase:firebase-analytics-ktx 22.0.0
مقدّم خدمة App Check com.google.firebase:firebase-appcheck-ktx 18.0.0
App Distribution API com.google.firebase:firebase-appdistribution-api-ktx الإصدار 16.0.0-تجريبي12
المصادقة com.google.firebase:firebase-auth-ktx 23.0.0
Cloud Firestore com.google.firebase:firebase-firestore-ktx 25.0.0
وظائف Cloud لحزمة تطوير البرامج (SDK) لعميل 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.0
الروابط الديناميكية com.google.firebase:firebase- Dynamic-links-ktx 22.0.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.0
قاعدة بيانات الوقت الفعلي 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.1.0
تعلُّم الآلة في 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: نموذج الترجمة 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: