المتطلبات الأساسية
تثبيت استوديو Android أو تحديثه إلى أحدث إصدار منه.
تأكد من أن مشروعك يلبي هذه المتطلبات (لاحظ أن بعض المنتجات متطلبات أكثر صرامة):
- استهداف المستوى 19 من واجهة برمجة التطبيقات (KitKat) أو أعلى
- تستخدِم الإصدار 4.4 من نظام التشغيل Android أو إصدارًا أحدث.
- الاستخدامات
Jetpack (AndroidX)،
الذي يتضمن استيفاء متطلبات الإصدار التالية:
com.android.tools.build:gradle
، الإصدار 7.3.0 أو إصدار أحدثcompileSdkVersion
28 أو أحدث
إعداد جهاز فعلي أو استخدام المحاكي تشغيل تطبيقك.
تجدر الإشارة إلى أنّ حِزم تطوير البرامج (SDK) لمنصة Firebase التي تعتمد على Google Play الخدمات تتطلب الجهاز أو أن يتم تثبيت خدمات Google Play على جهازك.سجّل الدخول إلى Firebase باستخدام حسابك الحساب.
إذا لم يكن لديك مشروع على Android وكنت تريد فقط تجربة Firebase يمكنك تنزيل أحد نماذج البدء السريع لدينا.
يمكنك ربط تطبيق Android بمنصّة Firebase باستخدام أحد الخيارات التالية:
الخيارات:
- الخيار 1: (ننصح به) استخدِم سير عمل إعداد "وحدة تحكُّم Firebase".
- الخيار 2: استخدام "استوديو Android" على Firebase "مساعد Google" (قد يتطلّب ذلك ضبط إعدادات إضافية)
الخيار 1: إضافة Firebase باستخدام وحدة تحكُّم Firebase
تتضمن إضافة Firebase إلى تطبيقك مهامًا في وحدة تحكم Firebase في مشروع Android المفتوح (على سبيل المثال، يمكنك تنزيل ملفات إعداد Firebase) من وحدة التحكّم، ثم انقلها إلى مشروع Android).
الخطوة 1: إنشاء مشروع على Firebase
يجب إنشاء منصّة Firebase لتتمكّن من إضافة منصة Firebase إلى تطبيقك على Android. مشروعك لربطه بتطبيق 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. config.
انقِل ملف الإعداد إلى الدليل الجذري للوحدة (على مستوى التطبيق) تطبيقك.
لإتاحة الوصول إلى القيم في ملف إعداد
بحزم تطوير البرامج (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.2" 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.2' 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 تريد استخدامها في تطبيقك. ننصح باستخدام منصة Android BoM في Firebase للتحكّم فيها لإصدارات المكتبة.تفعيل الإحصاءات
dependencies { // ... // Import the Firebase BoM implementation(platform("com.google.firebase:firebase-bom:33.1.2")) // 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") }
من خلال استخدام BoM Android في Firebase، سيستخدم تطبيقك دائمًا الإصدارات المتوافقة من Firebase Android المكتبات.
هل تبحث عن وحدة مكتبة خاصة بلغة Kotlin؟ ستبدأ بعد تشرين الأول (أكتوبر) 2023 (الإصدار 32.5.0 من Firebase BoM)، بإمكان مطوّري برامج Kotlin وJava تعتمد على وحدة المكتبة الرئيسية (لمزيد من التفاصيل، راجع الأسئلة الشائعة حول هذه المبادرة).
عدم تفعيل الإحصاءات
dependencies { // ... // Import the Firebase BoM implementation(platform("com.google.firebase:firebase-bom:33.1.2")) // 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") }
من خلال استخدام BoM Android في Firebase، سيستخدم تطبيقك دائمًا الإصدارات المتوافقة من Firebase Android المكتبات.
هل تبحث عن وحدة مكتبة خاصة بلغة Kotlin؟ ستبدأ بعد تشرين الأول (أكتوبر) 2023 (الإصدار 32.5.0 من Firebase BoM)، بإمكان مطوّري برامج Kotlin وJava تعتمد على وحدة المكتبة الرئيسية (لمزيد من التفاصيل، راجع الأسئلة الشائعة حول هذه المبادرة).
بعد إضافة التبعيات للمنتجات التي تريد استخدامها، قم بمزامنة مشروع Android مع ملفات Gradle
وهذا كل ما في الأمر! يمكنك التخطّي للاطّلاع على الاقتراحات الخطوات التالية.
إذا كنت تواجه مشكلة في عملية الإعداد، يُرجى الانتقال إلى تحديد مشاكل Android وحلّها الأسئلة الشائعة:
الخيار 2: إضافة Firebase باستخدام "مساعد Firebase"
يسجِّل مساعد Firebase لتطبيقك بمشروع Firebase وإضافة ملفات Firebase والمكوّنات الإضافية اللازمة ومعلومات عن مشروعك على Android، كل ذلك من داخل "استوديو Android".
افتح مشروع Android في "استوديو Android" ثم تأكَّد من باستخدام أحدث إصدار من "استوديو Android" و"مساعد Firebase":
- Windows / Linux: مساعدة > البحث عن تحديثات
- macOS: Android Studio > البحث عن تحديثات
افتح "مساعد Firebase": الأدوات >. Firebase:
في لوحة مساعد Google، اختَر أحد منتجات Firebase لإضافته إلى تطبيقك. وسِّع قسم الدليل التوجيهي، ثم انقر على رابط الدليل التوجيهي. (على سبيل المثال،
إحصاءات Google > تسجيل حدث في "إحصاءات Google" ).انقر على الربط بمنصة Firebase لربط مشروع Android بمنصّة Firebase.
انقر على الزر لإضافة منتج Firebase المطلوب (على سبيل المثال،
إضافة "إحصاءات Google" إلى تطبيقك ).
قم بمزامنة تطبيقك للتأكد من أن جميع التبعيات لديها الإصدارات اللازمة.
في لوحة مساعد Google، اتّبِع تعليمات الإعداد المتبقية منتج Firebase الذي اخترته.
يمكنك إضافة العدد الذي تريده من منتجات Firebase من خلال Firebase. مساعد Google!
وهذا كل ما في الأمر! ننصحك بالاطّلاع على الفيديوهات المقترَحة الخطوات التالية.
إذا كنت تواجه مشكلة في عملية الإعداد، يُرجى الانتقال إلى تحديد مشاكل Android وحلّها الأسئلة الشائعة:
المكتبات المتاحة
يسرد هذا القسم منتجات Firebase المتوافقة مع Android وأجهزة Gradle المرتبطة بها. والتبعيات لديك. اطّلِع على المزيد من المعلومات عن مكتبات Android التالية من Firebase:
المستندات المرجعية (Kotlin+KTX | Java)
حزمة تطوير البرامج (SDK) لنظام التشغيل Android لمنصة Firebase مستودع GitHub
يُرجى العلم أنّه عند استخدام قائمة بنود Android لمنصة Firebase، لا يمكنك تحديد إصدارات مكتبة فردية عند الإعلان عن مكتبة Firebase. والتبعيات في ملف تهيئة إصدار Gradle.
الخدمة أو المنتج | تبعية Gradle | أحدث إصدار |
هل تريد إضافة "إحصاءات Google"؟ | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
قائمة مواد Android في Firebase (قائمة المواد) |
com.google.firebase:firebase-bom
يحتوي أحدث إصدار من قائمة BoM في Firebase على أحدث الإصدارات. لكل من مكتبة Firebase Android. لمعرفة إصدارات المكتبة بنسخة محددة من BoM، فراجع ملاحظات الإصدار لنسخة BoM هذه. |
33.1.2 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
AdMob | com.google.android.gms:play-services-ads | 23.2 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
إحصاءات Google | com.google.firebase:firebase-analytics | 22.0.2 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
موفِّر خدمة مخصّص لميزة "فحص التطبيقات" | 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-13 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
واجهة برمجة التطبيقات لتوزيع التطبيقات | com.google.firebase:firebase-appdistribution-api | الإصدار التجريبي 16.0.0-13 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
مكوِّن إضافي لتوزيع التطبيقات | 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 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
حزمة تطوير البرامج (SDK) الخاصة بإصدار Cloud Functions لبرنامج Firebase | com.google.firebase:دوال firebase | 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.3 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Crashlytics NDK | com.google.firebase:firebase-crashlytics-ndk | 19.0.3 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
المكوّن الإضافي Crashlytics | com.google.firebase:firebase-crashlytics-gradle | 3.0.2 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
دعم وحدات الميزات الديناميكية | com.google.firebase:firebase-dynamic-module-support | 16.0.0-تجريبي03 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
الروابط الديناميكية | com.google.firebase:firebase-dynamic-links | 22.1.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.1 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
المكوّن الإضافي "مراقبة الأداء" | com.google.firebase:perf-plugin | 1.4.2 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
قاعدة بيانات الوقت الفعلي | com.google.firebase:firebase-database | 21.0.0 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
الإعداد عن بُعد | com.google.firebase:firebase-config | 22.0.0 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Vertex AI لبرنامج Firebase | com.google.firebase:firebase-vertexai | 16.0.0-تجريبي03 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
المكوّن الإضافي "خدمات Google Play" | com.google.gms:google-services | 4.4.2 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
المكتبات التي تم إيقافها نهائيًا | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
موفّر خدمة App Check SafetyNet | com.google.firebase:firebase-appcheck-safetynet | 16.1.2 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
فهرسة التطبيقات | com.google.firebase:firebase-appindexing | 20.0.0 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
وحدات KTX من Firebase
|
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
مكتبات حزمة تعلُّم الآلة من Firebase
|
الخطوات التالية
إضافة خدمات Firebase إلى تطبيقك:
احصل على إحصاءات عن سلوك المستخدم من خلال إحصاءات Google:
يمكنك إعداد تدفق مصادقة المستخدم باستخدام المصادقة.
يمكن تخزين البيانات، مثل معلومات المستخدم، باستخدام Cloud Firestore أو قاعدة بيانات الوقت الفعلي.
يمكنك تخزين الملفات، مثل الصور والفيديوهات، باستخدام التخزين في السحابة الإلكترونية:
يؤدي هذا الإجراء إلى تشغيل رمز الخلفية الذي يتم تشغيله في بيئة آمنة باستخدام الوظائف السحابية:
إرسال الإشعارات باستخدام المراسلة عبر السحابة الإلكترونية.
التعرّف على وقت وأسباب تعطُّل تطبيقك Crashlytics:
تعرَّف على Firebase:
انتقِل إلى مقالة فهم مشاريع Firebase للحصول على مزيد من المعلومات. حول مشاريع Firebase وأفضل الممارسات للمشروعات.
انتقِل إلى مقالة مزيد من المعلومات حول Android وFirebase في حال: طرح أسئلة حول مفاهيم غير مألوفة أو خاصة بمنصة Firebase تطوير Android
استكشاف المحتوى نماذج تطبيقات Firebase
الحصول على تجربة عملية من خلال برنامج Firebase لنظام التشغيل Android درس تطبيقي حول الترميز:
يمكنك الاطّلاع على مزيد من المعلومات من خلال دورة Firebase في عطلة نهاية الأسبوع.
الاستعداد لإطلاق تطبيقك:
- إعداد الميزانية تنبيهات لمشروعك في Google Cloud Console.
- يمكنك مراقبة الاستخدام والفوترة لوحة البيانات في وحدة تحكم Firebase للحصول على صورة شاملة عبر خدمات Firebase المتعددة.
- راجِع قائمة التحقّق الخاصة بإطلاق Firebase.
هل تواجه مشكلة في Firebase ومشروع Android؟ انتقل إلى استكشاف أخطاء Android وإصلاحها الأسئلة الشائعة: