المتطلبات الأساسية
قم بتثبيت أو تحديث Android Studio إلى أحدث إصدار.
تأكد من أن مشروعك يلبي هذه المتطلبات:
- تستهدف مستوى API 19 (KitKat) أو أعلى
- يستخدم Android 4.4 أو أعلى
- يستخدم Jetpack (AndroidX) ، والذي يتضمن تلبية متطلبات الإصدار التالية:
-
com.android.tools.build:gradle
v3.2.1 أو أحدث -
compileSdkVersion
28 أو أحدث
-
قم بإعداد جهاز مادي أو استخدام محاكي لتشغيل تطبيقك.
لاحظ أن Firebase SDKs التي تعتمد على خدمات 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. غالبًا ما يسمى تسجيل تطبيقك "إضافة" تطبيقك إلى مشروعك.
انتقل إلى وحدة تحكم Firebase .
في وسط صفحة نظرة عامة على المشروع ، انقر فوق رمز Android (
) أو إضافة تطبيق لبدء سير عمل الإعداد.أدخل اسم حزمة تطبيقك في حقل اسم حزمة Android .
يعرّف اسم الحزمة بشكل فريد تطبيقك على الجهاز وفي متجر Google Play.
غالبًا ما يشار إلى اسم الحزمة باسم معرف التطبيق .
ابحث عن اسم حزمة تطبيقك في ملف Gradle (على مستوى التطبيق) للوحدة النمطية الخاصة بك ، وعادةً ما يكون
app/build.gradle
(مثال على اسم الحزمة:com.yourcompany.yourproject
).اعلم أن قيمة اسم الحزمة حساسة لحالة الأحرف ، ولا يمكن تغييرها لتطبيق Firebase Android هذا بعد تسجيله في مشروع Firebase.
(اختياري) أدخل معلومات التطبيق الأخرى: لقب التطبيق وشهادة توقيع تصحيح الأخطاء SHA-1 .
لقب التطبيق : معرّف داخلي ملائم يكون مرئيًا لك فقط في وحدة تحكم Firebase
شهادة توقيع تصحيح الأخطاء SHA-1 : مطلوب تجزئة SHA-1 بواسطة مصادقة Firebase (عند استخدام تسجيل الدخول إلى Google أو تسجيل الدخول برقم الهاتف ) و Firebase Dynamic Links .
انقر فوق تسجيل التطبيق .
الخطوة 3 : أضف ملف تكوين Firebase
أضف ملف تهيئة Firebase Android إلى تطبيقك:
انقر فوق تنزيل google-services.json للحصول على ملف تهيئة Firebase Android (
).google-services.json انقل ملف التكوين الخاص بك إلى دليل الوحدة النمطية (مستوى التطبيق) لتطبيقك.
يحتوي ملف تهيئة Firebase على معرّفات فريدة ولكنها غير سرية لمشروعك. لمعرفة المزيد حول ملف التكوين هذا ، تفضل بزيارة فهم مشاريع Firebase .
يمكنك تنزيل ملف تهيئة Firebase مرة أخرى في أي وقت.
تأكد من عدم إلحاق اسم ملف التكوين بأحرف إضافية ، مثل
(2)
.
لتمكين منتجات Firebase في تطبيقك ، أضف المكوِّن الإضافي لخدمات google إلى ملفات Gradle.
في ملف Gradle على مستوى الجذر (على مستوى المشروع) (
build.gradle
) ، أضف قواعد لتضمين المكوّن الإضافي Google Services 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 // ... } }
في ملف Gradle (على مستوى التطبيق) الوحدة النمطية الخاصة بك (عادةً
app/build.gradle
) ، قم بتطبيق مكون Google Services Gradle الإضافي:apply plugin: 'com.android.application' // Add the following line: apply plugin: 'com.google.gms.google-services' // Google Services plugin android { // ... }
الخطوة 4 : أضف حزم Firebase SDK إلى تطبيقك
باستخدام Firebase Android BoM ، أعلن عن تبعيات منتجات Firebase التي تريد استخدامها في تطبيقك. قم بتعريفها في ملف Gradle (على مستوى التطبيق) للوحدة النمطية (عادةً
app/build.gradle
).تم تمكين التحليلات
جافا
dependencies { // ... // Import the Firebase BoM implementation platform('com.google.firebase:firebase-bom:30.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:30.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 Android BoM ، سيستخدم تطبيقك دائمًا إصدارات متوافقة من مكتبات Firebase Android.
لم يتم تمكين التحليلات
جافا
dependencies { // ... // Import the Firebase BoM implementation platform('com.google.firebase:firebase-bom:30.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:30.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 Android BoM ، سيستخدم تطبيقك دائمًا إصدارات متوافقة من مكتبات Firebase Android.
قم بمزامنة تطبيقك للتأكد من أن جميع التبعيات لها الإصدارات الضرورية.
إن إنشاءات Gradle التي تستخدم المكون الإضافي Android Gradle (AGP) v4.2 أو إصدار سابق تحتاج إلى تمكين دعم Java 8. بخلاف ذلك ، تتعرض مشاريع Android هذه لإخفاق في الإنشاء عند إضافة Firebase SDK.
لإصلاح فشل هذا الإصدار ، يمكنك اتباع أحد الخيارين التاليين:
- أضف
compileOptions
المدرجة من رسالة الخطأ إلى ملفbuild.gradle
على مستوى التطبيق. - قم بزيادة الإصدار
minSdkVersion
لمشروع Android الخاص بك إلى 26 أو أعلى.
تعرف على المزيد حول فشل هذا الإصدار في هذه الأسئلة الشائعة .
- أضف
هذا هو! يمكنك التخطي إلى الأمام للتحقق من الخطوات التالية الموصى بها.
إذا كنت تواجه مشكلة في الإعداد ، فقم بزيارة استكشاف أخطاء Android والأسئلة الشائعة .
الخيار 2 : إضافة Firebase باستخدام Firebase Assistant
يسجل Firebase Assistant تطبيقك بمشروع Firebase ويضيف ملفات Firebase الضرورية والمكونات الإضافية والتبعيات إلى مشروع Android - كل ذلك من داخل Android Studio!
افتح مشروع Android في Android Studio ، ثم تأكد من أنك تستخدم أحدث إصدارات Android Studio ومساعد Firebase:
- نظاما التشغيل Windows / Linux: تعليمات> التحقق من وجود تحديثات
- نظام التشغيل macOS: Android Studio> التحقق من وجود تحديثات
افتح Firebase Assistant: Tools> Firebase .
في جزء المساعد ، اختر منتج Firebase لإضافته إلى تطبيقك. قم بتوسيع القسم الخاص به ، ثم انقر فوق ارتباط البرنامج التعليمي (على سبيل المثال ،
Analytics> تسجيل حدث Analytics ).انقر فوق Connect to Firebase لربط مشروع Android الخاص بك بـ Firebase.
يقوم سير العمل هذا تلقائيًا بإنشاء تطبيق Firebase Android جديد باستخدام اسم حزمة التطبيق الخاص بك. يمكنك إنشاء تطبيق Firebase Android الجديد إما في مشروع Firebase حالي أو مشروع جديد.
فيما يلي بعض النصائح حول إعداد مشروع Firebase:
تحقق من أفضل ممارساتنا لإضافة تطبيقات إلى مشروع Firebase ، بما في ذلك كيفية التعامل مع المتغيرات المتعددة.
إذا أنشأت مشروعًا جديدًا ، فإننا نوصي بشدة بإعداد Google Analytics لمشروعك ، مما يتيح لك الحصول على تجربة مثالية باستخدام العديد من منتجات Firebase.
يضيف سير العمل هذا أيضًا ملف تكوين Android الخاص بمشروع Firebase (
) إلى دليل الوحدة النمطية (مستوى التطبيق) لتطبيقك.google-services.json
انقر فوق الزر لإضافة منتج Firebase المطلوب (على سبيل المثال ،
إضافة تحليلات إلى تطبيقك ).
قم بمزامنة تطبيقك للتأكد من أن جميع التبعيات لها الإصدارات الضرورية.
في جزء المساعد ، اتبع تعليمات الإعداد المتبقية لمنتج Firebase المحدد.
أضف أي عدد تريده من منتجات Firebase عبر مساعد Firebase!
هذا هو! تأكد من إطلاعك على الخطوات التالية الموصى بها.
إذا كنت تواجه مشكلة في الإعداد ، فقم بزيارة استكشاف أخطاء Android والأسئلة الشائعة .
المكتبات المتاحة
يسرد هذا القسم منتجات Firebase المدعومة لنظام Android وتبعيات Gradle الخاصة بها. تعرف على المزيد حول مكتبات Firebase Android:
الوثائق المرجعية ( Java | Kotlin + KTX )
Firebase Android SDK GitHub repo
لاحظ أنه عند استخدام Firebase Android BoM ، فإنك لا تحدد إصدارات مكتبة فردية عندما تعلن عن تبعيات مكتبة Firebase في build.gradle
.
جافا
الخدمة أو المنتج | تبعية Gradle | آخر الإصدار | إضافة تحليلات؟ |
---|---|---|---|
Firebase Android BoM (فاتورة المواد) | com.google.firebase: firebase-bom يحتوي أحدث إصدار من Firebase BoM على أحدث الإصدارات من كل مكتبة Firebase Android. لمعرفة إصدارات المكتبة التي تم تعيينها لإصدار BoM معين ، راجع ملاحظات الإصدار الخاصة بإصدار BoM هذا. | 30.0.1 | |
AdMob | com.google.android.gms: play-services-ads | 20.6.0 | |
تحليلات | com.google.firebase: firebase-analytics | 21.0.0 | |
التطبيق تحقق مزود مخصص | com.google.firebase: firebase-appcheck | 16.0.0 | |
مزود التصحيح App Check | com.google.firebase: firebase-appcheck-debug | 16.0.0 | |
التحقق من التطبيق مزود نزاهة اللعب | com.google.firebase: firebase-appcheck-playintegrity | 16.0.0 | |
مزود التطبيق تحقق SafetyNet | com.google.firebase: firebase-appcheck-safetynet | 16.0.0 | |
توزيع التطبيق | com.google.firebase: firebase-appdistribution | 16.0.0 بيتا 02 | |
البرنامج المساعد لتوزيع التطبيقات | com.google.firebase: firebase-appdistribution-gradle | 3.0.1 | |
المصادقة | com.google.firebase: firebase-auth | 21.0.4 | |
سحابة Firestore | com.google.firebase: firebase-firestore | 24.1.2 | |
وظائف السحابة لـ Firebase Client SDK | com.google.firebase: وظائف firebase | 20.1.0 | |
المراسلة السحابية | com.google.firebase: firebase-messaging | 23.0.4 | |
سحابة التخزين | com.google.firebase: firebase-storage | 20.0.1 | |
كراشليتيك | com.google.firebase: firebase-crashlytics | 18.2.10 | |
Crashlytics NDK | com.google.firebase: firebase-crashlytics-ndk | 18.2.10 | |
البرنامج المساعد Crashlytics | com.google.firebase: firebase-crashlytics-gradle | 2.8.1 | |
دعم وحدة الميزة الديناميكية | com.google.firebase: firebase-dynamic-module-support | 16.0.0-بيتا 01 | |
روابط ديناميكية | com.google.firebase: firebase-dynamic-links | 21.0.1 | |
المراسلة داخل التطبيق | com.google.firebase: firebase-inappmessaging | 20.1.2 | (مطلوب) |
شاشة الرسائل داخل التطبيق | com.google.firebase: firebase-inappmessaging-display | 20.1.2 | (مطلوب) |
منشآت Firebase | com.google.firebase: firebase-Installation | 17.0.1 | |
واجهة برمجة تطبيقات Firebase ML Model Downloader | com.google.firebase: firebase-ml-modeldownloader | 24.0.3 | |
مراقبة الاداء | com.google.firebase: firebase-perf | 20.0.6 | |
البرنامج المساعد لمراقبة الأداء | com.google.firebase: perf-plugin | 1.4.1 | |
قاعدة بيانات الوقت الحقيقي | com.google.firebase: firebase-database | 20.0.5 | |
التكوين عن بعد | com.google.firebase: firebase-config | 21.1.0 | |
المكون الإضافي لخدمات Google Play | com.google.gms: خدمات google | 4.3.10 | |
مكتبات مهجورة | |||
فهرسة التطبيق | com.google.firebase: firebase-appindexing | 20.0.0 | |
واجهات برمجة التطبيقات للنموذج المخصص لـ 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 هذا. | 30.0.1 | |
AdMob | com.google.android.gms: play-services-ads | 20.6.0 | |
تحليلات | com.google.firebase: firebase-analytics-ktx | 21.0.0 | |
التطبيق تحقق مزود مخصص | com.google.firebase: firebase-appcheck | 16.0.0 | |
مزود التصحيح App Check | com.google.firebase: firebase-appcheck-debug | 16.0.0 | |
مزود التطبيق تحقق SafetyNet | com.google.firebase: firebase-appcheck-safetynet | 16.0.0 | |
توزيع التطبيق | com.google.firebase: firebase-appdistribution-ktx | 16.0.0 بيتا 02 | |
البرنامج المساعد لتوزيع التطبيقات | com.google.firebase: firebase-appdistribution-gradle | 3.0.1 | |
المصادقة | com.google.firebase: firebase-auth-ktx | 21.0.4 | |
سحابة Firestore | com.google.firebase: firebase-firestore-ktx | 24.1.2 | |
وظائف السحابة لـ Firebase Client SDK | com.google.firebase: firebase-function-ktx | 20.1.0 | |
المراسلة السحابية | com.google.firebase: firebase-messaging-ktx | 23.0.4 | |
سحابة التخزين | com.google.firebase: firebase-storage-ktx | 20.0.1 | |
كراشليتيك | com.google.firebase: firebase-crashlytics-ktx | 18.2.10 | |
Crashlytics NDK | com.google.firebase: firebase-crashlytics-ndk | 18.2.10 | |
البرنامج المساعد Crashlytics | com.google.firebase: firebase-crashlytics-gradle | 2.8.1 | |
دعم وحدة الميزة الديناميكية | com.google.firebase: firebase-dynamic-module-support | 16.0.0-بيتا 01 | |
روابط ديناميكية | com.google.firebase: firebase-dynamic-links-ktx | 21.0.1 | |
المراسلة داخل التطبيق | com.google.firebase: firebase-inappmessaging-ktx | 20.1.2 | (مطلوب) |
شاشة الرسائل داخل التطبيق | com.google.firebase: firebase-inappmessaging-display-ktx | 20.1.2 | (مطلوب) |
منشآت Firebase | com.google.firebase: firebase-Installation-ktx | 17.0.1 | |
واجهة برمجة تطبيقات Firebase ML Model Downloader | com.google.firebase: firebase-ml-modeldownloader-ktx | 24.0.3 | |
مراقبة الاداء | com.google.firebase: firebase-perf-ktx | 20.0.6 | |
البرنامج المساعد لمراقبة الأداء | com.google.firebase: perf-plugin | 1.4.1 | |
قاعدة بيانات الوقت الحقيقي | com.google.firebase: firebase-database-ktx | 20.0.5 | |
التكوين عن بعد | com.google.firebase: firebase-config-ktx | 21.1.0 | |
المكون الإضافي لخدمات Google Play | com.google.gms: خدمات google | 4.3.10 | |
مكتبات مهجورة | |||
فهرسة التطبيق | com.google.firebase: firebase-appindexing | 20.0.0 | |
واجهات برمجة التطبيقات للنموذج المخصص لـ 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 إلى تطبيقك:
احصل على رؤى حول سلوك المستخدم باستخدام Analytics .
قم بإعداد تدفق مصادقة المستخدم مع المصادقة .
قم بتخزين البيانات ، مثل معلومات المستخدم ، باستخدام Cloud Firestore أو Realtime Database .
قم بتخزين الملفات ، مثل الصور ومقاطع الفيديو ، باستخدام Cloud Storage .
تشغيل رمز الواجهة الخلفية الذي يعمل في بيئة آمنة باستخدام وظائف السحابة .
إرسال الإخطارات مع Cloud Messaging .
اكتشف متى ولماذا يتعطل تطبيقك مع Crashlytics .
تعرف على Firebase:
تفضل بزيارة فهم مشاريع Firebase لمعرفة المزيد حول مشاريع Firebase وأفضل الممارسات للمشاريع.
تفضل بزيارة معرفة المزيد حول Android و Firebase إذا كانت لديك أسئلة حول المفاهيم غير المألوفة أو الخاصة بتطوير Firebase و Android.
استكشاف نماذج تطبيقات Firebase .
احصل على خبرة عملية مع Firebase Android Codelab .
تعرف على المزيد مع Firebase في دورة نهاية الأسبوع .
استعد لإطلاق تطبيقك:
- قم بإعداد تنبيهات الميزانية لمشروعك في Google Cloud Console.
- راقب لوحة معلومات الاستخدام والفوترة في وحدة تحكم Firebase للحصول على صورة شاملة لاستخدام مشروعك عبر خدمات Firebase المتعددة.
- راجع قائمة التحقق الخاصة بإطلاق Firebase .
هل تواجه مشكلة في Firebase ومشروع Android الخاص بك؟ قم بزيارة استكشاف أخطاء Android والأسئلة الشائعة .