المتطلبات الأساسية
ثبِّت استوديو Android أو حدِّثه إلى أحدث إصدار.
يُرجى التأكّد من أنّ مشروعك يستوفي هذه المتطلبات (يُرجى العِلم أنّ بعض المنتجات قد تفرض متطلبات أكثر صرامة):
- يستهدف مستوى واجهة برمجة التطبيقات المستهدف 24 (Nougat) أو مستوى أعلى
- يستخدم الإصدار 7.0 من نظام التشغيل Android أو إصدارًا أحدث
- يستخدم
Jetpack (AndroidX)،
والذي يتضمن استيفاء متطلبات الإصدار التالية:
- الإصدار 7.3.0 من "
com.android.tools.build:gradle" أو إصدار أحدث - الإصدار 28 من
compileSdkVersionأو الإصدارات الأحدث
- الإصدار 7.3.0 من "
يمكنك إعداد جهاز فعلي أو استخدام محاكي لتشغيل تطبيقك.
يُرجى العِلم أنّ حِزم تطوير البرامج (SDK) لمنصّة Firebase التي تعتمد على Google Play services تتطلّب تثبيت Google Play services على الجهاز أو المحاكي.
إذا لم يكن لديك مشروع 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.
(اختياري) أدخِل اسمًا مستعارًا للتطبيق، وهو معرّف داخلي مريح لا يظهر إلا لك في وحدة تحكّم Firebase.
انقر على تسجيل التطبيق.
الخطوة 3: إضافة ملف إعداد Firebase
نزِّل ملف إعداد Firebase الخاص بتطبيقك (
) ثم أضِفه إلى قاعدة الرموز البرمجية:google-services.json انقر على تنزيل google-services.json للحصول على ملف إعدادات Firebase الخاص بتطبيقك.
انقل ملف الإعداد إلى الدليل الجذري للوحدة (على مستوى التطبيق) في تطبيقك.
لإتاحة القيم في ملف إعداد
لحزم تطوير البرامج (SDK) في Firebase، تحتاج إلى المكوّن الإضافي Gradle لخدمات Google (google-services.json ).google-services في ملف Gradle على مستوى الجذر (على مستوى المشروع) (
<project>/build.gradle.ktsأو<project>/build.gradle)، أضِف المكوّن الإضافي لخدمات Google في Gradle كأحد التبعيات: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.6.0" 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.6.0' apply false }
في ملف Gradle للوحدة (على مستوى التطبيق) (عادةً
<project>/<app-module>/build.gradle.ktsأو<project>/<app-module>/build.gradle)، أضِف المكوّن الإضافي 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 للتحكّم في إصدارات المكتبة.تم تفعيل Analytics
dependencies { // ... // Import the Firebase BoM implementation(platform("com.google.firebase:firebase-bom:35.2.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 BoM، سيستخدم تطبيقك دائمًا إصدارات متوافقة من مكتبات Firebase لنظام التشغيل Android.
Analytics غير مفعَّل
dependencies { // ... // Import the Firebase BoM implementation(platform("com.google.firebase:firebase-bom:35.2.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 BoM، سيستخدم تطبيقك دائمًا إصدارات متوافقة من مكتبات Firebase لنظام التشغيل Android.
بعد إضافة التبعيات للمنتجات التي تريد استخدامها، يمكنك مزامنة مشروع Android مع ملفات Gradle.
وهذا كل ما في الأمر! يمكنك التخطّي إلى الأمام للاطّلاع على الخطوات التالية المقترَحة.
إذا واجهت مشكلة في الإعداد، يمكنك الانتقال إلى صفحة تحديد المشاكل وحلّها في Android والأسئلة الشائعة.
الخيار 2: إضافة Firebase باستخدام "مساعِد Firebase"
يسجّل مساعِد Firebase تطبيقك في مشروع Firebase ويضيف ملفات Firebase والمكوّنات الإضافية والتبعيات اللازمة إلى مشروع Android، وكل ذلك من داخل "استوديو Android".
افتح مشروع Android في "استوديو Android"، ثم تأكَّد من استخدامك أحدث إصدارات "استوديو Android" ومساعِد Firebase:
- Windows / Linux: مساعدة > البحث عن تحديثات
- نظام التشغيل macOS: استوديو Android > البحث عن تحديثات
افتح مساعِد Firebase: الأدوات > Firebase.
في لوحة مساعد، اختَر منتج Firebase لإضافته إلى تطبيقك. وسِّع القسم الخاص به، ثم انقر على رابط الدليل التعليمي (على سبيل المثال،
Analytics > تسجيل حدث في "إحصاءات Google" ).انقر على الربط بمنصة Firebase (Connect to Firebase) لربط مشروع Android بمنصة Firebase.
انقر على الزر لإضافة منتج Firebase المطلوب (على سبيل المثال،
إضافة Analytics إلى تطبيقك ).
يُرجى مزامنة تطبيقك للتأكّد من أنّ جميع التبعيات تتضمّن الإصدارات اللازمة.
في لوحة مساعد، اتّبِع بقية تعليمات الإعداد لمنتج Firebase الذي اخترته.
يمكنك إضافة أي عدد تريده من منتجات Firebase الأخرى من خلال "مساعِد Firebase".
وهذا كل ما في الأمر! احرص على الاطّلاع على الخطوات التالية المقترَحة.
إذا واجهت مشكلة في الإعداد، يمكنك الانتقال إلى صفحة تحديد المشاكل وحلّها في Android والأسئلة الشائعة.
المكتبات المتاحة
يسرد هذا القسم منتجات Firebase المتوافقة مع Android وتبعيات Gradle الخاصة بها. مزيد من المعلومات عن مكتبات Firebase Android التالية:
Firebase Android SDK مستودع GitHub
يُرجى العِلم أنّه عند استخدام Firebase Android BoM، لا تحدّد إصدارات المكتبات الفردية عند الإفصاح عن موارد الاعتمادية لمكتبة Firebase في ملف إعدادات التصميم في Gradle.
| الخدمة أو المنتج | تبعية Gradle | أحدث إصدار |
هل تريد إضافة Analytics؟ | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| Firebase Android BoM (Bill of Materials) |
com.google.firebase:firebase-bom
يحتوي أحدث إصدار من Firebase BoM على أحدث الإصدارات من كل مكتبة Firebase لنظام التشغيل Android. لمعرفة إصدارات المكتبة التي تم ربطها بإصدار معيّن من BoM، يُرجى مراجعة ملاحظات الإصدار الخاصة بإصدار BoM هذا. |
35.2.0 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| المكوّن الإضافي Gradle لخدمات Google | com.google.gms:google-services | 4.6.0 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| AdMob | com.google.android.gms:play-services-ads | 25.5.0 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Firebase AI Logic 1 | com.google.firebase:firebase-ai | 18.2.0 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Firebase AI Logic On-Device | com.google.firebase:firebase-ai-ondevice | 16.0.0-beta08 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Firebase AI KSP | com.google.firebase:firebase-ai-ksp-processor | 17.0.0 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Analytics | com.google.firebase:firebase-analytics | 24.0.0 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| مقدّم خدمة مخصّص واحد (App Check) | com.google.firebase:firebase-appcheck | 20.1.0 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| مقدّم خدمة تصحيح الأخطاء في App Check | com.google.firebase:firebase-appcheck-debug | 20.1.0 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| مقدّم خدمة Play Integrity واحد (App Check) | com.google.firebase:firebase-appcheck-playintegrity | 20.1.0 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| مقدّم خدمة App Check reCAPTCHA | com.google.firebase:firebase-appcheck-recaptcha | 20.1.0 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| App Distribution | com.google.firebase:firebase-appdistribution | 16.0.0-beta21 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| App Distribution API | com.google.firebase:firebase-appdistribution-api | 16.0.0-beta21 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| المكوّن الإضافي App Distribution | com.google.firebase:firebase-appdistribution-gradle | 5.3.1 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Authentication | com.google.firebase:firebase-auth | 25.0.0 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Cloud Firestore | com.google.firebase:firebase-firestore | 27.2.0 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Cloud Functions for Firebase Client SDK | com.google.firebase:firebase-functions | 23.0.0 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Cloud Messaging | com.google.firebase:firebase-messaging | 26.0.2 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Cloud Storage | com.google.firebase:firebase-storage | 23.0.0 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Crashlytics | com.google.firebase:firebase-crashlytics | 21.1.0 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Crashlytics NDK | com.google.firebase:firebase-crashlytics-ndk | 21.1.0 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| المكوّن الإضافي Crashlytics | com.google.firebase:firebase-crashlytics-gradle | 3.0.8 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| إتاحة وحدة الميزات الديناميكية | com.google.firebase:firebase-dynamic-module-support | 16.0.0-beta05 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| In-App Messaging | com.google.firebase:firebase-inappmessaging | 23.0.0 | (مطلوب) |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| In-App Messaging الشبكة الإعلانية | com.google.firebase:firebase-inappmessaging-display | 23.0.0 | (مطلوب) |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| عمليات تثبيت بقيمة Firebase | com.google.firebase:firebase-installations | 20.0.0 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Performance Monitoring | com.google.firebase:firebase-perf | 23.0.1 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| المكوّن الإضافي Performance Monitoring | com.google.firebase:perf-plugin | 2.0.2 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Firebase Phone Number Verification | com.google.firebase:firebase-pnv | 17.0.0 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Realtime Database | com.google.firebase:firebase-database | 23.0.0 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Remote Config | com.google.firebase:firebase-config | 24.0.1 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| SQL Connect 2 | com.google.firebase:firebase-dataconnect | 18.0.1 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| المكتبات المتوقفة نهائيًا أو غير المتوافقة | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Dynamic Links | com.google.firebase:firebase-dynamic-links | 22.1.0 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
وحدات Firebase KTX - لم تعُد متاحة
|
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
مكتبات Firebase ML وحزمة Firebase ML
|
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
1 كانت "Firebase AI Logic" تُعرف سابقًا باسم
"Vertex AI in Firebase" مع الحزمة
com.google.firebase:firebase-vertexai.
2 كانت "Firebase SQL Connect" تُعرف سابقًا باسم "Firebase Data Connect".
الخطوات التالية
إضافة خدمات Firebase إلى تطبيقك:
يمكنك إنشاء ميزات مستندة إلى الذكاء الاصطناعي التوليدي باستخدام نماذج Gemini من خلال Firebase AI Logic.
يمكنك الحصول على إحصاءات حول سلوك المستخدمين من خلال Analytics.
إعداد مسار مصادقة المستخدم باستخدام Authentication
تخزين البيانات، مثل معلومات المستخدمين، باستخدام Cloud Firestore أو Realtime Database
يمكنك تخزين الملفات، مثل الصور والفيديوهات، باستخدام Cloud Storage.
يمكنك تفعيل رمز الخلفية الذي يتم تشغيله في بيئة آمنة باستخدام Cloud Functions.
إرسال الإشعارات باستخدام Cloud Messaging
يمكنك معرفة وقت تعطُّل تطبيقك وسبب ذلك باستخدام Crashlytics.
مزيد من المعلومات عن Firebase:
انتقِل إلى مقالة فهم مشاريع Firebase لمزيد من المعلومات عن مشاريع Firebase وأفضل الممارسات المتعلّقة بها.
يمكنك الانتقال إلى صفحة مزيد من المعلومات عن Android وFirebase إذا كانت لديك أسئلة حول مفاهيم غير مألوفة أو خاصة بتطوير Firebase وAndroid.
يمكنك الاطّلاع على نماذج تطبيقات Firebase.
يمكنك الحصول على خبرة عملية من خلال الدرس التطبيقي حول الترميز في Firebase على Android.
يمكنك الاطّلاع على مزيد من المعلومات من خلال دورة Firebase in a Weekend.
الاستعداد لإطلاق تطبيقك:
- يمكنك إعداد تنبيهات الميزانية لمشروعك في وحدة تحكّم Google Cloud.
- يمكنك مراقبة لوحة بيانات الاستخدام والفوترة في وحدة تحكّم Firebase للحصول على صورة شاملة عن استخدام مشروعك في خدمات Firebase المتعدّدة.
- راجِع قائمة التحقّق من إطلاق Firebase.
هل تواجه مشكلة في Firebase ومشروع Android؟ يُرجى الانتقال إلى الأسئلة الشائعة وتحديد المشاكل وحلّها في Android.