Google is committed to advancing racial equity for Black communities. See how.
ترجمت واجهة 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. غالبًا ما يسمى تسجيل تطبيقك "إضافة" تطبيقك إلى مشروعك.

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

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

  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.4'  // 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. باستخدام Firebase Android BoM ، أعلن عن تبعيات منتجات Firebase التي تريد استخدامها في تطبيقك. قم بتعريفها في ملف Gradle ( على مستوى التطبيق) الخاص بالوحدة (عادةً app/build.gradle ).

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

    جافا

    dependencies {
      // ...
    
      // Import the Firebase BoM
      implementation platform('com.google.firebase:firebase-bom:26.0.0')
    
      // When using the BoM, you don't specify versions in Firebase library dependencies
    
      // Declare the dependency for the Firebase SDK for Google Analytics
      implementation 'com.google.firebase:firebase-analytics'
    
      // Declare the dependencies for any other desired Firebase products
      // For example, declare the dependencies for Firebase Authentication and Cloud Firestore
      implementation 'com.google.firebase:firebase-auth'
      implementation 'com.google.firebase:firebase-firestore'
    }
    

    Kotlin + KTX

    dependencies {
      // ...
    
      // Import the Firebase BoM
      implementation platform('com.google.firebase:firebase-bom:26.0.0')
    
      // When using the BoM, you don't specify versions in Firebase library dependencies
    
      // Declare the dependency for the Firebase SDK for Google Analytics
      implementation 'com.google.firebase:firebase-analytics-ktx'
    
      // Declare the dependencies for any other desired Firebase products
      // For example, declare the dependencies for Firebase Authentication and Cloud Firestore
      implementation 'com.google.firebase:firebase-auth-ktx'
      implementation 'com.google.firebase:firebase-firestore-ktx'
    }
    

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

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

    جافا

    dependencies {
      // ...
    
      // Import the Firebase BoM
      implementation platform('com.google.firebase:firebase-bom:26.0.0')
    
      // When using the BoM, you don't specify versions in Firebase library dependencies
    
      // Declare the dependencies for the desired Firebase products
      // For example, declare the dependencies for Firebase Authentication and Cloud Firestore
      implementation 'com.google.firebase:firebase-auth'
      implementation 'com.google.firebase:firebase-firestore'
    }
    

    Kotlin + KTX

    dependencies {
      // ...
    
      // Import the Firebase BoM
      implementation platform('com.google.firebase:firebase-bom:26.0.0')
    
      // When using the BoM, you don't specify versions in Firebase library dependencies
    
      // Declare the dependencies for the desired Firebase products
      // For example, declare the dependencies for Firebase Authentication and Cloud Firestore
      implementation 'com.google.firebase:firebase-auth-ktx'
      implementation 'com.google.firebase:firebase-firestore-ktx'
    }
    

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

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

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



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

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

  1. افتح مشروع Android في Android Studio وقم بالوصول إلى Firebase Assistant:

    1. انتقل إلى ملف> التحقق من وجود تحديثات للتأكد من أنك تستخدم أحدث إصدارات Android Studio ومساعد Firebase.

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

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

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

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

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

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

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

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



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

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

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

جافا

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

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

26.0.0
AdMob com.google.android.gms: play-services-ads 19.5.0
تحليلات com.google.firebase: firebase-analytics 18.0.0
فهرسة التطبيق com.google.firebase: firebase-appindexing 19.1.0
المصادقة com.google.firebase: firebase-auth 20.0.0
سحابة Firestore com.google.firebase: firebase-firestore 22.0.0
وظائف السحابة لـ Firebase Client SDK com.google.firebase: وظائف firebase 19.1.0
المراسلة السحابية com.google.firebase: firebase-messaging 21.0.0
سحابة التخزين com.google.firebase: firebase-storage 19.2.0
كراشليتيك com.google.firebase: firebase-crashlytics 17.2.2
روابط ديناميكية com.google.firebase: firebase-dynamic-links 19.1.1
واجهات برمجة تطبيقات 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.2
(مطلوب)
شاشة الرسائل داخل التطبيق com.google.firebase: firebase-inappmessaging-display 19.1.2
(مطلوب)
مراقبة الاداء com.google.firebase: firebase-perf 19.0.9
قاعدة بيانات الوقت الحقيقي com.google.firebase: firebase-database 19.5.1
التكوين عن بعد com.google.firebase: firebase-config 20.0.0
المكون الإضافي لخدمات Google Play com.google.gms: خدمات google 4.3.4
مكتبات مهملة
Firebase ML: نموذج تسمية الصور com.google.firebase: firebase-ml-vision-image-label-model 20.0.2
Firebase ML: نموذج الكشف عن الكائنات وتتبعها com.google.firebase: firebase-ml-vision-object-unlock-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 آخر
الإصدار
إضافة تحليلات؟
Firebase Android BoM
(فاتورة المواد)
com.google.firebase: firebase-bom

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

26.0.0
AdMob com.google.android.gms: play-services-ads 19.5.0
تحليلات com.google.firebase: firebase-analytics-ktx 18.0.0
فهرسة التطبيق com.google.firebase: firebase-appindexing 19.1.0
المصادقة com.google.firebase: firebase-auth-ktx 20.0.0
سحابة Firestore com.google.firebase: firebase-firestore-ktx 22.0.0
وظائف السحابة لـ Firebase Client SDK com.google.firebase: firebase-function-ktx 19.1.0
المراسلة السحابية com.google.firebase: firebase-messaging-ktx 21.0.0
سحابة التخزين com.google.firebase: firebase-storage-ktx 19.2.0
كراشليتيك com.google.firebase: firebase-crashlytics-ktx 17.2.2
روابط ديناميكية com.google.firebase: firebase-dynamic-links-ktx 19.1.1
واجهات برمجة تطبيقات 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.2
(مطلوب)
شاشة الرسائل داخل التطبيق com.google.firebase: firebase-inappmessaging-display-ktx 19.1.2
(مطلوب)
مراقبة الاداء com.google.firebase: firebase-perf-ktx 19.0.9
قاعدة بيانات الوقت الحقيقي com.google.firebase: firebase-database-ktx 19.5.1
التكوين عن بعد com.google.firebase: firebase-config-ktx 20.0.0
المكون الإضافي لخدمات Google Play com.google.gms: خدمات google 4.3.4
مكتبات مهملة
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: