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

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

إذا لم يكن لديك بالفعل مشروع الروبوت ونريد فقط أن يجرب منتج 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. في وسط الصفحة نظرة عامة المشروع، انقر فوق رمز الروبوت ( ) أو اضافة التطبيق لإطلاق سير العمل الإعداد.

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

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

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

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

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

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

    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.8'  // 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:28.3.0')
    
      // 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:28.3.0')
    
      // 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:28.3.0')
    
      // 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:28.3.0')
    
      // 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. قم بمزامنة تطبيقك للتأكد من أن جميع التبعيات لها الإصدارات الضرورية.

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

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



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

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

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

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

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

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

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

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

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

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

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

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



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

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

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

جافا

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

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

28.3.0
AdMob com.google.android.gms: play-services-ads 20.2.0
تحليلات com.google.firebase: firebase-analytics 19.0.0
التطبيق تحقق مزود مخصص com.google.firebase: firebase-appcheck 16.0.0 بيتا 02
مزود التصحيح App Check com.google.firebase: firebase-appcheck-debug 16.0.0 بيتا 02
مزود التطبيق تحقق SafetyNet com.google.firebase: firebase-appcheck-safetynet 16.0.0 بيتا 02
البرنامج المساعد لتوزيع التطبيقات com.google.firebase: firebase-appdistribution-gradle 2.1.3
فهرسة التطبيق com.google.firebase: firebase-appindexing 20.0.0
المصادقة com.google.firebase: firebase-auth 21.0.1
سحابة Firestore com.google.firebase: firebase-firestore 23.0.3
وظائف السحابة لـ Firebase Client SDK com.google.firebase: وظائف firebase 20.0.0
المراسلة السحابية com.google.firebase: firebase-messaging 22.0.0
سحابة التخزين com.google.firebase: firebase-storage 20.0.0
Crashlytics com.google.firebase: firebase-crashlytics 18.2.0
Crashlytics NDK com.google.firebase: firebase-crashlytics-ndk 18.2.0
البرنامج المساعد Crashlytics com.google.firebase: firebase-crashlytics-gradle 2.7.1
دعم وحدة الميزة الديناميكية com.google.firebase: firebase-dynamic-module-support 16.0.0 بيتا 01
روابط ديناميكية com.google.firebase: firebase-dynamic-links 20.1.1
المراسلة داخل التطبيق com.google.firebase: firebase-inappmessaging 20.0.0
(مطلوب)
شاشة الرسائل داخل التطبيق com.google.firebase: firebase-inappmessaging-display 20.0.0
(مطلوب)
منشآت Firebase com.google.firebase: firebase-Installation 17.0.0
واجهة برمجة تطبيقات Firebase ML Model Downloader com.google.firebase: firebase-ml-modeldownloader 24.0.0
مراقبة الاداء com.google.firebase: firebase-perf 20.0.2
البرنامج المساعد لمراقبة الأداء com.google.firebase: perf-plugin 1.4.0
قاعدة بيانات الوقت الفعلي com.google.firebase: firebase-database 20.0.1
التكوين عن بعد com.google.firebase: firebase-config 21.0.0
المكون الإضافي لخدمات Google Play com.google.gms: خدمات google 4.3.8
مكتبات مهجورة
واجهات برمجة التطبيقات للنموذج المخصص لـ Firebase ML com.google.firebase: firebase-ml-model-interpreter 22.0.4
واجهات برمجة تطبيقات Firebase ML Vision 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-response-model 20.0.8

Kotlin + KTX

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

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

28.3.0
AdMob com.google.android.gms: play-services-ads 20.2.0
تحليلات com.google.firebase: firebase-analytics-ktx 19.0.0
التطبيق تحقق مزود مخصص com.google.firebase: firebase-appcheck 16.0.0 بيتا 02
مزود التصحيح App Check com.google.firebase: firebase-appcheck-debug 16.0.0 بيتا 02
مزود التطبيق تحقق SafetyNet com.google.firebase: firebase-appcheck-safetynet 16.0.0 بيتا 02
البرنامج المساعد لتوزيع التطبيقات com.google.firebase: firebase-appdistribution-gradle 2.1.3
فهرسة التطبيق com.google.firebase: firebase-appindexing 20.0.0
المصادقة com.google.firebase: firebase-auth-ktx 21.0.1
سحابة Firestore com.google.firebase: firebase-firestore-ktx 23.0.3
وظائف السحابة لـ Firebase Client SDK com.google.firebase: firebase-function-ktx 20.0.0
المراسلة السحابية com.google.firebase: firebase-messaging-ktx 22.0.0
سحابة التخزين com.google.firebase: firebase-storage-ktx 20.0.0
Crashlytics com.google.firebase: firebase-crashlytics-ktx 18.2.0
Crashlytics NDK com.google.firebase: firebase-crashlytics-ndk 18.2.0
البرنامج المساعد Crashlytics com.google.firebase: firebase-crashlytics-gradle 2.7.1
دعم وحدة الميزة الديناميكية com.google.firebase: firebase-dynamic-module-support 16.0.0 بيتا 01
روابط ديناميكية com.google.firebase: firebase-dynamic-links-ktx 20.1.1
المراسلة داخل التطبيق com.google.firebase: firebase-inappmessaging-ktx 20.0.0
(مطلوب)
شاشة الرسائل داخل التطبيق com.google.firebase: firebase-inappmessaging-display-ktx 20.0.0
(مطلوب)
منشآت Firebase com.google.firebase: firebase-Installation-ktx 17.0.0
واجهة برمجة تطبيقات Firebase ML Model Downloader com.google.firebase: firebase-ml-modeldownloader-ktx 24.0.0
مراقبة الاداء com.google.firebase: firebase-perf-ktx 20.0.2
البرنامج المساعد لمراقبة الأداء com.google.firebase: perf-plugin 1.4.0
قاعدة بيانات الوقت الحقيقي com.google.firebase: firebase-database-ktx 20.0.1
التكوين عن بعد com.google.firebase: firebase-config-ktx 21.0.0
المكون الإضافي لخدمات Google Play com.google.gms: خدمات google 4.3.8
مكتبات مهجورة
واجهات برمجة التطبيقات للنموذج المخصص لـ Firebase ML com.google.firebase: firebase-ml-model-interpreter 22.0.4
واجهات برمجة تطبيقات Firebase ML Vision 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-response-model 20.0.8



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

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

تعرف على Firebase: