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

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

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

  • تأكد من أن مشروعك يلبي هذه المتطلبات (لاحظ أن بعض المنتجات متطلبات أكثر صرامة):

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

  • سجّل الدخول إلى Firebase باستخدام حسابك الحساب.

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


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

  • الخيار 1: (ننصح به) استخدِم Firebase عملية إعداد وحدة التحكّم
  • الخيار 2: استخدام "استوديو Android" على Firebase "مساعد Google" (قد يتطلّب ذلك ضبط إعدادات إضافية)



الخيار 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. config.

    2. انقِل ملف الإعداد إلى الدليل الجذري للوحدة (على مستوى التطبيق) تطبيقك.

  2. لإتاحة الوصول إلى القيم في ملف إعداد google-services.json بحزم تطوير البرامج (SDK) لمنصّة Firebase، ستحتاج إلى مكوّن Gradle لخدمات Google (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.2" 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.2' 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: إضافة حِزم تطوير البرامج (SDK) لمنصة Firebase إلى تطبيقك

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

    تم تفعيل Analytics.

    dependencies {
      // ...
    
      // Import the Firebase BoM
      implementation(platform("com.google.firebase:firebase-bom:33.2.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. تعتمد على وحدة المكتبة الرئيسية (لمزيد من التفاصيل، راجع الأسئلة الشائعة حول هذه المبادرة).

    لم يتم تفعيل Analytics

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

يسجِّل مساعد Firebase لتطبيقك بمشروع Firebase وإضافة ملفات Firebase والمكوّنات الإضافية اللازمة ومعلومات عن مشروعك على Android، كل ذلك من داخل "استوديو Android".

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

    • Windows / Linux: مساعدة > البحث عن تحديثات
    • macOS: Android Studio > البحث عن تحديثات
  2. افتح "مساعد Firebase": الأدوات >. Firebase:

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

    1. انقر على الربط بمنصة Firebase لربط مشروع Android بمنصّة Firebase.

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

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

  5. في لوحة مساعد Google، اتّبِع تعليمات الإعداد المتبقية منتج Firebase الذي اخترته.

  6. يمكنك إضافة العدد الذي تريده من منتجات Firebase من خلال Firebase. مساعد Google!

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

إذا كنت تواجه مشكلة في عملية الإعداد، يُرجى الانتقال إلى تحديد مشاكل Android وحلّها الأسئلة الشائعة:



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

يسرد هذا القسم منتجات Firebase المتوافقة مع Android وأجهزة Gradle المرتبطة بها. والتبعيات لديك. اطّلِع على المزيد من المعلومات عن مكتبات Android التالية من Firebase:

  • المستندات المرجعية (Kotlin+KTX | Java)

  • حزمة تطوير البرامج (SDK) لنظام التشغيل Android لمنصة Firebase مستودع GitHub

يُرجى العِلم أنّه عند استخدام Firebase Android BoM، لا يمكنك تحديد إصدارات مكتبة فردية عند الإعلان عن مكتبة Firebase. والتبعيات في ملف تهيئة إصدار Gradle.

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

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

33.2
AdMob com.google.android.gms:play-services-ads 23.3.0
Analytics com.google.firebase:firebase-analytics 22.1.0
مقدّم خدمة مخصّص واحد (App Check) com.google.firebase:firebase-appcheck 18.0.0
موفِّر تصحيح أخطاء App Check com.google.firebase:firebase-appcheck-debug 18.0.0
App Check مقدِّم خدمة Play Integrity com.google.firebase:firebase-appcheck-playintegrity 18.0.0
App Distribution com.google.firebase:firebase-appdistribution الإصدار التجريبي 16.0.0-13
واجهة برمجة تطبيقات App Distribution com.google.firebase:firebase-appdistribution-api الإصدار التجريبي 16.0.0-13
المكوّن الإضافي "App Distribution" com.google.firebase:firebase-appdistribution-gradle 5.0.0
Authentication com.google.firebase:firebase-auth 23.0.0
Cloud Firestore com.google.firebase:firebase-firestore 25.1
Cloud Functions for Firebase Client SDK com.google.firebase:دوال firebase 21.0.0
Cloud Messaging com.google.firebase:firebase-messaging 24.0.1
Cloud Storage com.google.firebase:firebase-storage 21.0.0
Crashlytics com.google.firebase:firebase-crashlytics 19.0.3
Crashlytics NDK com.google.firebase:firebase-crashlytics-ndk 19.0.3
المكوّن الإضافي "Crashlytics" com.google.firebase:firebase-crashlytics-gradle 3.0.2
دعم وحدات الميزات الديناميكية com.google.firebase:firebase-dynamic-module-support 16.0.0-تجريبي03
Dynamic Links com.google.firebase:firebase-dynamic-links 22.1.0
In-App Messaging com.google.firebase:firebase-inappmessaging 21.0.0
(مطلوب)
شبكة In-App Messaging الإعلانية com.google.firebase:firebase-inappmessaging-display 21.0.0
(مطلوب)
Firebase عملية تثبيت com.google.firebase:firebase-installations 18.0.0
واجهة برمجة تطبيقات أداة تنزيل النماذج Firebase ML com.google.firebase:firebase-ml-modeldownloader 25.0.0
Performance Monitoring com.google.firebase:firebase-perf 21.0.1
المكوّن الإضافي "Performance Monitoring" com.google.firebase:perf-plugin 1.4.2
Realtime Database com.google.firebase:firebase-database 21.0.0
Remote Config com.google.firebase:firebase-config 22.0.0
Vertex AI in Firebase com.google.firebase:firebase-vertexai الإصدارات التجريبية 16.0.0-beta04
المكوّن الإضافي "خدمات Google Play" com.google.gms:google-services 4.4.2
المكتبات التي تم إيقافها نهائيًا
مزوِّد خدمة SafetyNet (App Check) com.google.firebase:firebase-appcheck-safetynet 16.1.2
App Indexing com.google.firebase:firebase-appindexing 20.0.0

وحدات KTX من Firebase

Analytics com.google.firebase:firebase-analytics-ktx 22.1.0
مقدّم خدمة مخصّص واحد (App Check) com.google.firebase:firebase-appcheck-ktx 18.0.0
واجهة برمجة تطبيقات App Distribution com.google.firebase:firebase-appdistribution-api-ktx الإصدار التجريبي 16.0.0-13
Authentication com.google.firebase:firebase-auth-ktx 23.0.0
Cloud Firestore com.google.firebase:firebase-firestore-ktx 25.1
Cloud Functions for Firebase Client SDK com.google.firebase:firebase-functions-ktx 21.0.0
Cloud Messaging com.google.firebase:firebase-messaging-ktx 24.0.1
Cloud Storage com.google.firebase:firebase-storage-ktx 21.0.0
Crashlytics com.google.firebase:firebase-crashlytics-ktx 19.0.3
Dynamic Links com.google.firebase:firebase-dynamic-links-ktx 22.1.0
In-App Messaging com.google.firebase:firebase-inappmessaging-ktx 21.0.0
(مطلوب)
شبكة In-App Messaging الإعلانية com.google.firebase:firebase-inappmessaging-display-ktx 21.0.0
(مطلوب)
Firebase عملية تثبيت com.google.firebase:firebase-installations-ktx 18.0.0
واجهة برمجة تطبيقات أداة تنزيل النماذج Firebase ML com.google.firebase:firebase-ml-modeldownloader-ktx 25.0.0
Performance Monitoring com.google.firebase:firebase-perf-ktx 21.0.1
Realtime Database com.google.firebase:firebase-database-ktx 21.0.0
Remote Config com.google.firebase:firebase-config-ktx 22.0.0

مكتبات حزمة تعلُّم الآلة من Firebase

واجهات برمجة تطبيقات النماذج المخصّصة Firebase ML com.google.firebase:firebase-ml-model-interpreter 22.0.4
واجهات برمجة تطبيقات Vision Firebase ML com.google.firebase:firebase-ml-vision 24 نوفمبر
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-reply-model 20.0.8



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

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

  • احصل على إحصاءات عن سلوك المستخدم من خلال Analytics

  • يمكنك إعداد تدفق مصادقة المستخدم باستخدام Authentication

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

  • يمكنك تخزين الملفات، مثل الصور والفيديوهات، باستخدام Cloud Storage

  • يؤدي هذا الإجراء إلى تشغيل رمز الخلفية الذي يتم تشغيله في بيئة آمنة باستخدام Cloud Functions

  • إرسال الإشعارات باستخدام Cloud Messaging

  • التعرّف على وقت وأسباب تعطُّل تطبيقك Crashlytics

تعرَّف على Firebase: