إضافة 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:

إنشاء مشروع على Firebase

1. في وحدة تحكُّم Firebase، انقر على إضافة مشروع.

   • لإضافة موارد Firebase إلى مشروع Google Cloud حالي، أدخِل اسم المشروع أو حدده من القائمة المنسدلة.

   • لإنشاء مشروع جديد، أدخِل اسم المشروع المطلوب. يمكنك أيضًا اختيار تعديل رقم تعريف المشروع المعروض أسفل اسم المشروع.

2. راجِع بنود Firebase واقبلها إذا طُلب منك ذلك.

3. انقر على متابعة.

4. (اختياري) يمكنك إعداد Google Analytics لمشروعك، والتي تمكّنك من للحصول على أفضل تجربة باستخدام أيٍّ من منتجات Firebase التالية:

   Firebase Crashlytics Firebase Cloud Messaging

   Firebase In-App Messaging Firebase Remote Config

   تخصيص "Remote Config" Firebase A/B Testing

   يمكنك تحديد إما حساب Google Analytics أو إنشاء حساب جديد.

   إذا أنشأت حسابًا جديدًا، اختَر الإبلاغ عن موقع جغرافي واحد (Analytics)، ثم قبول إعدادات مشاركة البيانات وبنود Google Analytics لمشروعك.

5. انقر على إنشاء مشروع (أو إضافة Firebase إذا كنت تستخدم مشروع Google Cloud الحالي).

يوفّر Firebase تلقائيًا الموارد لمشروعك على Firebase. فعندما اكتمال العملية، سيتم توجيهك إلى صفحة النظرة العامة الخاصة بمنصة Firebase مشروع في وحدة تحكُّم "Firebase".

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

لاستخدام Firebase في تطبيق Android، يجب تسجيل تطبيقك في مشروع على Firebase. وعادةً ما يُطلق على تسجيل تطبيقك اسم "الإضافة". تطبيقك إلى مشروعك.

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

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

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

   ما هو اسم الحزمة، وأين تجده؟

   • حزمة اسم برنامج الاعتماد تطبيقك بشكلٍ فريد على الجهاز وفي "متجر Google Play".

   • غالبًا ما يُشار إلى اسم الحزمة باسم رقم تعريف التطبيق.

   • ابحث عن اسم حزمة التطبيق في ملف Gradle للوحدة (على مستوى التطبيق)، عادةً app/build.gradle (مثال على اسم الحزمة: com.yourcompany.yourproject).

   • يُرجى العلم أنّ قيمة اسم الحزمة حسّاسة لحالة الأحرف، ولا يمكن تم تغييرها لتطبيق Android هذا في Firebase بعد تسجيله في مشروع على Firebase.

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

   ما رأيك في اسم التطبيق و هل تريد استخدام شهادة توقيع تصحيح الأخطاء SHA-1 في Firebase؟

   • اسم التطبيق: معرّف داخلي وسهل الاستخدام مرئي لك في وحدة تحكُّم Firebase

   • شهادة توقيع تصحيح الأخطاء SHA-1: A SHA-1 تجزئة مطلوبة بحلول Firebase Authentication (عند استخدام تسجيل الدخول باستخدام حساب Google أو تسجيل الدخول باستخدام رقم الهاتف) Firebase Dynamic Links.

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

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

1. تنزيل ملف إعداد Firebase لنظام التشغيل Android ثم إضافته (google-services.json) إلى تطبيقك:

   1. انقر على تنزيل google-services.json للحصول على نظام التشغيل Firebase Android. config.

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

   ما الذي تحتاج إلى معرفته عن ملف الإعداد هذا؟

   • يحتوي ملف تهيئة Firebase على معرّفات فريدة ولكنها غير سرية لمشروعك. لمزيد من المعلومات حول ملف الإعداد هذا، انتقِل إلى فهم Firebase المشاريع:

   • يمكنك تنزيل إعدادات Firebase. ملف ومرة أخرى في أي وقت.

   • تأكد من عدم إلحاق اسم ملف التهيئة بأحرف إضافية، مثل (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

   هل يظهر لك خطأ إصدار بشأن استدعاء الدعم المخصّص والتفعيل؟ إزالة الأقلمة؟ سنطّلع على طريقة حلّ المشكلة.

   تحتاج إصدارات Gradle التي تستخدم الإصدار 4.2 من المكوّن الإضافي لنظام Gradle المتوافق مع Android (AGP) أو الإصدارات الأقدم إلى: تمكين دعم Java 8. وبخلاف ذلك، تحصل مشروعات Android هذه على إصدار تعذّر إتمام عملية إضافة حزمة تطوير البرامج (SDK) لمنصّة Firebase.

   لإصلاح تعذُّر هذا الإصدار، يمكنك اتّباع أحد الخيارَين التاليَين:

   • إضافة compileOptions المدرَج من رسالة الخطأ إلى ملف build.gradle.kts أو build.gradle على مستوى التطبيق.
   • يجب زيادة minSdk الخاصة بمشروع Android إلى 26 أو أعلى.

   مزيد من المعلومات حول تعذُّر تنفيذ هذا الإصدار في هذه الأسئلة الشائعة.

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

إذا كنت تواجه مشكلة في عملية الإعداد، يُرجى الانتقال إلى تحديد مشاكل 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.

      ما هي الإجراءات التي يؤديها سير العمل هذا؟

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

        إليك بعض النصائح حول إعداد مشروع Firebase:

        • اطّلِع على أفضل الممارسات لإضافة التطبيقات إلى مشروع Firebase، بما في ذلك كيفية التعامل مع متغيرات متعددة.

        • إذا أنشأت مشروعًا جديدًا، ننصحك بشدة بإعداد Google Analytics لمشروعك، مما يمكّنك من الحصول على للحصول على أفضل تجربة باستخدام العديد من منتجات Firebase.

      • يضيف سير العمل هذا أيضًا نظام Android الخاص بمشروعك على Firebase. ملف الإعداد (google-services.json) إلى الوحدة دليل تطبيقك (على مستوى التطبيق).

   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:

• انتقِل إلى مقالة فهم مشاريع Firebase للحصول على مزيد من المعلومات. حول مشاريع Firebase وأفضل الممارسات للمشروعات.

• انتقِل إلى مقالة مزيد من المعلومات حول Android وFirebase في حال: طرح أسئلة حول مفاهيم غير مألوفة أو خاصة بمنصة Firebase تطوير Android

• استكشاف المحتوى نماذج تطبيقات Firebase

• الحصول على تجربة عملية من خلال برنامج Firebase لنظام التشغيل Android درس تطبيقي حول الترميز:

• يمكنك الاطّلاع على مزيد من المعلومات من خلال دورة Firebase في عطلة نهاية الأسبوع.

• الاستعداد لإطلاق تطبيقك:

  • إعداد الميزانية تنبيهات لمشروعك في وحدة تحكم Google Cloud.
  • يمكنك مراقبة الاستخدام والفوترة لوحة البيانات في وحدة تحكم Firebase للحصول على صورة شاملة عبر خدمات Firebase المتعددة.
  • راجِع قائمة التحقّق الخاصة بإطلاق Firebase.

• هل تواجه مشكلة في Firebase ومشروع Android؟ انتقل إلى استكشاف أخطاء Android وإصلاحها الأسئلة الشائعة: