Deferred Navigation (Ertelenmiş Navigasyon) — nedir, ilkeleri ve uygulaması

Deferred Navigation Nedir

Deferred Navigation (Ertelenmiş Navigasyon), gerekli tüm veriler kullanılabilir olana kadar navigasyon kararının ertelendiği bir mimari modeldir. Kullanıcının bir düğmeye basıp hemen yeni bir ekrana ulaştığı doğrudan geçişin aksine, ertelenmiş navigasyon tetikleyici olay ile gerçek geçişi ayırır ve aralarına asenkron bir işlem yerleştirir.

Mimari olarak, Deferred Navigation durum değişikliği üzerine kuruludur: bir düğmeye basmak asenkron bir süreci başlatır ve sonucuna abone olmak navigasyonu tetikler. Bu, MVVM veya MVI mimarisine sahip uygulamalarda özellikle önemlidir; burada ViewModel durumu yönetir ve View (Activity, Fragment, SwiftUI View) değişikliklere abone olur ve bir geçişle yanıt verir. Bu yaklaşım, UI ile navigasyon mantığı arasındaki doğrudan bağımlılığı ortadan kaldırır.

Google I/O 2023'e göre, ertelenmiş navigasyon, navigasyonun bir ağ isteğinin sonucuna, kimlik doğrulama kontrolüne, yapılandırma yüklemeye veya izinlere bağlı olduğu tüm senaryolar için önerilir. Model ayrıca Deeplink'leri işlerken de zorunludur; uygulamanın önce başlatılması, kök ekranı yüklemesi ve ancak bundan sonra hedef rotaya gitmesi gerekir.

Ertelenmiş Navigasyon Ne Zaman Gerekir

Deferred Navigation, doğrudan navigasyonun yanlış ekran durumuna veya yükleme hatalarına yol açtığı senaryolarda kullanılır. Ertelenmiş navigasyonun gerekli olduğu dört ana durumu inceleyelim.

Yetkilendirme ve kimlik doğrulama

Bir kullanıcı korunan içeriğe dokunursa, uygulamanın önce erişim token'ını kontrol etmesi gerekir. Token'ın süresi dolmuşsa, içerik ekranına doğrudan navigasyon boş bir ekrana veya 401 hatasına yol açar. Ertelenmiş navigasyon token'ı kontrol eder ve yalnızca başarılı olursa — hedef ekrana gider. Başarısızlık durumunda — giriş ekranına yönlendirir.

Deeplink'lerin işlenmesi

Bir uygulama harici bir bağlantı yoluyla açıldığında, önce kök ekranı yüklemeli, navigasyon durumunu geri yüklemeli ve ancak bundan sonra Deeplink geçişini gerçekleştirmelidir. Kök bağlam olmadan hedef ekrana doğrudan navigasyon, anormalliklere yol açar: boş bir navigasyon yığını veya bozuk bir geri yığını.

İçerikli push bildirimleri

Bir push bildirimine dokunulduğunda, uygulama üç durumdan birinde olabilir: kapalı, arka planda veya aktif. Deferred Navigation, uygulamanın durumunu belirler, gerekli içeriği yükler ve ancak bundan sonra hedef ekranı gösterir. iOS, bu senaryonun UNNotificationContentExtension aracılığıyla işlenmesine izin verir.

Dinamik özellik bayrağı

Bir ekranın işlevselliği sunucudan gelen bir özellik bayrağı tarafından kontrol ediliyorsa, ertelenmiş navigasyon önce yapılandırmayı talep etmeye ve ancak bundan sonra ekranı göstermeye izin verir. Özellik devre dışıysa — kullanıcı boş bir ekran yerine alternatif içerik veya bir yer tutucu görür.

Deferred Navigation vs Doğrudan Navigasyon

Doğrudan navigasyon, bir olaya yanıt olarak geçişin hemen gerçekleştirildiği geleneksel bir yaklaşımdır. Kullanıcı bir düğmeye basar ve UI yönlendiricisi hemen ekranı değiştirir. Bu yaklaşım basit ve öngörülebilirdir ancak sunucudan veri veya koşul kontrolleri gerektiren senaryolarda sınırlıdır.

Deferred Navigation, asenkron durum biçiminde bir katman ekler. Bir kullanıcı olayı bir işlemi başlatır ve sonucuna abone olmak navigasyonu kontrol eder. Bu, kod karmaşıklığını artırır ancak esneklik sağlar: aynı tetikleyici, yüklenen verilere bağlı olarak farklı ekranlara yol açabilir.

İki yaklaşım arasındaki seçim gereksinimlere bağlıdır: bir ekranı görüntülemek asenkron veri gerektirmiyorsa — doğrudan navigasyon kullanın. Ekran bir isteğin, yetkilendirmenin veya dış koşulların sonucuna bağlıysa — ertelenmiş navigasyon gereklidir. Bazı geçişlerin doğrudan, bazılarının ertelenmiş olduğu hibrit bir yaklaşım, endüstriyel uygulamalarda en yaygın uygulamadır.

Android'de Uygulama: Navigation Component ve ViewModel

Android Jetpack, mimari düzeyde Deferred Navigation uygulamak için mekanizmalar sağlar. Temel fikir — ViewModel durumu yönetirken, Activity veya Fragment değişikliklere abone olur ve NavController aracılığıyla navigasyonu tetikler.

StateFlow ile Deferred Navigation

StateFlow Kotlin coroutine'lerinde ertelenmiş navigasyon için ideal araçtır. ViewModel, bir navigasyon olayıyla StateFlow'u günceller ve Activity onu gözlemler ve geçişi gerçekleştirir. Olay işlendiğinde, StateFlow temizlenir ve tekrarlanan navigasyon önlenir.

class MainViewModel : ViewModel() {
    private val _navigation = MutableSharedFlow<NavigationEvent>()
    val navigation: SharedFlow<NavigationEvent> = _navigation

    fun onDeepLinkReceived(link: String) {
        viewModelScope.launch {
            val data = resolveDeepLink(link)
            _navigation.emit(NavigationEvent.GoToScreen(data))
        }
    }
}

NavController ile Deferred Navigation

Activity'de, navigasyona abonelik, ViewModel'den gelen rota ile NavController'ı tetikler. Ekran döndürmede tekrarlanan navigasyonu önlemek için, olayı yalnızca bir kez işleyen bir NavigationEventWrapper sarmalayıcısı kullanılır. Jetpack Navigation 2.7+, tür güvenli argüman geçişi için Safe Args'yi destekler.

class MainActivity : AppCompatActivity() {
    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        val vm: MainViewModel by viewModels()
        repeatOnLifecycle(Lifecycle.State.STARTED) {
            vm.navigation.collect { event ->
                when (event) {
                    is NavigationEvent.GoToScreen ->
                        findNavController(R.id.nav_host)
                            .navigate(event.route)
                }
            }
        }
    }
}

iOS'te Uygulama: Coordinator Pattern ve Combine

iOS, Android Jetpack'e benzer yerleşik bir Navigation Component'e sahip değildir, bu nedenle geliştiriciler Deferred Navigation'ı Combine veya async/await ile birlikte Coordinator Pattern aracılığıyla uygular. Coordinator, ekran yığınını yönetir ve yüklenen verilere dayalı olarak navigasyon kararları alır.

Combine ile Coordinator

Coordinator, ViewController'lar arasındaki navigasyonu yöneten bir nesnedir. Combine ile birlikte, ViewModel olayları PassthroughSubject aracılığıyla yayınlar ve Coordinator bunlara abone olur ve geçişi gerçekleştirir. Bu yaklaşım, UI'yı navigasyon mantığından tamamen ayırır ve Apple'ın uygulama mimarisi önerilerini takip eder.

final class AppCoordinator {
    private var cancellables = Set<AnyCancellable>()

    func start(viewModel: MainViewModel) {
        viewModel.$navigationDestination
            .compactMap { $0 }
            .sink { [weak self] destination in
                self?.navigateTo(destination)
            }
            .store(in: &cancellables)
    }
}

async/await ile Deferred Navigation

Swift 5.5, Combine olmadan async/await aracılığıyla ertelenmiş navigasyon uygulamaya izin veren yapılandırılmış eşzamanlılığı tanıttı. ViewModel, verileri yükledikten sonra bir rota döndüren bir async işlevi sağlar. Coordinator, bu işlevi bir Task içinde çağırır ve alınan rotaya dayalı olarak geçişi gerçekleştirir.

class AuthViewModel: ObservableObject {
    func resolveDeeplink(_ url: URL) async -> AppRoute? {
        guard let token = await AuthService.shared.getValidToken() else { return .login }
        return await DeeplinkRouter.resolve(url, token: token)
    }
}

// In Coordinator:
Task {
    if let route = await viewModel.resolveDeeplink(url) {
        navigateTo(route)
    }
}

Yaygın Hatalar ve En İyi Uygulamalar

Deferred Navigation asenkron senaryoların işlenmesini basitleştirir ancak durum yönetimine disiplinli bir yaklaşım gerektirir. Geliştiricilerin ertelenmiş navigasyonu uygularken yaptığı ana hataları inceleyelim.

Hata: başlatma tamamlanmadan önce navigasyon

En yaygın hata — kök ekran tamamen başlatılmadan ve NavController veya Coordinator geçişe hazır olmadan önce ertelenmiş navigasyon gerçekleştirmeye çalışmak. Android'de bu IllegalStateException'a, iOS'te — tanımsız bir UI durumuna yol açar. Çözüm — navigasyonu tetiklemeden önce bileşenin yaşam döngüsünün STARTED veya RESUMED durumunda olduğundan emin olmaktır.

Hata: bir ekrana dönerken tekrarlanan navigasyon

StateFlow veya Subject işlemeden sonra olayı temizlemezse, önceki ekrana dönerken kullanıcı otomatik olarak aynı ekrana yönlendirilebilir. Android'de replay=0 ile SharedFlow veya iOS'te işlemeden sonra CurrentValueSubject'i nil ile kullanın, böylece navigasyon olayı yalnızca bir kez tetiklenir.

En İyi Uygulama: tek bir NavController veya Coordinator

Uygulamadaki tüm navigasyon için tek bir merkezi bileşen kullanın. Her Activity, Fragment veya ViewController'ın kendi navigasyon denetleyicisi olduğunda, uygulamanın farklı bölümleri arasındaki ertelenmiş navigasyon kaotik hale gelir. Tek bir Coordinator, navigasyon senaryolarının hata ayıklamasını ve test edilmesini basitleştirir.

En İyi Uygulama: ertelenmiş navigasyon senaryolarını test etme

Deferred Navigation, doğrudan navigasyondan daha zor test edilir çünkü asenkron işlemler bir zaman faktörü ekler. Veri yüklemeyi simüle etmek ve navigasyonun beklenen rotayı izlediğini doğrulamak için Android'de TestDispatcher (kotlinx-coroutines-test) ve iOS'te XCTestExpectation kullanın. Her senaryonun izole testi için yetkilendirme ve deeplink hizmetlerini taklit edin.