ترجمت واجهة Cloud Translation API‏ هذه الصفحة.
Switch to English

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

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

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

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

    • تستهدف مستوى API 16 (Jelly Bean) أو ما بعده
    • يستخدم Gradle 4.1 أو أحدث
    • يستخدم Jetpack (AndroidX) ، والذي يتضمن تلبية متطلبات الإصدار التالية:
      • com.android.tools.build:gradle v3.2.1 أو أحدث
      • compileSdkVersion 28 أو أحدث
  • قم بإعداد جهاز مادي أو استخدام محاكي لتشغيل تطبيقك.
    محاكاة يجب استخدام صورة المحاكي مع جوجل اللعب.

  • سجّل الدخول إلى 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 لمعرفة المزيد حول أفضل الممارسات والاعتبارات لإضافة تطبيقات إلى مشروع Firebase ، بما في ذلك كيفية التعامل مع متغيرات بناء متعددة.

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

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

    إذا كنت قد أضفت بالفعل تطبيقًا إلى مشروع Firebase ، فانقر فوق إضافة تطبيق لعرض خيارات النظام الأساسي.

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

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

  5. انقر فوق تسجيل التطبيق .

الخطوة 3 : أضف ملف تكوين Firebase

  1. أضف ملف تهيئة Firebase Android إلى تطبيقك:

    1. انقر فوق تنزيل google-services.json للحصول على ملف تهيئة Firebase Android ( google-services.json ).

    2. انقل ملف التكوين الخاص بك إلى دليل الوحدة النمطية (مستوى التطبيق) لتطبيقك.

  2. لتمكين منتجات Firebase في تطبيقك ، أضف المكوِّن الإضافي لخدمات google إلى ملفات Gradle.

    1. في ملف Gradle على مستوى الجذر (على مستوى المشروع) ( build.gradle ) ، أضف قواعد لتضمين المكوّن الإضافي Google Services Gradle. تحقق من أن لديك مستودع Google Maven أيضًا.

      buildscript {
      
        repositories {
          // Check that you have the following line (if not, add it):
          google()  // Google's Maven repository
        }
      
        dependencies {
          // ...
      
          // Add the following line:
          classpath 'com.google.gms:google-services:4.3.3'  // Google Services plugin
        }
      }
      
      allprojects {
        // ...
      
        repositories {
          // Check that you have the following line (if not, add it):
          google()  // Google's Maven repository
          // ...
        }
      }
      
    2. في ملف Gradle (على مستوى التطبيق) الوحدة النمطية الخاصة بك (عادةً app/build.gradle ) ، قم بتطبيق مكون Google Services Gradle الإضافي:

      apply plugin: 'com.android.application'
      // Add the following line:
      apply plugin: 'com.google.gms.google-services'  // Google Services plugin
      
      android {
        // ...
      }
      

الخطوة 4 : أضف حزم Firebase SDK إلى تطبيقك

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

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

    جافا

    dependencies {
      // ...
    
      // Add the dependency for the Firebase SDK for Google Analytics
      implementation 'com.google.firebase:firebase-analytics:17.5.0'
    
      // Add the dependencies for any other desired Firebase products
      // For example, to use Firebase Authentication and Cloud Firestore
      implementation 'com.google.firebase:firebase-auth:19.4.0'
      implementation 'com.google.firebase:firebase-firestore:21.6.0'
    }
    
    // Getting a "Could not find" error? Make sure that you've added
    // Google's Maven repository to your project-level build.gradle file
    

    Kotlin + KTX

    dependencies {
      // ...
    
      // Add the dependency for the Firebase SDK for Google Analytics
      implementation 'com.google.firebase:firebase-analytics-ktx:17.5.0'
    
      // Add the dependencies for any other desired Firebase products
      // For example, to use Firebase Authentication and Cloud Firestore
      implementation 'com.google.firebase:firebase-auth-ktx:19.4.0'
      implementation 'com.google.firebase:firebase-firestore-ktx:21.6.0'
    }
    
    // Getting a "Could not find" error? Make sure that you've added
    // Google's Maven repository to your project-level build.gradle file
    

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

    جافا

    dependencies {
      // ...
    
      // Add the dependencies for the desired Firebase products
      // For example, to use Firebase Authentication and Cloud Firestore
      implementation 'com.google.firebase:firebase-auth:19.4.0'
      implementation 'com.google.firebase:firebase-firestore:21.6.0'
    }
    
    // Getting a "Could not find" error? Make sure that you've added
    // Google's Maven repository to your project-level build.gradle file
    

    Kotlin + KTX

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

هذا هو! يمكنك الانتقال إلى الخطوات التالية .

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

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

لاحظ أن الخيار الموصى به لتوصيل تطبيقك بـ Firebase هو استخدام سير عمل إعداد وحدة تحكم Firebase .

  1. افتح مشروع Android الخاص بك في Android Studio.

  2. حدد أدوات> Firebase لفتح جزء المساعد .

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

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

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

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

  7. إذا أضفت Analytics ، فقم بتشغيل تطبيقك لإرسال إثبات إلى Firebase بأنك نجحت في دمج Firebase. خلاف ذلك ، يمكنك تخطي خطوة التحقق هذه.

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

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

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

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

التحكم في إصدارات مكتبة Firebase Bill of Materials (BoM)

لتسهيل إدارة إصدار المكتبة ، ضع في اعتبارك استيراد قائمة مواد Firebase (BoM).

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

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

جافا

الخدمة أو المنتج تبعيات Gradle إضافة تحليلات؟
AdMob com.google.android.gms: play-services-ads: 19.4.0
تحليلات com.google.firebase: firebase-analytics: 17.5.0
فهرسة التطبيق com.google.firebase: firebase-appindexing: 19.1.0
المصادقة com.google.firebase: firebase-auth: 19.4.0
سحابة Firestore com.google.firebase: firebase-firestore: 21.6.0
وظائف السحابة لـ Firebase Client SDK com.google.firebase: وظائف Firebase: 19.1.0
المراسلة السحابية com.google.firebase: firebase-messaging: 20.2.4
سحابة التخزين com.google.firebase: firebase-storage: 19.2.0
كراشليتيك com.google.firebase: firebase-crashlytics: 17.2.1
روابط ديناميكية com.google.firebase: firebase-dynamic-links: 19.1.0
واجهات برمجة تطبيقات Firebase ML Vision com.google.firebase: firebase-ml-vision: 24.1.0
واجهات برمجة التطبيقات للنموذج المخصص لـ Firebase ML com.google.firebase: firebase-ml-model-interpreter: 22.0.4
المراسلة داخل التطبيق com.google.firebase: firebase-inappmessaging: 19.1.1
(مطلوب)
شاشة الرسائل داخل التطبيق com.google.firebase: firebase-inappmessaging-display: 19.1.1
(مطلوب)
مراقبة الاداء com.google.firebase: firebase-perf: 19.0.8
قاعدة بيانات الوقت الحقيقي com.google.firebase: firebase-database: 19.4.0
التكوين عن بعد com.google.firebase: firebase-config: 19.2.0
فاتورة مواد Firebase (BoM) com.google.firebase: firebase-bom: 25.10.0

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

المكون الإضافي لخدمات Google Play com.google.gms: خدمات google: 4.3.3
مكتبات مهملة
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

Kotlin + KTX

الخدمة أو المنتج تبعيات Gradle إضافة تحليلات؟
AdMob com.google.android.gms: play-services-ads: 19.4.0
تحليلات com.google.firebase: firebase-analytics-ktx: 17.5.0
فهرسة التطبيق com.google.firebase: firebase-appindexing: 19.1.0
المصادقة com.google.firebase: firebase-auth-ktx: 19.4.0
سحابة Firestore com.google.firebase: firebase-firestore-ktx: 21.6.0
وظائف السحابة لـ Firebase Client SDK com.google.firebase: firebase-function-ktx: 19.1.0
المراسلة السحابية com.google.firebase: firebase-messaging: 20.2.4
سحابة التخزين com.google.firebase: firebase-storage-ktx: 19.2.0
كراشليتيك com.google.firebase: firebase-crashlytics-ktx: 17.2.1
روابط ديناميكية com.google.firebase: firebase-dynamic-links-ktx: 19.1.0
واجهات برمجة تطبيقات Firebase ML Vision com.google.firebase: firebase-ml-vision: 24.1.0
واجهات برمجة التطبيقات للنموذج المخصص لـ Firebase ML com.google.firebase: firebase-ml-model-interpreter: 22.0.4
المراسلة داخل التطبيق com.google.firebase: firebase-inappmessaging-ktx: 19.1.1
(مطلوب)
شاشة الرسائل داخل التطبيق com.google.firebase: firebase-inappmessaging-display-ktx: 19.1.1
(مطلوب)
مراقبة الاداء com.google.firebase: firebase-perf: 19.0.8
قاعدة بيانات الوقت الحقيقي com.google.firebase: firebase-database-ktx: 19.4.0
التكوين عن بعد com.google.firebase: firebase-config-ktx: 19.2.0
فاتورة مواد Firebase (BoM) com.google.firebase: firebase-bom: 25.10.0

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

المكون الإضافي لخدمات Google Play com.google.gms: خدمات google: 4.3.3
مكتبات مهملة
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:

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

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

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

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

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

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

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

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