Uygulamanızı Firebase'e bağlayın

Henüz yapmadıysanız Android projenize Firebase'i ekleyin .

Veritabanı Oluştur

  1. Firebase konsolunun Gerçek Zamanlı Veritabanı bölümüne gidin. Mevcut bir Firebase projesini seçmeniz istenecektir. Veritabanı oluşturma iş akışını izleyin.

  2. Firebase Güvenlik Kurallarınız için bir başlangıç ​​modu seçin:

    Test modu

    Mobil ve web istemci kitaplıklarını kullanmaya başlamak için iyidir ancak herkesin verilerinizi okumasına ve üzerine yazmasına olanak tanır. Test ettikten sonra Firebase Gerçek Zamanlı Veritabanı Kurallarını Anlayın bölümünü incelediğinizden emin olun.

    Web, Apple veya Android SDK'yı kullanmaya başlamak için test modunu seçin.

    Kilitli mod

    Mobil ve web istemcilerinden gelen tüm okuma ve yazma işlemlerini reddeder. Kimliği doğrulanmış uygulama sunucularınız hâlâ veritabanınıza erişebilir.

  3. Veritabanı için bir konum seçin.

    Veritabanının konumuna bağlı olarak yeni veritabanının URL'si aşağıdaki formlardan birinde olacaktır:

    • DATABASE_NAME .firebaseio.com ( us-central1 veritabanları için)

    • DATABASE_NAME . REGION .firebasedatabase.app (diğer tüm konumlardaki veritabanları için)

  4. Bitti'yi tıklayın.

Gerçek Zamanlı Veritabanını etkinleştirdiğinizde, Bulut API Yöneticisi'ndeki API de etkinleştirilir.

Gerçek Zamanlı Veritabanı SDK'sını uygulamanıza ekleyin

Modülünüzün (uygulama düzeyi) Gradle dosyasına (genellikle <project>/<app-module>/build.gradle.kts veya <project>/<app-module>/build.gradle ), Gerçek Zamanlı Veritabanı bağımlılığını ekleyin Android için kütüphane. Kitaplık sürümlerini kontrol etmek için Firebase Android BoM'yi kullanmanızı öneririz.

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

    // 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'yi kullandığınızda uygulamanız her zaman Firebase Android kitaplıklarının uyumlu sürümlerini kullanır.

(Alternatif) BoM'yi kullanmadan Firebase kitaplığı bağımlılıklarını ekleyin

Firebase BoM'yi kullanmamayı tercih ederseniz her Firebase kitaplığı sürümünü bağımlılık satırında belirtmeniz gerekir.

Uygulamanızda birden fazla Firebase kitaplığı kullanıyorsanız kitaplık sürümlerini yönetmek için tüm sürümlerin uyumlu olmasını sağlayan BoM'yi kullanmanızı önemle tavsiye ettiğimizi unutmayın.

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.1")
}
Kotlin'e özgü bir kütüphane modülü mü arıyorsunuz? Ekim 2023'ten itibaren (Firebase BoM 32.5.0) hem Kotlin hem de Java geliştiricileri ana kütüphane modülüne güvenebilecekler (ayrıntılar için bu girişimle ilgili SSS'ye bakın).

Gerçek Zamanlı Veritabanı Güvenliği Kurallarını Yapılandırma

Gerçek Zamanlı Veritabanı, verilerinizin nasıl yapılandırılması gerektiğini, nasıl dizine eklenmesi gerektiğini ve verilerinizin ne zaman okunup yazılabileceğini tanımlamanıza olanak tanıyan bildirim temelli bir kurallar dili sağlar.

Veritabanınıza yazın

getInstance() ı kullanarak veritabanınızın bir örneğini alın ve yazmak istediğiniz konuma başvurun.

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 nesneleri de dahil olmak üzere çeşitli veri türlerini bu şekilde veritabanına kaydedebilirsiniz. Bir nesneyi kaydettiğinizde, herhangi bir alıcıdan gelen yanıtlar bu konumun alt öğeleri olarak kaydedilecektir.

Veritabanınızdan okuyun

Uygulama verilerinizin gerçek zamanlı olarak güncellenmesini sağlamak için yeni oluşturduğunuz referansa bir ValueEventListener eklemelisiniz.

Bu sınıftaki onDataChange() yöntemi, dinleyici eklendiğinde bir kez ve çocuklar da dahil olmak üzere veriler her değiştiğinde yeniden tetiklenir.

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());
    }
});

İsteğe bağlı: ProGuard'ı yapılandırın

Firebase Realtime Database'i uygulamanızda ProGuard ile birlikte kullanırken, model nesnelerinizin gizleme sonrasında nasıl serileştirileceğini ve seri durumdan çıkarılacağını düşünmeniz gerekir. Verileri okumak ve yazmak için DataSnapshot.getValue(Class) veya DatabaseReference.setValue(Object) kullanıyorsanız proguard-rules.pro dosyasına kurallar eklemeniz gerekir:

    # 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 ile ilgili soru veya sorunlar konusunda yardım almak için Guardsquare Topluluğu forumlarını ziyaret ederek bir uzmandan yardım alın.

Lansmana Hazırlan

Uygulamanızı başlatmadan önce, uygulamanızın kullanıma hazır olduğundan emin olmak için başlatma kontrol listemizi gözden geçirmenizi öneririz!

Veritabanlarınıza yalnızca uygulamalarınızın erişebildiğinden emin olmak için Uygulama Denetimini etkinleştirdiğinizden emin olun.

Sonraki adımlar