Router — iOS ve Android'de yönlendirme deseni temelleri

Router Nedir: Yönlendirme Deseninin Özü

Router — ekranlar arası geçiş mantığını kapsülleyen bir desen. Temel fikir: ViewController (veya Presenter/ViewModel) doğrudan navigationController.pushViewController'ı çağırmaz, bunun yerine Router'a navigasyon niyetini bildirir. Router hangi ViewController'ın oluşturulacağına ve nasıl görüntüleneceğine karar verir. Router basit (bir dizi navigasyon yöntemi) veya karmaşık (URL şeması yönlendirmesi, deep link'ler ve push bildirimleriyle) olabilir.

Router'a üç yaklaşım — Hizmet olarak Router (küresel Navigator singleton), Modül bileşeni olarak Router (VIPER yaklaşımı), Protokol olarak Router (Coordinator için soyutlama). Küresel Router — basitlik (uygulama başına bir örnek) — küçük projelerde popüler. Modüler Router — her özelliğin kendi Router'ı — VIPER ve Clean Architecture standardı. Protokol Router — Coordinator'da kullanılır: push/present/pop/dismiss yöntemleriyle RouterProtocol.

Desenin tarihi — Router web çerçevelerinde (URL Router — Rails Routes, Express.js) ortaya çıktı ve mobil geliştirme için uyarlandı. iOS'ta, Router VIPER'in (2015-2017) yükselişiyle popüler hale geldi. Android'de, Router Jetpack Navigation'ın (2018) bir parçasıdır, Google'ın standart navigasyon çözümüdür. Bugün, Router herhangi bir modüler mobil uygulama mimarisinin ayrılmaz bir parçasıdır.

iOS'ta Router: Swift ile Uygulama

iOS Router — çeşitli navigasyon türleri için yöntemler içeren bir protokol. Temel uygulama UINavigationController'ı sarar. Router, kalıcı sunumları (present/dismiss), navigasyon yığınında push/pop, Split View Controller için showDetail ve tam ekran sunumları (iOS 13+) işleyebilir. Router ViewController oluşturmaz — hazır bir örnek alır ve görüntüler. ViewController oluşturma bir fabrika (Assembly, DI kabı) veya Coordinator tarafından yapılır.

// iOS için RouterProtocol
protocol RouterProtocol {
    func push(_ viewController: UIViewController, animated: Bool)
    func pop(animated: Bool)
    func popToRoot(animated: Bool)
    func present(_ viewController: UIViewController, animated: Bool)
    func dismiss(animated: Bool)
    func setViewControllers(_: [UIViewController], animated: Bool)
}

// UINavigationController aracılığıyla Router uygulaması
class NavigationRouter: RouterProtocol {
    private let navigationController: UINavigationController

    init(navigationController: UINavigationController) {
        self.navigationController = navigationController
    }

    func push(_ vc: UIViewController, animated: Bool) {
        if navigationController.presentedViewController {
            navigationController.dismiss(animated: false)
        }
        navigationController.pushViewController(vc, animated: animated)
    }

    func pop(animated: Bool) {
        navigationController.popViewController(animated: animated)
    }

    func popToRoot(animated: Bool) {
        navigationController.popToRootViewController(animated: animated)
    }

    func present(_ vc: UIViewController, animated: Bool) {
        navigationController.present(vc, animated: animated)
    }

    func dismiss(animated: Bool) {
        navigationController.dismiss(animated: animated)
    }

    func setViewControllers(_ vcs: [UIViewController], animated: Bool) {
        navigationController.setViewControllers(vcs, animated: animated)
    }
}

// Assembly — Router ile modül oluşturma
protocol ProfileModuleFactory {
    func makeProfileView() -> UIViewController
}

VIPER'da Router — her VIPER modülünün, mevcut modülden hangi ekranların açılacağını bilen kendi Router'ı vardır. Router, bir fabrika aracılığıyla sonraki modülün ViewController'ını oluşturur ve kontrolü devreder. VIPER'da Router, import UIKit içeren tek bileşendir (View hariç). Bu, Presenter ve Interactor'ın test edilmesini basitleştirir: UIKit'e bağlı değildirler.

Android'de Router: Jetpack Navigation Component

Jetpack Navigation Component — 2018'den beri Google tarafından önerilen Android için standart yönlendirici. Navigasyon bir XML grafiğinde (nav_graph.xml) tanımlanır: düğümler (fragments, activities, destinations) ve kenarlar (actions). NavController geçişleri yönetir: FragmentManager.replace/add'i çağırır ve geri yığını yönetir. Navigation Component, deep link'leri, argümanları, geçiş animasyonlarını ve type-safe veri iletimi için Safe Args'ı destekler.

// nav_graph.xml — navigasyon grafiği
<!-- @xml/nav_graph.xml -->
<navigation xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:app="http://schemas.android.com/apk/res-auto"
    android:id="@+id/nav_graph"
    app:startDestination="@id/loginFragment">

    <fragment android:id="@+id/loginFragment"
        android:name=".ui.login.LoginFragment">
        <action android:id="@+id/to_home"
            app:destination="@id/homeFragment" />
    </fragment>

    <fragment android:id="@+id/homeFragment"
        android:name=".ui.home.HomeFragment">
        <argument android:name="userId"
            android:defaultValue="0"
            app:argType="integer" />
        <deepLink app:uri="myapp://home/{userId}" />
    </fragment>
</navigation>

// Kotlin — NavController aracılığıyla navigasyon
class LoginFragment : Fragment() {
    override fun onViewCreated(view: View, savedInstanceState: Bundle?) {
        super.onViewCreated(view, savedInstanceState)
        binding.loginButton.setOnClickListener {
            val action = LoginFragmentDirections.toHome(userId = 42)
            findNavController().navigate(action)
        }
    }
}

// Safe Args — type-safe argümanlar
class HomeFragmentArgs : NavArgs {
    val userId: Int get() = arguments?.getInt("userId") ?: 0
}

// NavigationUI — Toolbar, BottomNav, Drawer ile entegrasyon
class MainActivity : AppCompatActivity() {
    private lateinit var navController: NavController

    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        val navHost = supportFragmentManager
            .findFragmentById(R.id.nav_host_fragment) as NavHostFragment
        navController = navHost.navController
        NavigationUI.setupActionBarWithNavController(this, navController)
    }
}

Android Navigation'da Deep link'ler — Navigation Component, açık deep link'leri (PendingIntent + NavDeepLinkBuilder) ve örtük deep link'leri (manifest'te intent-filter aracılığıyla) destekler. Bir deep link, nav_graph'ın herhangi bir düğümüne gidebilir. Push bildirimi işleme: Notification, NavDeepLinkBuilder ile bir PendingIntent oluşturur, geri yığını geri yükler ve istenen ekranı açar. Navigation Component, Up/Back düğmelerini otomatik olarak işler ve kullanıcıyı önceki ekrana döndürür.

URL Routing: Deeplink ve Universal Link Yönlendirme

URL Routing — URL şemalarına, deep link'lere ve universal link'lere dayalı yönlendirme. Uygulama bir şema (myapp://profile/42) veya universal link (https://example.com/profile/42) kaydeder. Router URL'yi ayrıştırır, parametreleri (userId=42) çıkarır ve ilgili ekranı açar. URL Routing, uygulamanın dışarıdan açılmasına izin verir: bir web sitesi bağlantısı, e-posta, push bildirimi, QR kodu aracılığıyla. iOS, NSUserActivity + universal link kullanır, Android — intent-filter + deep link.

// URL Router — deep link ayrıştırma ve navigasyon
protocol URLRoute {
    var pattern: String { get }
    func navigate(parameters: [String: String], router: RouterProtocol)
}

struct ProfileRoute: URLRoute {
    let pattern = "myapp://profile/{userId}"

    func navigate(parameters: [String: String], router: RouterProtocol) {
        guard let userId = parameters["userId"] else { return }
        let profileVC = ProfileViewController(userId: userId)
        router.push(profileVC, animated: true)
    }
}

// URL Router — URL'leri yollarla eşleme
class URLRouter {
    private var routes: [URLRoute] = []

    func handle(_ url: URL, router: RouterProtocol) {
        for route in routes {
            if let params = matchPattern(route.pattern, url: url) {
                route.navigate(parameters: params, router: router)
                return
            }
        }
    }
}

Pratikte Deep link yönlendirme — uygulama, deep link'leri üç durumda işlemelidir: çalışmıyor (deep link ile başlatma), arka planda (arka plandan geri yükleme), aktif (onNewIntent/SceneDelegate). URL Router, geri yığını doğru şekilde geri yüklemelidir: bir profil ekranına deep link yapıldığında, kullanıcı Geri tuşuna basarak önceki ekrana dönebilmelidir. iOS ve Android geri yığınları farklı şekilde işler — Router, platforma özgü özellikleri dikkate almalıdır.

Router'ın Coordinator ve Navigator ile Karşılaştırması

Router vs Coordinator — Router "bir ekran nasıl gösterilir?" (push/present) sorusuna yanıt verir, Coordinator — "hangi ekran gösterilir?" (hangi akış başlatılır). Router bir navigasyon aracıdır, Coordinator bir akış düzenleyicisidir. Coordinator, Router'ı kullanır. VIPER'da, Router her iki işlevi de yerine getirir: nereye gidileceğine ve nasıl gösterileceğine karar verir. MVVM-C'de, Router, Coordinator tarafından kullanılan ayrı bir protokoldür. Desenler birbirini dışlamaz, tamamlar.

Router vs Navigator — Navigator, iOS topluluğunda Router'ın eski bir adıdır. İlk uygulamalarda, Navigator navigasyon yöntemleri olan bir Singleton sınıfıydı. Navigator, küresel bir Router singleton'dır. Navigator daha basittir ancak gizli bağımlılıklar yaratır. Protokol tabanlı Router daha test edilebilir ve modülerdir. Navigator katı mimarisi olmayan projeler için uygundur, Router — Clean Architecture ve VIPER için.