أضِف Firebase إلى مشروع Android الخاص بك، في حال لم يسبق لك إجراء ذلك.
إنشاء قاعدة بيانات
انتقِل إلى القسم Realtime Database في وحدة تحكّم Firebase. سيُطلب منك اختيار مشروع حالي على Firebase. اتّبِع سير عمل إنشاء قاعدة البيانات.
اختَر وضعًا أوليًا لتطبيق Firebase Security Rules:
- وضع الاختبار
مناسبة للبدء باستخدام مكتبات عملاء الويب والأجهزة الجوّالة، ولكنّها تسمح لأي مستخدم بقراءة بياناتك وإعادة كتابتها. بعد الاختبار، احرص على قراءة القسم فهم قواعد قاعدة بيانات Firebase في الوقت الفعلي .
لبدء استخدام حزمة تطوير البرامج (SDK) للويب أو Apple أو Android، اختَر وضع الاختبار.
- وضع القفل
يرفض جميع عمليات القراءة والكتابة من عملاء الويب والأجهزة الجوّالة. سيظل بإمكان خوادم التطبيقات التي تمت مصادقتها الوصول إلى قاعدة البيانات الخاصة بك.
اختَر موقعًا لقاعدة البيانات.
بناءً على موقع قاعدة البيانات، سيكون عنوان URL لقاعدة البيانات الجديدة بأحد الأشكال التالية:
(لقاعدة بيانات فيDATABASE_NAME.firebaseio.com
us-central1
) (للقواعد البيانات في جميع المواقع الجغرافية الأخرى)DATABASE_NAME.REGION.firebasedatabase.app
انقر على تم.
عند تفعيل Realtime Database، يتم أيضًا تفعيل واجهة برمجة التطبيقات في Cloud API Manager.
إضافة حزمة تطوير البرامج (SDK) لمنصّة Realtime Database إلى تطبيقك
في ملف Gradle للوحدة (على مستوى التطبيق) (عادةً<project>/<app-module>/build.gradle.kts
أو
<project>/<app-module>/build.gradle
)،
أضِف الاعتمادية لمكتبة Realtime Database لنظام التشغيل Android. نقترح استخدام
Firebase Android BoM
للتحكّم في نُسَخ المكتبة.
dependencies { // Import the BoM for the Firebase platform implementation(platform("com.google.firebase:firebase-bom:33.5.1")) // Add the dependency for the Realtime Database library // When using the BoM, you don't specify versions in Firebase library dependencies implementation("com.google.firebase:firebase-database") }
باستخدام Firebase Android BoM، سيستخدم تطبيقك دائمًا إصدارات متوافقة من مكتبات Firebase لنظام التشغيل Android.
(بديل) إضافة تبعيات مكتبة Firebase بدون استخدام BoM
إذا اخترت عدم استخدام Firebase BoM، يجب تحديد كل إصدار من مكتبة Firebase في سطر التبعية الخاص به.
يُرجى العلم أنّه في حال استخدام مكتبات Firebase متعدّدة في تطبيقك، ننصحك بشدة باستخدام BoM لإدارة إصدارات المكتبة، ما يضمن توافق جميع الإصدارات.
dependencies { // Add the dependency for the Realtime Database library // When NOT using the BoM, you must specify versions in Firebase library dependencies implementation("com.google.firebase:firebase-database:21.0.0") }
إعداد "Realtime Database Security Rules"
يوفّر Realtime Database لغة قواعد توضيحية تسمح لك بتحديد كيفية تنظيم بياناتك وكيفية فهرستها والحالات التي يمكن فيها قراءة بياناتك وكتابتها.
الكتابة في قاعدة البيانات
استرجع مثيلًا من قاعدة بياناتك باستخدام getInstance()
و
اشرِك الموقع الذي تريد الكتابة إليه.
Kotlin+KTX
// Write a message to the database val database = Firebase.database val myRef = database.getReference("message") myRef.setValue("Hello, World!")
Java
// Write a message to the database FirebaseDatabase database = FirebaseDatabase.getInstance(); DatabaseReference myRef = database.getReference("message"); myRef.setValue("Hello, World!");
يمكنك حفظ مجموعة من أنواع البيانات في قاعدة البيانات بهذه الطريقة، بما في ذلك عناصر Java. عند حفظ عنصر، سيتم حفظ الردود من أيّ أدوات جلب على أنّها عناصر فرعية لهذا الموقع الجغرافي.
القراءة من قاعدة البيانات
لتعديل بيانات تطبيقك في الوقت الفعلي، عليك إضافة
ValueEventListener
إلى المرجع الذي أنشأته للتو.
يتم تشغيل طريقة onDataChange()
في هذه الفئة مرة واحدة عند تثبيت المستمع
ومرة أخرى في كل مرة تتغيّر فيها البيانات، بما في ذلك العناصر الفرعية.
Kotlin+KTX
// Read from the database myRef.addValueEventListener(object : ValueEventListener { override fun onDataChange(dataSnapshot: DataSnapshot) { // This method is called once with the initial value and again // whenever data at this location is updated. val value = dataSnapshot.getValue<String>() Log.d(TAG, "Value is: $value") } override fun onCancelled(error: DatabaseError) { // Failed to read value Log.w(TAG, "Failed to read value.", error.toException()) } })
Java
// Read from the database myRef.addValueEventListener(new ValueEventListener() { @Override public void onDataChange(@NonNull DataSnapshot dataSnapshot) { // This method is called once with the initial value and again // whenever data at this location is updated. String value = dataSnapshot.getValue(String.class); Log.d(TAG, "Value is: " + value); } @Override public void onCancelled(@NonNull DatabaseError error) { // Failed to read value Log.w(TAG, "Failed to read value.", error.toException()); } });
اختياري: ضبط ProGuard
عند استخدام Firebase Realtime Database في تطبيقك مع ProGuard، عليك مراعاة كيفية تسلسل عناصر النماذج وعكس تسلسلها بعد التشويش. إذا كنت تستخدم DataSnapshot.getValue(Class)
أو
DatabaseReference.setValue(Object)
لقراءة البيانات وكتابتها، عليك
إضافة قواعد إلى ملف proguard-rules.pro
:
# Add this global rule
-keepattributes Signature
# This rule will properly ProGuard all the model classes in
# the package com.yourcompany.models.
# Modify this rule to fit the structure of your app.
-keepclassmembers class com.yourcompany.models.** {
*;
}
للحصول على مساعدة بشأن الأسئلة أو المشاكل المتعلقة بـ ProGuard، يُرجى الانتقال إلى منتديات Guardsquare Community للحصول على مساعدة من خبير.
الاستعداد للإطلاق
قبل إطلاق تطبيقك، ننصحك بالاطّلاع على قائمة التحقّق من الإطلاق للتأكّد من أنّ تطبيقك جاهز للإطلاق.
احرص على تفعيل App Check لضمان وصول تطبيقاتك فقط إلى قواعد البيانات الخاصة بك.
الخطوات التالية
- تعرَّف على طريقة تنظيم البيانات في Realtime Database.
- توسيع نطاق بياناتك على مستوى نُسخ متعددة من قاعدة البيانات
- قراءة البيانات وكتابتها
- اطّلِع على قاعدة بياناتك في وحدة تحكّم Firebase.