Bu teknik rehber site için hazırlanmış editoryal içeriktir; Nihat Akbuğa’nın geçmişte yayımladığı bir makale veya belirli bir projenin iç mimarisi değildir.

Önce yerel veri

Bir saha uygulamasında bağlantı, kullanıcının kontrol edemediği bir değişkendir. Ekranın her açılışında ağ isteğinin sonucunu beklemek, çalışma deneyimini bu değişkene bağlar. Android’in offline-first rehberi, yerel veri kaynağını okuma işlemlerinin temel kaynağı olarak ele alır.

Yerel depoya yazılan bir sunucu yanıtı, arayüz tarafından gözlemlenebilir. Böylece veri okuma ile ağa erişim birbirinden ayrılır. Kullanıcı, son bilinen veriyi görürken güncelleme arka planda sürdürülebilir.

Durumu görünür kılmak

Yerel kayıt bulunması, verinin güncel olduğu anlamına gelmez. Arayüz; güncelleme sürüyor, son bilinen veri gösteriliyor ve işlem eşitleme bekliyor gibi durumları birbirine karıştırmamalıdır.

// Kavramsal örnek: üretim kodu değildir.
interface FieldRepository {
    fun observeTasks(): Flow<List<FieldTask>>
    suspend fun refresh()
}

Bu sınır, veriyi okuyan ekranın belirli bir HTTP istemcisine veya veritabanına bağımlı olmasını engeller. Ancak tek başına yazma çakışmalarını çözmez.

Yazma işlemleri ayrı bir karardır

Bağlantı yokken kullanıcı bir kayıt oluşturduğunda ürünün iş kuralları devreye girer. İşlem hemen yerel olarak kabul edilebilir, kuyrukta tutulabilir veya kritik bir işlem için bağlantı zorunlu olabilir. Her seçenek kullanıcıya açıkça anlatılmalıdır.

Tekrar denenen istekler yinelenen kayıt üretmemeli; bunun için sunucu tarafındaki idempotency yaklaşımı, istemcinin yeniden deneme politikasıyla birlikte tasarlanmalıdır. Çakışma çözümü ise verinin türüne göre belirlenir. Son yazanın kazanması her iş alanı için uygun değildir.

Neyi test etmeli?

Yalnızca uçak modunda ekran açmak yeterli değildir. İstek sürerken bağlantının kesilmesi, uygulamanın kapatılıp açılması, aynı kaydın farklı cihazlarda değiştirilmesi ve eski oturumla eşitleme denenmesi de ele alınmalıdır.

Testlerin amacı bir soyutlamanın varlığını doğrulamak değil, kullanıcının yaptığı işlemin kaybolmadığını ve durumun doğru anlatıldığını görmek olmalıdır.

Kaynak

Android Developers — Build an offline-first app. Bu yazı genel mühendislik ilkelerini açıklar; gerçek bir müşteri sisteminin ayrıntılarını içermez.