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

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

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

  • يُرجى التأكّد من أنّ مشروعك يستوفي هذه المتطلبات (يُرجى العِلم أنّ بعض المنتجات قد تفرض متطلبات أكثر صرامة):

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

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


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

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



الخيار 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. (اختياري) أدخِل اسمًا مستعارًا للتطبيق، وهو معرّف داخلي مريح لا يظهر إلا لك في وحدة تحكّم Firebase.

  5. انقر على تسجيل التطبيق.

الخطوة 3: إضافة ملف إعداد Firebase

  1. نزِّل ملف إعداد Firebase الخاص بتطبيقك (google-services.json) ثم أضِفه إلى قاعدة الرموز البرمجية:

    1. انقر على تنزيل google-services.json للحصول على ملف إعدادات Firebase الخاص بتطبيقك.

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

  2. لإتاحة القيم في ملف إعداد google-services.json لحزم تطوير البرامج (SDK) في Firebase، تحتاج إلى المكوّن الإضافي Gradle لخدمات Google (google-services).

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

      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.6.0" 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.6.0' apply false
      }
    2. في ملف Gradle للوحدة (على مستوى التطبيق) (عادةً <project>/<app-module>/build.gradle.kts أو <project>/<app-module>/build.gradle)، أضِف المكوّن الإضافي 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:35.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.

    ‫Analytics غير مفعَّل

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

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

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

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



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

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

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

    • ‫Windows / Linux: مساعدة > البحث عن تحديثات
    • نظام التشغيل macOS‏: استوديو Android‏ > البحث عن تحديثات
  2. افتح مساعِد Firebase: الأدوات > Firebase.

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

    1. انقر على الربط بمنصة Firebase (Connect to Firebase) لربط مشروع Android بمنصة Firebase.

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

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

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

  6. يمكنك إضافة أي عدد تريده من منتجات Firebase الأخرى من خلال "مساعِد Firebase".

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

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



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

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

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

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

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

35.2.0
المكوّن الإضافي Gradle لخدمات Google com.google.gms:google-services 4.6.0
AdMob com.google.android.gms:play-services-ads 25.5.0
Firebase AI Logic 1 com.google.firebase:firebase-ai 18.2.0
Firebase AI Logic On-Device com.google.firebase:firebase-ai-ondevice 16.0.0-beta08
Firebase AI KSP com.google.firebase:firebase-ai-ksp-processor 17.0.0
Analytics com.google.firebase:firebase-analytics 24.0.0
مقدّم خدمة مخصّص واحد (App Check) com.google.firebase:firebase-appcheck 20.1.0
مقدّم خدمة تصحيح الأخطاء في App Check com.google.firebase:firebase-appcheck-debug 20.1.0
مقدّم خدمة Play Integrity واحد (App Check) com.google.firebase:firebase-appcheck-playintegrity 20.1.0
مقدّم خدمة App Check reCAPTCHA com.google.firebase:firebase-appcheck-recaptcha 20.1.0
App Distribution com.google.firebase:firebase-appdistribution 16.0.0-beta21
App Distribution API com.google.firebase:firebase-appdistribution-api 16.0.0-beta21
المكوّن الإضافي App Distribution com.google.firebase:firebase-appdistribution-gradle 5.3.1
Authentication com.google.firebase:firebase-auth 25.0.0
Cloud Firestore com.google.firebase:firebase-firestore 27.2.0
Cloud Functions for Firebase Client SDK com.google.firebase:firebase-functions 23.0.0
Cloud Messaging com.google.firebase:firebase-messaging 26.0.2
Cloud Storage com.google.firebase:firebase-storage 23.0.0
Crashlytics com.google.firebase:firebase-crashlytics 21.1.0
Crashlytics NDK com.google.firebase:firebase-crashlytics-ndk 21.1.0
المكوّن الإضافي Crashlytics com.google.firebase:firebase-crashlytics-gradle 3.0.8
إتاحة وحدة الميزات الديناميكية com.google.firebase:firebase-dynamic-module-support ‫16.0.0-beta05
In-App Messaging com.google.firebase:firebase-inappmessaging 23.0.0
(مطلوب)
In-App Messaging الشبكة الإعلانية com.google.firebase:firebase-inappmessaging-display 23.0.0
(مطلوب)
عمليات تثبيت بقيمة ‎Firebase com.google.firebase:firebase-installations 20.0.0
Performance Monitoring com.google.firebase:firebase-perf 23.0.1
المكوّن الإضافي Performance Monitoring com.google.firebase:perf-plugin 2.0.2
Firebase Phone Number Verification com.google.firebase:firebase-pnv 17.0.0
Realtime Database com.google.firebase:firebase-database 23.0.0
Remote Config com.google.firebase:firebase-config 24.0.1
SQL Connect 2 com.google.firebase:firebase-dataconnect 18.0.1
المكتبات المتوقفة نهائيًا أو غير المتوافقة
Dynamic Links com.google.firebase:firebase-dynamic-links 22.1.0

وحدات Firebase KTX - لم تعُد متاحة

Analytics لا تستخدِم هذه المكتبة لأنّ مكتبات وحدات KTX لم تعُد متاحة.
com.google.firebase:firebase-analytics-ktx
22.5.0
مقدّم خدمة مخصّص واحد (App Check) لا تستخدِم هذه المكتبة، لأنّ مكتبات وحدات KTX لم تعُد متاحة.
com.google.firebase:firebase-appcheck-ktx
18.0.0
App Distribution API لا تستخدِم هذه المكتبة، لأنّ مكتبات وحدات KTX لم تعُد متاحة.
com.google.firebase:firebase-appdistribution-api-ktx
16.0.0-beta15
Authentication لا تستخدِم هذه المكتبة، لأنّ مكتبات وحدات KTX لم تعُد متاحة.
com.google.firebase:firebase-auth-ktx
23.2.1
Cloud Firestore لا تستخدِم هذه المكتبة، لأنّ مكتبات وحدات KTX لم تعُد متاحة.
com.google.firebase:firebase-firestore-ktx
25.1.4
Cloud Functions for Firebase Client SDK يُرجى عدم استخدامها، لأنّ مكتبات وحدات KTX لم تعُد متاحة.
com.google.firebase:firebase-functions-ktx
21.2.1
Cloud Messaging لا تستخدِم هذه المكتبة، لأنّ مكتبات وحدات KTX لم تعُد متاحة.
com.google.firebase:firebase-messaging-ktx
24.1.2
Cloud Storage لا تستخدِم هذه المكتبة، لأنّ مكتبات وحدات KTX لم تعُد متاحة.
com.google.firebase:firebase-storage-ktx
21.0.2
Crashlytics لا تستخدِم هذه المكتبة لأنّ مكتبات وحدات KTX لم تعُد متاحة.
com.google.firebase:firebase-crashlytics-ktx
19.4.4
Dynamic Links لا تستخدِم هذه المكتبة، لأنّ مكتبات وحدات KTX لم تعُد متاحة.
com.google.firebase:firebase-dynamic-links-ktx
22.1.0
In-App Messaging لا تستخدِم هذه المكتبة، لأنّ مكتبات وحدات KTX لم تعُد متاحة.
com.google.firebase:firebase-inappmessaging-ktx
21.0.2
(مطلوب)
In-App Messaging الشبكة الإعلانية لا تستخدِم هذه المكتبة، لأنّ مكتبات وحدات KTX لم تعُد متاحة.
com.google.firebase:firebase-inappmessaging-display-ktx
21.0.2
(مطلوب)
عمليات تثبيت بقيمة ‎Firebase لا تستخدِم هذه المكتبة، لأنّ مكتبات وحدات KTX لم تعُد متاحة.
com.google.firebase:firebase-installations-ktx
18.0.0
واجهة برمجة التطبيقات Model Downloader API في Firebase ML لا تستخدِم هذه المكتبة، لأنّ مكتبات وحدات KTX لم تعُد متاحة.
com.google.firebase:firebase-ml-modeldownloader-ktx
25.0.1
Performance Monitoring يُرجى عدم استخدامها، لأنّ مكتبات وحدات KTX لم تعُد متاحة.
com.google.firebase:firebase-perf-ktx
21.0.5
Realtime Database لا تستخدِم هذه المكتبة، لأنّ مكتبات وحدات KTX لم تعُد متاحة.
com.google.firebase:firebase-database-ktx
21.0.0
Remote Config لا تستخدم هذه المكتبة، لأنّ مكتبات وحدات KTX لم تعُد متاحة.
com.google.firebase:firebase-config-ktx
22.1.2

مكتبات Firebase ML وحزمة Firebase ML

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

1 كانت "Firebase AI Logic" تُعرف سابقًا باسم "Vertex AI in Firebase" مع الحزمة com.google.firebase:firebase-vertexai.

2 كانت "Firebase SQL Connect" تُعرف سابقًا باسم "Firebase Data Connect".



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

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

  • يمكنك إنشاء ميزات مستندة إلى الذكاء الاصطناعي التوليدي باستخدام نماذج Gemini من خلال Firebase AI Logic.

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

  • إعداد مسار مصادقة المستخدم باستخدام Authentication

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

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

  • يمكنك تفعيل رمز الخلفية الذي يتم تشغيله في بيئة آمنة باستخدام Cloud Functions.

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

  • يمكنك معرفة وقت تعطُّل تطبيقك وسبب ذلك باستخدام Crashlytics.

مزيد من المعلومات عن Firebase: