Henüz yapmadıysanız Firebase'i Android projenize ekleyin.
Veritabanı Oluşturma
Firebase konsolunun Realtime Database bölümüne gidin. Mevcut bir Firebase projesini seçmeniz istenir. Veritabanı oluşturma iş akışını takip edin.
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 idealdir, ancak herkesin verilerinizi okumasına ve üzerine yazmasına olanak tanır. Testten sonra Firebase Gerçek Zamanlı Veritabanı Kurallarını Anlama bölümünü mutlaka inceleyin.
Web, Apple veya Android SDK'yı kullanmaya başlamak için testmode'u seçin.
- Kilitli mod
Mobil istemcilerden ve web istemcilerinden tüm okuma ve yazma işlemlerini reddeder. Kimliği doğrulanmış uygulama sunucularınız, veritabanınıza erişmeye devam edebilir.
Veritabanı için bir konum seçin.
Veritabanının konumuna bağlı olarak yeni veritabanının URL'si aşağıdaki biçimlerden birinde olur:
(DATABASE_NAME.firebaseio.com
us-central1
konumundaki veritabanları için) (diğer tüm konumlardaki veritabanları için)DATABASE_NAME.REGION.firebasedatabase.app
Done'ı (Bitti) tıklayın.
Realtime Database'i etkinleştirdiğinizde Cloud API Manager'da da API etkinleştirilir.
Realtime Database SDK'sını uygulamanıza ekleyin
Modül (uygulama düzeyinde) Gradle dosyanıza (genellikle<project>/<app-module>/build.gradle.kts
veya <project>/<app-module>/build.gradle
), Android için Realtime Database kitaplığına bağımlılığı ekleyin. Kitaplık sürümünü kontrol etmek için Firebase Android BoM'u kullanmanızı öneririz.
dependencies { // Import the BoM for the Firebase platform implementation(platform("com.google.firebase:firebase-bom:33.1.2")) // 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 kullanıldığında uygulamanız Firebase Android kitaplıklarının her zaman uyumlu sürümlerini kullanır.
(Alternatif) BoM'u kullanmadan Firebase kitaplığı bağımlılıklarını ekleme
Firebase BoM'yi kullanmamayı seçerseniz 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 BoM kullanmanızı önemle tavsiye ederiz. Böylece tüm sürümlerin uyumlu olması sağlanır.
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 Güvenlik Kurallarını Yapılandırma
Realtime Database, verilerinizin nasıl yapılandırılacağını, nasıl dizine eklenmesi gerektiğini ve verilerinizin ne zaman okunup yazılabileceğini tanımlamanıza olanak tanıyan bildirim temelli bir kural dili sunar.
Veritabanınıza yazma
getInstance()
kullanarak veritabanınızın bir örneğini alın ve yazmak istediğiniz konuma referans verin.
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!");
Bu şekilde, Java nesneleri de dahil olmak üzere çeşitli veri türlerini veritabanına kaydedebilirsiniz. Bir nesneyi kaydettiğinizde, alıcılardan gelen yanıtlar bu konumun alt öğeleri olarak kaydedilir.
Veritabanınızdan okuma
Uygulama verilerinizin gerçek zamanlı olarak güncellenmesini sağlamak için az önce oluşturduğunuz referansa ValueEventListener
eklemeniz gerekir.
Bu sınıftaki onDataChange()
yöntemi, işleyici eklendiğinde bir kez ve alt öğeler dahil olmak üzere veriler her değiştiğinde tekrar 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ırma
Uygulamanızda ProGuard ile birlikte Firebase Realtime Database kullanırken model nesnelerinizin kod karartma işleminden sonra nasıl serileştirileceğini ve seri durumdan çıkarılacağını göz önünde bulundurmanız gerekir. Veri okumak ve yazmak için DataSnapshot.getValue(Class)
veya DatabaseReference.setValue(Object)
kullanıyorsanız proguard-rules.pro
dosyasına kural 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ınız için yardım almak isterseniz bir uzmandan yardım almak için Guardsquare Topluluk forumlarını ziyaret edin.
Lansmana Hazırlanın
Uygulamanızı kullanıma sunmadan önce, yayınlanmaya hazır olduğundan emin olmak için lansman kontrol listemizi gözden geçirmenizi öneririz.
Veritabanlarınıza yalnızca uygulamalarınızın erişebilmesi için Uygulama Kontrolü'nü etkinleştirdiğinizden emin olun.