المتطلبات الأساسية
ثبِّت استوديو Android أو حدِّثه إلى أحدث إصدار.
تأكد من أن مشروعك يلبي هذه المتطلبات (لاحظ أن بعض المنتجات قد يكون لها متطلبات أكثر صرامة):
- يستهدف المستوى 19 من واجهة برمجة التطبيقات (KitKat) أو مستوى أعلى
- يستخدم الإصدار 4.4 من نظام التشغيل Android أو إصدارًا أحدث
- تستخدم
Jetpack (AndroidX)،
الذي يتضمن استيفاء متطلبات الإصدار التالية:
- الإصدار 7.3.0 من "
com.android.tools.build:gradle
" أو إصدار أحدث compileSdkVersion
28 أو أحدث
- الإصدار 7.3.0 من "
يمكنك إعداد جهاز مادي أو استخدام مُحاكي لتشغيل تطبيقك.
تجدر الإشارة إلى أن حِزم تطوير البرامج (SDK) لمنصة Firebase التي تعتمد على خدمات Google Play تتطلب تثبيت خدمات Google Play على الجهاز أو المحاكي.سجّل الدخول إلى Firebase باستخدام حسابك على Google.
إذا لم يكن لديك مشروع على Android وأردت فقط تجربة أحد منتجات Firebase، يمكنك تنزيل أحد نماذج البدء السريع.
يمكنك ربط تطبيقك على Android بمنصة Firebase باستخدام أحد
الخيارات التالية:
- الخيار 1: (يُنصح به) استخدام سير عمل إعداد وحدة تحكُّم Firebase.
- الخيار 2: استخدام "مساعد Firebase" في "استوديو Android" (قد يتطلّب ذلك إعدادات إضافية)
الخيار 1: إضافة Firebase باستخدام "وحدة تحكُّم Firebase"
تتضمن إضافة Firebase إلى تطبيقك مهام كلٍّ من وحدة تحكم Firebase وفي مشروع Android المفتوح (على سبيل المثال، تنزيل ملفات تهيئة Firebase من وحدة التحكم، ثم نقلها إلى مشروع Android الخاص بك).
الخطوة 1: إنشاء مشروع على Firebase
قبل إضافة Firebase إلى تطبيقك على Android، يجب إنشاء مشروع في Firebase لربطه بتطبيق Android. يمكنك الانتقال إلى مقالة فهم مشاريع Firebase للاطّلاع على مزيد من المعلومات حول مشاريع Firebase.
الخطوة 2: تسجيل تطبيقك في Firebase
لاستخدام Firebase في تطبيق Android، يجب تسجيل تطبيقك في مشروع Firebase. غالبًا ما يُطلق على تسجيل تطبيقك "إضافة" تطبيقك إلى مشروعك.
انتقِل إلى وحدة تحكُّم Firebase.
في منتصف صفحة النظرة العامة على المشروع، انقر على رمز Android (
) أو إضافة تطبيق لبدء عملية الإعداد.أدخِل اسم حزمة تطبيقك في حقل اسم حزمة Android.
(اختياري) أدخِل معلومات التطبيق الأخرى: اسم التطبيق وشهادة توقيع تصحيح الأخطاء SHA-1.
انقر على تسجيل التطبيق.
الخطوة 3: إضافة ملف إعداد Firebase
نزِّل ملف إعداد Firebase لنظام التشغيل Android ثم أضِفه (
) إلى تطبيقك:google-services.json انقر على تنزيل google-services.json للحصول على ملف إعداد Firebase لنظام التشغيل Android.
انقل ملف الإعداد إلى الدليل الجذري للوحدة (على مستوى التطبيق) في تطبيقك.
لإتاحة الوصول إلى القيم في ملف الإعداد
من خلال حِزم تطوير البرامج (SDK) لمنصة Firebase، ستحتاج إلى المكوّن الإضافي لنظام Gradle المتوافق مع خدمات Google (google-services.json google-services
).في ملف 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.1" 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.1' apply false }
في ملف 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 إلى تطبيقك
في ملف Gradle للوحدة (على مستوى التطبيق) (عادةً
<project>/<app-module>/build.gradle.kts
أو<project>/<app-module>/build.gradle
)، أضِف التبعيات لمنتجات Firebase التي تريد استخدامها في تطبيقك. وننصحك باستخدام مشروع Firebase Android BoM للتحكّم في إصدارات المكتبة.تم تفعيل "إحصاءات Google"
dependencies { // ... // Import the Firebase BoM implementation(platform("com.google.firebase:firebase-bom:33.0.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، سيستخدم تطبيقك دائمًا إصدارات متوافقة من مكتبات Firebase لأجهزة Android.
هل تبحث عن وحدة مكتبة خاصة بلغة Kotlin؟ اعتبارًا من تشرين الأول (أكتوبر) 2023 ( Firebase BoM 32.5.0)، أصبح بإمكان مطوّري لغتَي Kotlin وJava الاعتماد على وحدة المكتبة الرئيسية (لمعرفة التفاصيل، يُرجى الاطّلاع على الأسئلة الشائعة حول هذه المبادرة).
"إحصاءات Google" غير مفعّلة
dependencies { // ... // Import the Firebase BoM implementation(platform("com.google.firebase:firebase-bom:33.0.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، سيستخدم تطبيقك دائمًا إصدارات متوافقة من مكتبات Firebase لأجهزة Android.
هل تبحث عن وحدة مكتبة خاصة بلغة Kotlin؟ اعتبارًا من تشرين الأول (أكتوبر) 2023 ( Firebase BoM 32.5.0)، أصبح بإمكان مطوّري لغتَي Kotlin وJava الاعتماد على وحدة المكتبة الرئيسية (لمعرفة التفاصيل، يُرجى الاطّلاع على الأسئلة الشائعة حول هذه المبادرة).
بعد إضافة التبعيات للمنتجات التي تريد استخدامها، قم بمزامنة مشروع Android مع ملفات Gradle.
وهذا كل ما في الأمر! يمكنك تخطّي هذه الخطوة للاطّلاع على الخطوات التالية المقترَحة.
ومع ذلك، إذا كنت تواجه مشكلة في الإعداد، يمكنك الانتقال إلى تحديد المشاكل في نظام التشغيل Android وحلّها والأسئلة الشائعة.
الخيار 2: إضافة Firebase باستخدام "مساعد Firebase"
يسجّل مساعد Firebase تطبيقك في مشروع Firebase ويضيف ملفات Firebase والمكوّنات الإضافية والتبعيات اللازمة إلى مشروع Android، كل ذلك من داخل Android Studio!
افتح مشروع Android في "استوديو Android" ثم تأكَّد من استخدام أحدث إصدار من "استوديو Android" و"مساعد Firebase":
- نظاما التشغيل Windows / Linux: مساعدة > البحث عن تحديثات
- نظام التشغيل macOS: استوديو Android > البحث عن تحديثات
افتح "مساعد Firebase": الأدوات > Firebase.
في لوحة المساعد، اختَر منتج Firebase لإضافته إلى تطبيقك. وسِّع القسم الخاص به، ثم انقر على رابط البرنامج التعليمي (مثلاً،
إحصاءات Google > تسجيل حدث في "إحصاءات Google" ).انقر على الربط بمنصّة Firebase لربط مشروعك على Android بمنصّة Firebase.
انقر على الزرّ لإضافة منتج Firebase مطلوب (على سبيل المثال،
إضافة "إحصاءات Google" إلى تطبيقك ).
عليك مزامنة تطبيقك للتأكُّد من احتواء جميع التبعيات على الإصدارات اللازمة.
في لوحة مساعد Google، اتّبِع التعليمات المتبقية لإجراء عملية الإعداد لمنتج Firebase المحدّد.
يمكنك إضافة أي عدد تريده من منتجات Firebase عبر "مساعد Firebase".
وهذا كل ما في الأمر! احرص على الاطّلاع على الخطوات التالية المقترَحة.
ومع ذلك، إذا كنت تواجه مشكلة في الإعداد، يمكنك الانتقال إلى تحديد المشاكل في نظام التشغيل Android وحلّها والأسئلة الشائعة.
المكتبات المتاحة
يسرد هذا القسم منتجات Firebase المتوافقة مع Android والعناصر التابعة لها Gradle. اطّلِع على مزيد من المعلومات عن مكتبات Firebase لأجهزة Android التالية:
المستندات المرجعية (Kotlin+KTX | Java)
حزمة تطوير البرامج (SDK) لنظام التشغيل Android لمنصة Firebase مستودع GitHub
يُرجى العِلم أنّه عند استخدام برنامج Android BoM على Firebase، لا يمكنك تحديد إصدارات مكتبة فردية عند تعريفك بتبعيات مكتبة Firebase في ملف إعداد إصدار Gradle.
الخدمة أو المنتج | تبعية Gradle | أحدث إصدار |
هل تريد إضافة "إحصاءات Google"؟ | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
قائمة المواد الإبداعية لمنصة Firebase (قائمة المواد) |
com.google.firebase:firebase-bom
يحتوي أحدث إصدار من Firebase BoM على أحدث الإصدارات من كل مكتبة Android في Firebase. لمعرفة إصدارات المكتبة المرتبطة بإصدار معيّن من BoM، راجِع ملاحظات الإصدار الخاصة بنسخة BoM تلك. |
33.0.0 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
AdMob | com.google.android.gms:play-services-ads | 23.1.0 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
إحصاءات Google | com.google.firebase:firebase-analytics | 22.0.0 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
مقدّم خدمة App Check | com.google.firebase:firebase-appcheck | 18.0.0 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
موفّر تصحيح أخطاء "فحص التطبيقات" | com.google.firebase:firebase-appcheck-debug | 18.0.0 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
مقدِّم خدمة Play Integrity في التحقّق من التطبيقات | com.google.firebase:firebase-appcheck-playintegrity | 18.0.0 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
توزيع التطبيقات | com.google.firebase:firebase-appdistribution | الإصدار 16.0.0-تجريبي12 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
App Distribution API | com.google.firebase:firebase-appdistribution-api | الإصدار 16.0.0-تجريبي12 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
المكوّن الإضافي لتوزيع التطبيقات | com.google.firebase:firebase-appdistribution-gradle | 5.0.0 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
المصادقة | com.google.firebase:firebase-auth | 23.0.0 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Cloud Firestore | com.google.firebase:firebase-firestore | 25.0.0 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
وظائف Cloud لحزمة تطوير البرامج (SDK) لعميل Firebase | com.google.firebase:firebase-functions | 21.0.0 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
المراسلة عبر السحابة الإلكترونية | com.google.firebase:firebase-messaging | 24.0.0 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
التخزين في السحابة الإلكترونية | com.google.firebase:firebase-storage | 21.0.0 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Crashlytics | com.google.firebase:firebase-crashlytics | 19.0.0 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Crashlytics NDK | com.google.firebase:firebase-crashlytics-ndk | 19.0.0 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
مكوّن Crashlytics الإضافي | com.google.firebase:firebase-crashlytics-gradle | 3.0.1 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
إتاحة استخدام وحدة الميزات الديناميكية | com.google.firebase:firebase- Dynamic-موز -support | الإصدار 16.0.0-تجريبي03 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
الروابط الديناميكية | com.google.firebase:firebase- Dynamic-links | 22.0.0 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
المراسلة داخل التطبيق | com.google.firebase:firebase-inappmessaging | 21.0.0 | (مطلوبة) |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
عرض المراسلة داخل التطبيق | com.google.firebase:firebase-inappmessaging-display | 21.0.0 | (مطلوبة) |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
عمليات تثبيت Firebase | com.google.firebase:firebase-installations | 18.0.0 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
واجهة برمجة تطبيقات أداة تنزيل نماذج تعلُّم الآلة من Firebase | com.google.firebase:firebase-ml-modeldownloader | 25.0.0 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
مراقبة الأداء | com.google.firebase:firebase-perf | 21.0.0 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
المكوّن الإضافي "مراقبة الأداء" | com.google.firebase:perf- الافتراضي | 1.4.2 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
قاعدة بيانات الوقت الفعلي | com.google.firebase:firebase-database | 21.0.0 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
الإعداد عن بُعد | com.google.firebase:firebase-config | 22.0.0 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Vertex AI for Firebase | com.google.firebase:firebase-VERexai | الإصدار 16.0.0-تجريبي01 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
المكوّن الإضافي "خدمات Google Play" | com.google.gms:google-services | 4.4.1 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
المكتبات التي تم إيقافها نهائيًا | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
موفّر خدمة SafetyNet بشأن التحقّق من التطبيقات | com.google.firebase:firebase-appcheck-safetynet | 16.1.2 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
فهرسة التطبيقات | com.google.firebase:firebase-appindexing | 20.0.0 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
وحدات Firebase KTX
|
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
مكتبات أدوات تعلُّم الآلة من Firebase
|
الخطوات اللاحقة
إضافة خدمات Firebase إلى تطبيقك:
الحصول على إحصاءات حول سلوك المستخدم من خلال إحصاءات Google.
يمكنك إعداد مسار مصادقة المستخدم من خلال المصادقة.
يمكنك تخزين البيانات، مثل معلومات المستخدمين، باستخدام Cloud Firestore أو قاعدة بيانات الوقت الفعلي.
تخزين الملفات، مثل الصور والفيديوهات، باستخدام Cloud Storage.
يمكنك تشغيل رمز خلفية يتم تشغيله في بيئة آمنة باستخدام دوال Cloud.
يمكنك إرسال الإشعارات باستخدام المراسلة عبر السحابة الإلكترونية.
تعرَّف على وقت تعطُّل تطبيقك وأسباب تعطُّله باستخدام Crashlytics.
التعرّف على Firebase:
انتقِل إلى قسم فهم مشاريع Firebase للاطّلاع على مزيد من المعلومات حول مشاريع Firebase وأفضل الممارسات للمشاريع.
يمكنك الانتقال إلى مقالة مزيد من المعلومات عن Android وFirebase إذا كانت لديك أسئلة حول مفاهيم غير مألوفة أو خاصة بتطوير Firebase وAndroid.
يمكنك استكشاف نماذج تطبيقات Firebase.
احصل على تجربة عملية من خلال الدرس التطبيقي حول ترميز Android على Firebase.
تعرَّف على مزيد من المعلومات من خلال دورة Firebase in a Weekend.
الاستعداد لإطلاق تطبيقك:
- عليك إعداد تنبيهات بشأن الميزانية لمشروعك في وحدة تحكُّم Google Cloud.
- راقِب لوحة بيانات الاستخدام والفوترةفي وحدة تحكُّم Firebase للحصول على صورة شاملة لاستخدام مشروعك في العديد من خدمات Firebase.
- مراجعة قائمة التحقق من إطلاق Firebase
هل تواجه مشكلة في Firebase ومشروع Android الخاص بك؟ يُرجى الانتقال إلى تحديد المشاكل في نظام التشغيل Android وحلّها والأسئلة الشائعة.