اربط تطبيقك بـ Firebase

إذا لم تكن قد قمت بذلك بالفعل، فأضف Firebase إلى مشروع Android الخاص بك .

إنشاء قاعدة بيانات

1. انتقل إلى قسم قاعدة بيانات الوقت الفعلي في وحدة تحكم Firebase . سيُطلب منك تحديد مشروع Firebase موجود. اتبع سير عمل إنشاء قاعدة البيانات.

2. حدد وضع البدء لقواعد أمان Firebase الخاصة بك:

   وضع الاختبار

   جيد للبدء في استخدام مكتبات عملاء الهاتف المحمول والويب، ولكنه يسمح لأي شخص بقراءة بياناتك والكتابة فوقها. بعد الاختبار، تأكد من مراجعة قسم فهم قواعد قاعدة بيانات Firebase Realtime .

   لبدء استخدام الويب أو Apple أو Android SDK، حدد وضع الاختبار.

   وضع مغلق

   ينكر جميع عمليات القراءة والكتابة من عملاء الهاتف المحمول والويب. لا يزال بإمكان خوادم التطبيقات المصادق عليها الوصول إلى قاعدة البيانات الخاصة بك.

3. اختر موقعًا لقاعدة البيانات.

   اعتمادًا على موقع قاعدة البيانات ، سيكون عنوان URL لقاعدة البيانات الجديدة بأحد الأشكال التالية:

   • DATABASE_NAME .firebaseio.com (لقواعد البيانات في us-central1 )

   • DATABASE_NAME . REGION .firebasedatabase.app (لقواعد البيانات في جميع المواقع الأخرى)

4. انقر فوق تم .

عند تمكين Realtime Database، فإنه يعمل أيضًا على تمكين واجهة برمجة التطبيقات (API) في Cloud API Manager .

أضف Realtime Database SDK إلى تطبيقك

dependencies {
    // Import the BoM for the Firebase platform
    implementation(platform("com.google.firebase:firebase-bom:32.6.0"))

    // 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")
}

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:20.3.0")
}

// Write a message to the database
val database = Firebase.database
val myRef = database.getReference("message")

myRef.setValue("Hello, World!")
MainActivity.kt

// Write a message to the database
FirebaseDatabase database = FirebaseDatabase.getInstance();
DatabaseReference myRef = database.getReference("message");

myRef.setValue("Hello, World!");
MainActivity.java

يمكنك حفظ نطاق من أنواع البيانات في قاعدة البيانات بهذه الطريقة، بما في ذلك كائنات Java. عند حفظ كائن، سيتم حفظ الاستجابات من أي حروف كعناصر فرعية لهذا الموقع.

اقرأ من قاعدة البيانات الخاصة بك

لتحديث بيانات تطبيقك في الوقت الفعلي، يجب عليك إضافة ValueEventListener إلى المرجع الذي أنشأته للتو.

يتم تشغيل طريقة onDataChange() في هذه الفئة مرة واحدة عند توصيل المستمع ومرة ​​أخرى في كل مرة تتغير فيها البيانات، بما في ذلك البيانات الفرعية.

// 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())
    }
})
MainActivity.kt

// 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());
    }
});
MainActivity.java

اختياري: قم بتكوين 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 للحصول على المساعدة من أحد الخبراء.

الاستعداد للإطلاق

قبل إطلاق تطبيقك، نوصي بالاطلاع على قائمة التحقق من الإطلاق للتأكد من أن تطبيقك جاهز للاستخدام!

تأكد من تمكين التحقق من التطبيق للمساعدة في التأكد من أن تطبيقاتك فقط هي التي يمكنها الوصول إلى قواعد البيانات الخاصة بك.

الخطوات التالية

• تعرف على كيفية تنظيم البيانات لقاعدة بيانات Realtime
• قم بقياس بياناتك عبر مثيلات قاعدة بيانات متعددة .
• قراءة وكتابة البيانات .
• عرض قاعدة البيانات الخاصة بك في وحدة تحكم Firebase .