أضف Firebase إلى مشروع Android الخاص بك

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

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

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

  • يستهدف مستوى API 19 (KitKat) أو أعلى
  • يستخدم أندرويد 4.4 أو أعلى
  • يستخدم Jetpack (AndroidX) ، والذي يتضمن تلبية متطلبات الإصدار التالية:
    • com.android.tools.build:gradle v3.2.1 أو الأحدث
    • compileSdkVersion 28 أو الأحدث

• قم بإعداد جهاز فعلي أو استخدم محاكيًا لتشغيل تطبيقك.
  لاحظ أن حزم Firebase SDK التي تعتمد على خدمات Google Play تتطلب تثبيت خدمات Google Play على الجهاز أو المحاكي.

• قم بتسجيل الدخول إلى 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 ( plat_android ) أو إضافة تطبيق لبدء سير عمل الإعداد.

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

   ما هو اسم الحزمة وأين يمكن العثور عليه؟

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

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

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

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

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

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

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

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

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

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

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

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

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

   ما الذي تريد معرفته عن ملف التكوين هذا؟

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

   • يمكنك تنزيل ملف تهيئة Firebase مرة أخرى في أي وقت.

   • تأكد من عدم إلحاق اسم ملف التكوين بأحرف إضافية، مثل (2) .

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

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

      Kotlin

      plugins {
        id("com.android.application") version "7.2.0" apply false
        // ...
      
        // Add the dependency for the Google services Gradle plugin
        id("com.google.gms.google-services") version "4.3.15" apply false
      }
      

      Groovy

      plugins {
        id 'com.android.application' version '7.2.0' apply false
        // ...
      
        // Add the dependency for the Google services Gradle plugin
        id 'com.google.gms.google-services' version '4.3.15' 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 : أضف حزم Firebase SDK إلى تطبيقك

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

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

   Kotlin+KTX

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

   Java

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

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

   Java

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

   هل تواجه فشلًا في البناء بشأن دعم الاستدعاء المخصص وتمكين إزالة السكر؟ وإليك كيفية اصلاحها.

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

   لإصلاح فشل البناء هذا، يمكنك اتباع أحد الخيارين:

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

   تعرف على المزيد حول فشل البناء هذا في هذه الأسئلة الشائعة .

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

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

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

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

1. افتح مشروع Android الخاص بك في Android Studio، ثم تأكد من أنك تستخدم أحدث إصدارات Android Studio وFirebase Assistant:

   • Windows / Linux: تعليمات > التحقق من وجود تحديثات
   • نظام التشغيل MacOS: Android Studio > التحقق من وجود تحديثات

2. افتح مساعد Firebase: الأدوات > Firebase .

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

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

      ماذا يفعل سير العمل هذا؟

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

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

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

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

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

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

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

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

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

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

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

المكتبات المتوفرة

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

• الوثائق المرجعية ( Kotlin+KTX | Java )

• Firebase Android SDK GitHub repo

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

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

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

• احصل على رؤى حول سلوك المستخدم باستخدام Analytics .

• قم بإعداد تدفق مصادقة المستخدم باستخدام المصادقة .

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

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

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

• إرسال الإخطارات مع خدمة المراسلة السحابية .

• اكتشف متى ولماذا يتعطل تطبيقك مع Crashlytics .

تعرف على Firebase:

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

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

• استكشف نماذج من تطبيقات Firebase .

• احصل على خبرة عملية مع Firebase Android Codelab .

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

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

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

• هل تواجه مشكلة مع Firebase ومشروع Android الخاص بك؟ تفضل بزيارة استكشاف أخطاء Android وإصلاحها والأسئلة الشائعة .