برنامه خود را به Firebase وصل کنید

اگر هنوز Firebase را به پروژه اندروید خود اضافه نکرده‌اید، آن را اضافه کنید.

ایجاد یک پایگاه داده

1. به بخش Realtime Database در کنسول Firebase بروید. از شما خواسته می‌شود که یک پروژه Firebase موجود را انتخاب کنید. مراحل ایجاد پایگاه داده را دنبال کنید.

2. یک حالت شروع برای Firebase Security Rules خود انتخاب کنید:

   حالت تست

   برای شروع کار با کتابخانه‌های کلاینت موبایل و وب خوب است، اما به هر کسی اجازه می‌دهد داده‌های شما را بخواند و بازنویسی کند. پس از آزمایش، حتماً بخش «درک قوانین پایگاه داده بلادرنگ Firebase» را مرور کنید.

   برای شروع کار با وب، اپل یا اندروید SDK، حالت آزمایشی (testmode) را انتخاب کنید.

   حالت قفل شده

   تمام خواندن‌ها و نوشتن‌ها را از کلاینت‌های موبایل و وب رد می‌کند. سرورهای برنامه‌ی کاربردی تأیید شده‌ی شما همچنان می‌توانند به پایگاه داده‌ی شما دسترسی داشته باشند.

3. مکانی را برای پایگاه داده انتخاب کنید.

   بسته به موقعیت مکانی پایگاه داده ، URL پایگاه داده جدید به یکی از شکل‌های زیر خواهد بود:

   • DATABASE_NAME .firebaseio.com (برای پایگاه‌های داده در us-central1 )

   • DATABASE_NAME . REGION .firebasedatabase.app (برای پایگاه‌های داده در تمام مکان‌های دیگر)

4. روی انجام شد کلیک کنید.

وقتی Realtime Database فعال می‌کنید، API را نیز در Cloud API Manager فعال می‌کند.

کیت توسعه نرم‌افزار (SDK) Realtime Database را به برنامه خود اضافه کنید.

dependencies {
    // Import the BoM for the Firebase platform
    implementation(platform("com.google.firebase:firebase-bom:34.4.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:22.0.1")
}

// 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

شما می‌توانید طیف وسیعی از انواع داده‌ها، از جمله اشیاء جاوا را به این روش در پایگاه داده ذخیره کنید. وقتی یک شیء را ذخیره می‌کنید، پاسخ‌های هر getter به عنوان فرزندان این مکان ذخیره می‌شوند.

از پایگاه داده خود بخوانید

برای اینکه داده‌های برنامه‌تان به صورت بلادرنگ به‌روزرسانی شوند، باید یک 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.** {
      *;
    }