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

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

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

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

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

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

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

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

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

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

الخيار 1: إضافة Firebase باستخدام وحدة تحكم Firebase

مضيفا Firebase إلى التطبيق الخاص بك يتضمن المهام سواء في وحدة التحكم Firebase وفي مشروع الروبوت مفتوحة (على سبيل المثال، يمكنك تحميل ملفات التكوين Firebase من وحدة التحكم، ثم نقلها إلى مشروع Android).

الخطوة 1: إنشاء مشروع Firebase

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

1. أضف ملف تهيئة Firebase Android إلى تطبيقك:

   1. انقر فوق تحميل جوجل-services.json للحصول على ملف التكوين Firebase الروبوت الخاص بك ( google-services.json ).

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

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

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

   • يمكنك تحميل الخاص بك ملف التكوين Firebase مرة أخرى في أي وقت.

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

2. لتمكين المنتجات Firebase في التطبيق الخاص بك، إضافة الخدمات جوجل المساعد لملفات Gradle الخاص بك.

   1. في الخاص على مستوى الجذر (على مستوى المشاريع) ملف Gradle ( build.gradle )، إضافة قواعد لتشمل المساعد جوجل خدمات 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.10'  // 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 )، وتطبيق البرنامج المساعد جوجل خدمات Gradle:

      apply plugin: 'com.android.application'
      // Add the following line:
      apply plugin: 'com.google.gms.google-services'  // Google Services plugin
      
      android {
        // ...
      }
      

الخطوة 4: إضافة Firebase تطوير البرامج في تطبيقك

1. باستخدام Firebase الروبوت بوم ، أن يعلن تبعيات لل منتجات Firebase التي تريد استخدامها في التطبيق الخاص بك. أعلن لهم في الوحدة النمطية الخاصة بك (على مستوى التطبيق) ملف Gradle (عادة app/build.gradle ).

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

   جافا

   dependencies {
     // ...
   
     // Import the Firebase BoM
     implementation platform('com.google.firebase:firebase-bom:29.0.1')
   
     // When using the BoM, you don't specify versions in Firebase library dependencies
   
     // Declare the dependency for the Firebase SDK for Google Analytics
     implementation 'com.google.firebase:firebase-analytics'
   
     // Declare the dependencies for any other desired Firebase products
     // For example, declare the dependencies for Firebase Authentication and Cloud Firestore
     implementation 'com.google.firebase:firebase-auth'
     implementation 'com.google.firebase:firebase-firestore'
   }
   

   Kotlin + KTX

   dependencies {
     // ...
   
     // Import the Firebase BoM
     implementation platform('com.google.firebase:firebase-bom:29.0.1')
   
     // When using the BoM, you don't specify versions in Firebase library dependencies
   
     // Declare the dependency for the Firebase SDK for Google Analytics
     implementation 'com.google.firebase:firebase-analytics-ktx'
   
     // Declare the dependencies for any other desired Firebase products
     // For example, declare the dependencies for Firebase Authentication and Cloud Firestore
     implementation 'com.google.firebase:firebase-auth-ktx'
     implementation 'com.google.firebase:firebase-firestore-ktx'
   }
   

   باستخدام Firebase الروبوت بوم ، والتطبيق دائما استخدام إصدارات متوافقة من المكتبات Firebase الروبوت.

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

   جافا

   dependencies {
     // ...
   
     // Import the Firebase BoM
     implementation platform('com.google.firebase:firebase-bom:29.0.1')
   
     // When using the BoM, you don't specify versions in Firebase library dependencies
   
     // Declare the dependencies for the desired Firebase products
     // For example, declare the dependencies for Firebase Authentication and Cloud Firestore
     implementation 'com.google.firebase:firebase-auth'
     implementation 'com.google.firebase:firebase-firestore'
   }
   

   Kotlin + KTX

   dependencies {
     // ...
   
     // Import the Firebase BoM
     implementation platform('com.google.firebase:firebase-bom:29.0.1')
   
     // When using the BoM, you don't specify versions in Firebase library dependencies
   
     // Declare the dependencies for the desired Firebase products
     // For example, declare the dependencies for Firebase Authentication and Cloud Firestore
     implementation 'com.google.firebase:firebase-auth-ktx'
     implementation 'com.google.firebase:firebase-firestore-ktx'
   }
   

   باستخدام Firebase الروبوت بوم ، والتطبيق دائما استخدام إصدارات متوافقة من المكتبات Firebase الروبوت.

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

   الحصول على فشل بناء حول استدعاء الدعم المخصص وتمكين desugaring؟ إليك كيفية إصلاحه.

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

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

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

   معرفة المزيد عن هذا الفشل في بناء هذه التعليمات .

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

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

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

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

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

   • ويندوز / لينكس: المساعدة> البحث عن تحديثات
   • ماك: الروبوت ستوديو> البحث عن تحديثات

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

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

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

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

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

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

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

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

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

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

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

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

6. أضف أي عدد تريده من منتجات Firebase عبر مساعد Firebase!

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

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

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

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

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

• Firebase أندرويد SDK جيثب الريبو

لاحظ أنه عند استخدام Firebase الروبوت بوم ، لم تقم بتحديد إصدارات مكتبة الفردية عندما تقوم بتعريف تبعيات مكتبة Firebase في build.gradle .

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

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

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

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

• تخزين البيانات، مثل معلومات المستخدم، مع سحابة Firestore أو قاعدة البيانات في الوقت الحقيقي .

• تخزين الملفات، مثل الصور والفيديو، مع سحابة التخزين .

• كود الزناد الخلفية التي يتم تشغيلها في بيئة آمنة مع وظائف الغيمة .

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

• معرفة متى ولماذا التطبيق الخاص بك هو تحطمها مع Crashlytics .

تعرف على Firebase:

• زيارة فهم مشاريع Firebase لمعرفة المزيد عن مشاريع Firebase وأفضل الممارسات للمشاريع.

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

• استكشاف التطبيقات Firebase عينة .

• الحصول على خبرة مع Firebase الروبوت Codelab .

• تعلم أكثر مع Firebase في نهاية الأسبوع بالطبع.

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

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

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