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

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

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

  • تأكد من أن مشروعك يلبي هذه المتطلبات:

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

  • قم بتسجيل الدخول إلى Firebase باستخدام حساب Google الخاص بك.

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


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

  • الخيار 1 : (مستحسن) استخدم سير عمل إعداد وحدة تحكم Firebase.
  • الخيار 2 : استخدم Android Studio Firebase Assistant (قد يتطلب تكوينًا إضافيًا).



الخيار 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 الخاص بك قابلة للوصول إلى Firebase SDK، تحتاج إلى المكون الإضافي Google Services Gradle ( 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.0" 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.0' 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 : أضف حزم Firebase SDK إلى تطبيقك

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

    تم تمكين التحليلات

    dependencies {
      // ...
    
      // Import the Firebase BoM
      implementation(platform("com.google.firebase:firebase-bom:32.6.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 BoM ، سيستخدم تطبيقك دائمًا إصدارات متوافقة من مكتبات Firebase Android.

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

    التحليلات غير ممكّنة

    dependencies {
      // ...
    
      // Import the Firebase BoM
      implementation(platform("com.google.firebase:firebase-bom:32.6.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 BoM ، سيستخدم تطبيقك دائمًا إصدارات متوافقة من مكتبات Firebase Android.

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

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

هذا كل شيء! يمكنك التخطي للأمام للتحقق من الخطوات التالية الموصى بها.

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



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

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

  1. افتح مشروع Android الخاص بك في Android Studio، ثم تأكد من أنك تستخدم أحدث إصدارات Android Studio وFirebase Assistant:

    • Windows / Linux: تعليمات > التحقق من وجود تحديثات
    • نظام التشغيل MacOS: Android Studio > التحقق من وجود تحديثات
  2. افتح مساعد Firebase: الأدوات > Firebase .

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

    1. انقر فوق "الاتصال بـ Firebase" لتوصيل مشروع Android الخاص بك بـ Firebase.

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

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

  5. في جزء المساعد ، اتبع تعليمات الإعداد المتبقية لمنتج Firebase المحدد.

  6. أضف أي عدد تريده من منتجات Firebase الأخرى عبر Firebase Assistant!

هذا كل شيء! تأكد من مراجعة الخطوات التالية الموصى بها.

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



المكتبات المتوفرة

يسرد هذا القسم منتجات Firebase المدعومة لنظام التشغيل Android وتبعيات Gradle الخاصة بها. تعرف على المزيد حول مكتبات Firebase Android هذه:

لاحظ أنه عند استخدام Firebase Android BoM ، فإنك لا تحدد إصدارات مكتبة فردية عندما تعلن عن تبعيات مكتبة Firebase في ملف تكوين بناء Gradle الخاص بك.

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

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

32.6.0
ادموب com.google.android.gms:play-services-ads 22.5.0
التحليلات com.google.firebase:firebase-analytics 21.5.0
التحقق من التطبيق مزود مخصص com.google.firebase:firebase-appcheck 17.1.1
التطبيق التحقق من مزود التصحيح com.google.firebase:firebase-appcheck-debug 17.1.1
التحقق من التطبيق مزود النزاهة اللعب com.google.firebase:firebase-appcheck-playintegrity 17.1.1
توزيع التطبيق com.google.firebase:firebase-appdistribution 16.0.0-beta11
واجهة برمجة التطبيقات لتوزيع التطبيقات com.google.firebase:firebase-appdistribution-api 16.0.0-beta11
البرنامج المساعد لتوزيع التطبيق com.google.firebase:firebase-appdistribution-gradle 4.0.1
المصادقة com.google.firebase:firebase-auth 22.3.0
سحابة فايرستور com.google.firebase:firebase-firestore 24.9.1
وظائف السحابة لـ Firebase Client SDK com.google.firebase:firebase-functions 20.4.0
المراسلة السحابية com.google.firebase:firebase-messaging 23.3.1
سحابة التخزين com.google.firebase:firebase-storage 20.3.0
Crashlytics com.google.firebase:firebase-crashlytics 18.6.0
كراشليتيكس NDK com.google.firebase:firebase-crashlytics-ndk 18.6.0
البرنامج المساعد Crashlytics com.google.firebase:firebase-crashlytics-gradle 2.9.9
دعم وحدة الميزة الديناميكية com.google.firebase:firebase-dynamic-module-support 16.0.0-beta03
الروابط الديناميكية com.google.firebase:firebase-dynamic-links 21.2.0
المراسلة داخل التطبيق com.google.firebase:firebase-inappmessaging 20.4.0
(مطلوب)
عرض الرسائل داخل التطبيق com.google.firebase:firebase-inappmessaging-display 20.4.0
(مطلوب)
منشآت Firebase com.google.firebase:firebase-installations 17.2.0
واجهة برمجة تطبيقات Firebase ML Model Downloader com.google.firebase:firebase-ml-modeldownloader 24.2.1
مراقبة الاداء com.google.firebase:firebase-perf 20.5.1
البرنامج المساعد لمراقبة الأداء com.google.firebase:perf-plugin 1.4.2
قاعدة بيانات الوقت الحقيقي com.google.firebase:firebase-database 20.3.0
التكوين عن بعد com.google.firebase:firebase-config 21.6.0
البرنامج المساعد لخدمات جوجل بلاي com.google.gms:google-services 4.4.0
المكتبات المهملة
التحقق من التطبيق مزود SafetyNet com.google.firebase:firebase-appcheck-safetynet 16.1.2
فهرسة التطبيق com.google.firebase:firebase-appindexing 20.0.0

وحدات Firebase KTX

التحليلات com.google.firebase:firebase-analytics-ktx 21.5.0
التحقق من التطبيق مزود مخصص com.google.firebase:firebase-appcheck-ktx 17.1.1
واجهة برمجة التطبيقات لتوزيع التطبيقات com.google.firebase:firebase-appdistribution-api-ktx 16.0.0-beta11
المصادقة com.google.firebase:firebase-auth-ktx 22.3.0
سحابة فايرستور com.google.firebase:firebase-firestore-ktx 24.9.1
وظائف السحابة لـ Firebase Client SDK com.google.firebase:firebase-functions-ktx 20.4.0
المراسلة السحابية com.google.firebase:firebase-messaging-ktx 23.3.1
سحابة التخزين com.google.firebase:firebase-storage-ktx 20.3.0
Crashlytics com.google.firebase:firebase-crashlytics-ktx 18.6.0
الروابط الديناميكية com.google.firebase:firebase-dynamic-links-ktx 21.2.0
المراسلة داخل التطبيق com.google.firebase:firebase-inappmessaging-ktx 20.4.0
(مطلوب)
عرض الرسائل داخل التطبيق com.google.firebase:firebase-inappmessaging-display-ktx 20.4.0
(مطلوب)
منشآت Firebase com.google.firebase:firebase-installations-ktx 17.2.0
واجهة برمجة تطبيقات Firebase ML Model Downloader com.google.firebase:firebase-ml-modeldownloader-ktx 24.2.1
مراقبة الاداء com.google.firebase:firebase-perf-ktx 20.5.1
قاعدة بيانات الوقت الحقيقي com.google.firebase:firebase-database-ktx 20.3.0
التكوين عن بعد com.google.firebase:firebase-config-ktx 21.6.0

مكتبات Firebase ML Kit

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



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

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

  • احصل على رؤى حول سلوك المستخدم باستخدام Analytics .

  • قم بإعداد تدفق مصادقة المستخدم باستخدام المصادقة .

  • قم بتخزين البيانات، مثل معلومات المستخدم، باستخدام Cloud Firestore أو Realtime Database .

  • قم بتخزين الملفات، مثل الصور ومقاطع الفيديو، باستخدام Cloud Storage .

  • تشغيل كود الواجهة الخلفية الذي يتم تشغيله في بيئة آمنة باستخدام Cloud Functions .

  • إرسال الإخطارات مع خدمة المراسلة السحابية .

  • اكتشف متى ولماذا يتعطل تطبيقك مع Crashlytics .

تعرف على Firebase: