Router — основи патерну маршрутизації в iOS та Android

Що таке Router: суть патерну маршрутизації

Router — патерн, який інкапсулює логіку переходу між екранами. Основна ідея: ViewController (або Presenter/ViewModel) не викликає navigationController.pushViewController безпосередньо, а повідомляє Router про намір перейти. Router вирішує, який ViewController створити і як його відобразити. Router може бути простим (набір методів для навігації) або складним (з маршрутизацією за URL-схемами, deep link'ами та push-сповіщеннями).

Три підходи до Router — Router як сервіс (глобальний Navigator-синглтон), Router як компонент модуля (VIPER-підхід), Router як протокол (абстракція для Coordinator). Глобальний Router — простота (один екземпляр на застосунок) — популярний у невеликих проєктах. Модульний Router — кожна фіча має свій Router — стандарт VIPER та Clean Architecture. Протокольний Router — використовується в Coordinator: RouterProtocol з методами push/present/pop/dismiss.

Історія патерну — Router з'явився у веб-фреймворках (URL Router — Rails Routes, Express.js) і був адаптований для мобільної розробки. В iOS Router став популярним з ростом VIPER (2015-2017). В Android Router — частина Jetpack Navigation (2018), стандартного рішення Google для навігації. Зараз Router — невід'ємна частина будь-якої модульної архітектури мобільних застосунків.

Router в iOS: реалізація на Swift

iOS Router — протокол з методами для різних типів навігації. Базова реалізація обгортає UINavigationController. Router може керувати модальними презентаціями (present/dismiss), push/pop у стеку навігації, showDetail для Split View Controller та повноекранними презентаціями (iOS 13+). Router не створює ViewController — він отримує готовий екземпляр і відображає його. Створенням ViewController займається фабрика (Assembly, DI-контейнер) або Coordinator.

// RouterProtocol для iOS
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)
}

// Реалізація Router через UINavigationController
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
protocol ProfileModuleFactory {
    func makeProfileView() -> UIViewController
}

Router у VIPER — кожен VIPER-модуль має власний Router, який знає, які екрани відкривати з поточного модуля. Router створює ViewController наступного модуля через фабрику та передає керування. Router у VIPER — єдиний компонент, який містить import UIKit (крім View). Це спрощує тестування Presenter та Interactor: вони не залежать від UIKit.

Router в Android: Jetpack Navigation Component

Jetpack Navigation Component — стандартний роутер для Android, рекомендований Google з 2018 року. Навігація визначається в XML-графі (nav_graph.xml): вузли (fragments, activities, destinations) та ребра (actions). NavController керує переходами: викликає FragmentManager.replace/add та керує стеком повернення. Navigation Component підтримує deep links, аргументи, анімації переходів та Safe Args для типобезпечної передачі даних.

// nav_graph.xml — граф навігації
<!-- @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
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 — типобезпечні аргументи
class HomeFragmentArgs : NavArgs {
    val userId: Int get() = arguments?.getInt("userId") ?: 0
}

// NavigationUI — інтеграція з Toolbar, BottomNav, Drawer
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)
    }
}

Deep links в Android Navigation — Navigation Component підтримує явні deep links (PendingIntent + NavDeepLinkBuilder) та неявні (через intent-filter у маніфесті). Deep link може вести на будь-який вузол nav_graph. Обробка push-сповіщень: Notification створює PendingIntent з NavDeepLinkBuilder, який відновлює стек повернення та відкриває потрібний екран. Navigation Component автоматично обробляє кнопки Up/Back та повертає користувача на попередній екран.

URL Routing: Deeplink та Universal Link маршрутизація

URL Routing — маршрутизація на основі URL-схем, deep link'ів та universal link'ів. Застосунок реєструє схему (myapp://profile/42) або universal link (https://example.com/profile/42). Router парсить URL, витягує параметри (userId=42) та відкриває відповідний екран. URL Routing дозволяє відкривати застосунок ззовні: за посиланням з вебсайту, електронної пошти, push-сповіщення, QR-коду. iOS використовує NSUserActivity + universal link, Android — intent-filter + deep link.

// URL Router — парсинг deep link та навігація
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 з маршрутами
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
            }
        }
    }
}

Deep link маршрутизація на практиці — застосунок повинен обробляти deep link у трьох станах: не запущено (запуск з deep link), у фоні (відновлення з background), активно (onNewIntent/SceneDelegate). URL Router повинен коректно відновлювати стек повернення: при deep link на екран профілю користувач повинен мати можливість натиснути Back і повернутися на попередній екран. iOS та Android по-різному обробляють стек повернення — Router повинен враховувати платформенні особливості.

Порівняння Router з Coordinator та Navigator

Router vs Coordinator — Router відповідає на питання «як показати екран?» (push/present), Coordinator — «який екран показати?» (який flow запустити). Router — інструмент навігації, Coordinator — організатор flow. Coordinator використовує Router. У VIPER Router виконує обидві функції: вирішує, куди перейти і як показати. У MVVM-C Router — окремий протокол, який використовує Coordinator. Патерни не виключають, а доповнюють один одного.

Router vs Navigator — Navigator — старіша назва Router в iOS-спільноті. У ранніх реалізаціях Navigator був Singleton-класом з методами переходів. Navigator — це глобальний Router-синглтон. Navigator простіший, але створює приховані залежності. Router на протоколах — тестованіший і модульніший. Navigator підходить для проєктів без суворої архітектури, Router — для Clean Architecture та VIPER.