Catch up on highlights from Firebase at Google I/O 2023. Learn more

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

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

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

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

    • تستهدف مستوى API 19 (KitKat) أو أعلى
    • يستخدم Android 4.4 أو أعلى
    • يستخدم Jetpack (AndroidX) ، والذي يتضمن تلبية متطلبات الإصدار التالية:
      • com.android.tools.build:gradle v3.2.1 أو أحدث
      • compileSdkVersion 28 أو أحدث
  • قم بإعداد جهاز مادي أو استخدام محاكي لتشغيل تطبيقك.
    لاحظ أن Firebase SDKs التي تعتمد على خدمات 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 SDKs ، فأنت بحاجة إلى المكون الإضافي لخدمات Google Gradle ( google-services ).

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

      buildscript {
      
          repositories {
            // Make sure that you have the following two repositories
            google()  // Google's Maven repository
            mavenCentral()  // Maven Central repository
          }
      
          dependencies {
            ...
      
            // Add the dependency for the Google services Gradle plugin
            classpath 'com.google.gms:google-services:4.3.15'
          }
      }
      
      allprojects {
        ...
      
        repositories {
          // Make sure that you have the following two repositories
          google()  // Google's Maven repository
          mavenCentral()  // Maven Central repository
        }
      }
      
    2. في ملف Gradle (على مستوى التطبيق) الوحدة النمطية الخاصة بك (عادةً <project>/<app-module>/build.gradle ) ، أضف المكوّن الإضافي لخدمات Google:

      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 ) ، أضف تبعيات منتجات Firebase التي تريد استخدامها في تطبيقك. نوصي باستخدام Firebase Android BoM للتحكم في إصدارات المكتبة.

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

    Kotlin+KTX

    dependencies {
      // ...
    
      // Import the Firebase BoM
      implementation platform('com.google.firebase:firebase-bom:32.1.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-ktx'
    
      // 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-ktx'
      implementation 'com.google.firebase:firebase-firestore-ktx'
    }
    

    Java

    dependencies {
      // ...
    
      // Import the Firebase BoM
      implementation platform('com.google.firebase:firebase-bom:32.1.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+KTX

    dependencies {
      // ...
    
      // Import the Firebase BoM
      implementation platform('com.google.firebase:firebase-bom:32.1.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-ktx'
      implementation 'com.google.firebase:firebase-firestore-ktx'
    }
    

    Java

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

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

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

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



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

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

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

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

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

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

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

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

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

  6. أضف أي عدد تريده من منتجات Firebase عبر مساعد Firebase!

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

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



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

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

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

Kotlin+KTX

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

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

32.1.0
AdMob com.google.android.gms: play-services-ads 22.1.0
تحليلات com.google.firebase: firebase-analytics-ktx 21.3.0
التطبيق تحقق مزود مخصص com.google.firebase: firebase-appcheck-ktx 17.0.1
مزود التصحيح App Check com.google.firebase: firebase-appcheck-debug 17.0.1
مقدم خدمة التحقق من Play Integrity com.google.firebase: firebase-appcheck-playintegrity 17.0.1
توزيع التطبيق com.google.firebase: firebase-appdistribution 16.0.0 بيتا 08
واجهة برمجة تطبيقات توزيع التطبيقات com.google.firebase: firebase-appdistribution-api-ktx 16.0.0 بيتا 08
البرنامج المساعد لتوزيع التطبيقات com.google.firebase: firebase-appdistribution-gradle 4.0.0
المصادقة com.google.firebase: firebase-auth-ktx 22.0.0
سحابة Firestore com.google.firebase: firebase-firestore-ktx 24.6.1
وظائف السحابة لـ Firebase Client SDK com.google.firebase: firebase-function-ktx 20.3.1
المراسلة السحابية com.google.firebase: firebase-messaging-ktx 23.1.2
سحابة التخزين com.google.firebase: firebase-storage-ktx 20.2.0
Crashlytics com.google.firebase: firebase-crashlytics-ktx 18.3.7
Crashlytics NDK com.google.firebase: firebase-crashlytics-ndk 18.3.7
البرنامج المساعد Crashlytics com.google.firebase: firebase-crashlytics-gradle 2.9.5
دعم وحدة الميزة الديناميكية com.google.firebase: firebase-dynamic-module-support 16.0.0 بيتا 03
روابط ديناميكية com.google.firebase: firebase-dynamic-links-ktx 21.1.0
المراسلة داخل التطبيق com.google.firebase: firebase-inappmessaging-ktx 20.3.2
(مطلوب)
شاشة الرسائل داخل التطبيق com.google.firebase: firebase-inappmessaging-display-ktx 20.3.2
(مطلوب)
منشآت Firebase com.google.firebase: firebase-Installation-ktx 17.1.3
واجهة برمجة تطبيقات Firebase ML Model Downloader com.google.firebase: firebase-ml-modeldownloader-ktx 24.1.2
مراقبة الاداء com.google.firebase: firebase-perf-ktx 20.3.2
البرنامج المساعد لمراقبة الأداء com.google.firebase: perf-plugin 1.4.2
قاعدة بيانات الوقت الفعلي com.google.firebase: firebase-database-ktx 20.2.2
التكوين عن بعد com.google.firebase: firebase-config-ktx 21.4.0
المكون الإضافي لخدمات Google Play com.google.gms: خدمات google 4.3.15
مكتبات مهجورة
مزود التطبيق تحقق SafetyNet com.google.firebase: firebase-appcheck-safetynet 16.1.2
فهرسة التطبيق com.google.firebase: firebase-appindexing 20.0.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 API 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-response-model 20.0.8

Java

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

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

32.1.0
AdMob com.google.android.gms: play-services-ads 22.1.0
تحليلات com.google.firebase: firebase-analytics 21.3.0
التطبيق تحقق مزود مخصص com.google.firebase: firebase-appcheck 17.0.1
مزود التصحيح App Check com.google.firebase: firebase-appcheck-debug 17.0.1
التحقق من التطبيق مزود نزاهة اللعب com.google.firebase: firebase-appcheck-playintegrity 17.0.1
توزيع التطبيق com.google.firebase: firebase-appdistribution 16.0.0 بيتا 08
واجهة برمجة تطبيقات توزيع التطبيقات com.google.firebase: firebase-appdistribution-api 16.0.0 بيتا 08
البرنامج المساعد لتوزيع التطبيقات com.google.firebase: firebase-appdistribution-gradle 4.0.0
المصادقة com.google.firebase: firebase-auth 22.0.0
سحابة Firestore com.google.firebase: firebase-firestore 24.6.1
وظائف السحابة لـ Firebase Client SDK com.google.firebase: وظائف firebase 20.3.1
المراسلة السحابية com.google.firebase: firebase-messaging 23.1.2
سحابة التخزين com.google.firebase: firebase-storage 20.2.0
Crashlytics com.google.firebase: firebase-crashlytics 18.3.7
Crashlytics NDK com.google.firebase: firebase-crashlytics-ndk 18.3.7
البرنامج المساعد Crashlytics com.google.firebase: firebase-crashlytics-gradle 2.9.5
دعم وحدة الميزة الديناميكية com.google.firebase: firebase-dynamic-module-support 16.0.0 بيتا 03
روابط ديناميكية com.google.firebase: firebase-dynamic-links 21.1.0
المراسلة داخل التطبيق com.google.firebase: firebase-inappmessaging 20.3.2
(مطلوب)
شاشة الرسائل داخل التطبيق com.google.firebase: firebase-inappmessaging-display 20.3.2
(مطلوب)
منشآت Firebase com.google.firebase: firebase-Installation 17.1.3
واجهة برمجة تطبيقات Firebase ML Model Downloader com.google.firebase: firebase-ml-modeldownloader 24.1.2
مراقبة الاداء com.google.firebase: firebase-perf 20.3.2
البرنامج المساعد لمراقبة الأداء com.google.firebase: perf-plugin 1.4.2
قاعدة بيانات الوقت الفعلي com.google.firebase: firebase-database 20.2.2
التكوين عن بعد com.google.firebase: firebase-config 21.4.0
المكون الإضافي لخدمات Google Play com.google.gms: خدمات google 4.3.15
مكتبات مهجورة
مزود التطبيق تحقق SafetyNet com.google.firebase: firebase-appcheck-safetynet 16.1.2
فهرسة التطبيق com.google.firebase: firebase-appindexing 20.0.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 API 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-response-model 20.0.8



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

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

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

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

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

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

  • تشغيل رمز الواجهة الخلفية الذي يعمل في بيئة آمنة باستخدام وظائف السحابة .

  • إرسال الإخطارات مع Cloud Messaging .

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

تعرف على Firebase: