Google is committed to advancing racial equity for Black communities. See how.
ترجمت واجهة Cloud Translation API‏ هذه الصفحة.
Switch to English

أضف Firebase إلى مشروع Android

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

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

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

    • يستهدف مستوى API 16 (جيلي بين) أو أحدث
    • يستخدم Gradle 4.1 أو أحدث
    • يستخدم Jetpack (AndroidX) ، والذي يتضمن تلبية متطلبات الإصدار هذه:
      • com.android.tools.build:gradle 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. تفضل بزيارة Understand Firebase Projects لمعرفة المزيد حول مشروعات Firebase.

الخطوة 2 : تسجيل تطبيقك باستخدام Firebase

بعد أن يكون لديك مشروع Firebase ، يمكنك إضافة تطبيق Android إليه.

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

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

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

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

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

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

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

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

  1. أضف ملف تكوين Firebase Android إلى تطبيقك:

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

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

  2. لتمكين منتجات Firebase في تطبيقك ، أضف المكوّن الإضافي google-services إلى ملفات 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 التي تريد استخدامها في تطبيقك.

    تم تمكين Analytics

    dependencies {
      // ...
    
      // Add the Firebase SDK for Google Analytics
      implementation 'com.google.firebase:firebase-analytics:17.4.4'
    
      // Add the dependencies for any other Firebase products you want to use in your app
      // For example, to also use Firebase Authentication
      implementation 'com.google.firebase:firebase-auth:19.3.2'
    
      // Getting a "Could not find" error? Make sure that you've added
      // Google's Maven repository to your root-level build.gradle file
    }
    

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

    dependencies {
      // ...
    
      // Add the dependencies for the Firebase products you want to use in your app
      // For example, to use Firebase Authentication
      implementation 'com.google.firebase:firebase-auth:19.3.2'
    
      // Getting a "Could not find" error? Make sure that you've added
      // Google's Maven repository to your root-level build.gradle file
    }
    
  2. قم بمزامنة تطبيقك للتأكد من أن جميع التبعيات لها الإصدارات اللازمة.

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

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

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

الخيار 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 ، انقر فوق الزر لإضافة تبعية المكتبة لمنتج Firebase الذي اخترته (على سبيل المثال ، إضافة تحليلات إلى تطبيقك ).

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

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

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

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

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

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

التحكم في إصدارات المكتبة باستخدام قائمة مواد Firebase (BoM)

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

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

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

جافا

الخدمة أو المنتج تبعيات Gradle إضافة تحليلات؟
AdMob com.google.android.gms: play-services-ads: 19.3.0
تحليلات com.google.firebase: firebase-analytics: 17.4.4
فهرسة التطبيقات com.google.firebase: firebase-appindexing: 19.1.0
المصادقة com.google.firebase: firebase-auth: 19.3.2
سحابة Firestore com.google.firebase: firebase-firestore: 21.5.0
الوظائف السحابية لـ Firebase Client SDK com.google.firebase: وظائف Firebase: 19.0.2
المراسلة السحابية com.google.firebase: Firebase-messaging: 20.2.4
سحابة التخزين com.google.firebase: تخزين Firebase: 19.1.1
الكراشلي com.google.firebase: firebase-crashlytics: 17.1.1
روابط ديناميكية com.google.firebase: روابط Firebase-dynamic-links: 19.1.0
واجهات برمجة تطبيقات Firebase ML Vision com.google.firebase: firebase-ml-vision: 24.0.3
Firebase ML Custom API APIs com.google.firebase: firebase-ml-model-translator: 22.0.3
المراسلة داخل التطبيق com.google.firebase: Firebase-inappmessaging: 19.1.0
(مطلوب)
عرض الرسائل داخل التطبيق com.google.firebase: firebase-inappmessaging-display: 19.1.0
(مطلوب)
مراقبة الاداء com.google.firebase: firebase-perf: 19.0.8
قاعدة بيانات الوقت الحقيقي com.google.firebase: قاعدة بيانات Firebase: 19.3.1
التكوين عن بعد com.google.firebase: firebase-config: 19.2.0
قائمة مواد Firebase (BoM) com.google.firebase: firebase-bom: 25.7.0

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

المكوّن الإضافي لخدمات Google Play com.google.gms: google-services: 4.3.3
مكتبات موقوفة
Firebase ML: نموذج وضع العلامات على الصور com.google.firebase: firebase-ml-vision-image-label-label: 20.0.1
Firebase ML: نموذج الكشف عن الكائنات وتتبعها com.google.firebase: firebase-ml-vision-object -كشف عن كائن: 19.0.5
Firebase ML: نموذج كشف الوجه com.google.firebase: firebase-ml-vision-face-model: 20.0.1
Firebase ML: نموذج مسح الباركود com.google.firebase: firebase-ml-vision-barcode-model: 16.1.1
Firebase ML: واجهة برمجة تطبيقات AutoML Vision Edge com.google.firebase: firebase-ml-vision-automl: 18.0.5
Firebase ML: واجهات برمجة التطبيقات للغة الطبيعية com.google.firebase: Firebase-ml-natural-language: 22.0.0
Firebase ML: نموذج تعريف اللغة com.google.firebase: firebase-ml-natural-language-language-language-id-model: 20.0.7
Firebase ML: ترجمة النموذج com.google.firebase: firebase-ml-natural-language-translate-model: 20.0.8
Firebase ML: نموذج الرد الذكي com.google.firebase: firebase-ml-natural-language-smart-reply-model: 20.0.7

Kotlin + KTX

الخدمة أو المنتج تبعيات Gradle إضافة تحليلات؟
AdMob com.google.android.gms: play-services-ads: 19.3.0
تحليلات com.google.firebase: firebase-analytics-ktx: 17.4.4
فهرسة التطبيقات com.google.firebase: firebase-appindexing: 19.1.0
المصادقة com.google.firebase: firebase-auth-ktx: 19.3.2
سحابة Firestore com.google.firebase: firebase-firestore-ktx: 21.5.0
الوظائف السحابية لـ Firebase Client SDK com.google.firebase: firebase-function-ktx: 19.0.2
المراسلة السحابية com.google.firebase: Firebase-messaging: 20.2.4
سحابة التخزين com.google.firebase: firebase-storage-ktx: 19.1.1
الكراشلي com.google.firebase: firebase-crashlytics: 17.1.1
روابط ديناميكية com.google.firebase: firebase-dynamic-links-ktx: 19.1.0
واجهات برمجة تطبيقات Firebase ML Vision com.google.firebase: firebase-ml-vision: 24.0.3
Firebase ML Custom API APIs com.google.firebase: firebase-ml-model-translator: 22.0.3
المراسلة داخل التطبيق com.google.firebase: firebase-inappmessaging-ktx: 19.1.0
(مطلوب)
عرض الرسائل داخل التطبيق com.google.firebase: firebase-inappmessaging-display-ktx: 19.1.0
(مطلوب)
مراقبة الاداء com.google.firebase: firebase-perf: 19.0.8
قاعدة بيانات الوقت الحقيقي com.google.firebase: firebase-database-ktx: 19.3.1
التكوين عن بعد com.google.firebase: firebase-config-ktx: 19.2.0
قائمة مواد Firebase (BoM) com.google.firebase: firebase-bom: 25.7.0

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

المكوّن الإضافي لخدمات Google Play com.google.gms: google-services: 4.3.3
مكتبات موقوفة
Firebase ML: نموذج وضع العلامات على الصور com.google.firebase: firebase-ml-vision-image-label-label: 20.0.1
Firebase ML: نموذج الكشف عن الكائنات وتتبعها com.google.firebase: نموذج Firebase-ml-vision-object -كشف عن الكائنات: 19.0.5
Firebase ML: نموذج كشف الوجه com.google.firebase: firebase-ml-vision-face-model: 20.0.1
Firebase ML: نموذج مسح الباركود com.google.firebase: firebase-ml-vision-barcode-model: 16.1.1
Firebase ML: واجهة برمجة تطبيقات AutoML Vision Edge com.google.firebase: firebase-ml-vision-automl: 18.0.5
Firebase ML: واجهات برمجة التطبيقات للغة الطبيعية com.google.firebase: Firebase-ml-natural-language: 22.0.0
Firebase ML: نموذج تعريف اللغة com.google.firebase: firebase-ml-natural-language-language-language-id-model: 20.0.7
Firebase ML: ترجمة النموذج com.google.firebase: firebase-ml-natural-language-translate-model: 20.0.8
Firebase ML: نموذج الرد الذكي com.google.firebase: firebase-ml-natural-language-smart-reply-model: 20.0.7

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

تعرّف على Firebase:

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