Bölüm 7 — Konu 29: Navigator 2.0 (Router, RouteInformationParser, RouterDelegate)

Bölüm 7'ye hoş geldin. Bu ders, Flutter'ın en karmaşık konularından birine giriyor — dürüst olmak gerekirse, bu dersten sonra öğreneceğin go_router paketi, günlük geliştirmede çok daha sık kullanacağın araç olacak. Ama Navigator 2.0'ın temel mantığını anlamak, go_router'ın neden var olduğunu ve nasıl çalıştığını kavraman için değerli.

#Navigator 1.0'ın Sınırlaması — Neden Navigator 2.0 Var?

Bölüm 3 Konu 14'te öğrendiğimiz Navigator.push()/pop() (buna "Navigator 1.0" denir), zorunlu (imperative) bir yaklaşımdır — sen adım adım, "şimdi şu ekrana git" diyorsun. Bu, basit uygulamalarda gayet iyi çalışır, ama şu senaryolarda zayıf kalır:

1. Web'de URL senkronizasyonu — Bir web tarayıcısında, kullanıcı geri/ileri tuşlarını kullandığında, ya da doğrudan bir URL'ye giriş yaptığında, uygulamanın doğru ekranı göstermesi gerekir. Navigator 1.0'ın "adım adım push/pop" mantığı, bunu doğal olarak desteklemez.
2. Deep linking — Bir bildirime tıklandığında, uygulamayı doğrudan belirli bir ekrana (örneğin bir ürün detayına) açmak, Navigator 1.0'da karmaşık, elle yönetilen bir süreç gerektirir.

Navigator 2.0, bunun yerine bildirimsel (declarative) bir yaklaşım sunar — Dart Bölüm 13 Konu 59'da öğrendiğimiz pattern matching'in felsefesine benzer bir mantık: "şu anki durum bu, Flutter sen anla nasıl gösterileceğini."

#Üç Ana Bileşen

Navigator 2.0, üç ana parçadan oluşur — bunları kavramsal olarak anlayalım (elle tam bir implementasyon yazmak, gerçekten nadiren gerekir, go_router bunu senin için yapar).

#1. RouteInformationParser — URL'yi "Anlamlı Veriye" Çevirme

class UygulamaRotaAyristirici extends RouteInformationParser<UygulamaRotaKonfigurasyonu> {
  @override
  Future<UygulamaRotaKonfigurasyonu> parseRouteInformation(RouteInformation routeInformation) async {
    final uri = routeInformation.uri;
    if (uri.pathSegments.isEmpty) {
      return UygulamaRotaKonfigurasyonu.anaSayfa();
    }
    if (uri.pathSegments[0] == 'urun') {
      final id = uri.pathSegments[1];
      return UygulamaRotaKonfigurasyonu.urunDetay(id);
    }
    return UygulamaRotaKonfigurasyonu.bilinmeyen();
  }
}

Bu, Dart Bölüm 7'de öğrendiğimiz extends ile Flutter'ın kendi soyut sınıfından (Bölüm 7 Konu 34'ü hatırla — soyut sınıflar bir "sözleşme" tanımlar) türetilmiş bir class. Görevi, bir URL string'ini (/urun/123 gibi), uygulamanın anlayacağı bir Dart nesnesine (UygulamaRotaKonfigurasyonu) çevirmek — tıpkı Bölüm 5 Konu 21'de öğrendiğimiz fromJson()'un, JSON'u bir Dart nesnesine çevirmesi gibi bir dönüşüm işlemi.

#2. RouterDelegate — "Şu Anki Duruma Göre Hangi Ekranları Göstermeli?"

class UygulamaRouterDelegate extends RouterDelegate<UygulamaRotaKonfigurasyonu>
    with ChangeNotifier { // Dart Bölüm 7'de öğrendiğimiz MIXIN, Bölüm 6'da gördüğümüz ChangeNotifier!

  UygulamaRotaKonfigurasyonu _konfigurasyon = UygulamaRotaKonfigurasyonu.anaSayfa();

  @override
  Widget build(BuildContext context) {
    return Navigator(
      pages: [
        MaterialPage(child: AnaEkran()),
        if (_konfigurasyon.urunId != null)
          MaterialPage(child: UrunDetayEkrani(id: _konfigurasyon.urunId!)),
      ],
      onDidRemovePage: (page) {
        _konfigurasyon = UygulamaRotaKonfigurasyonu.anaSayfa();
        notifyListeners();
      },
    );
  }
  // ... diğer zorunlu metodlar
}

Çok önemli bir gözlem: with ChangeNotifier — Bölüm 6 Konu 24'te öğrendiğimiz ChangeNotifier, burada state management dışında, navigasyon durumunu yönetmek için de kullanılıyor! Bu, Bölüm 7 Konu 36'da (Dart) öğrendiğimiz mixin'in gerçek bir Flutter kullanımı.

pages: [...] — Bu, Navigator 1.0'ın "push/pop" mantığından temel bir sapma: burada sen, "o anki state'e göre hangi sayfaların yığında (stack) olması gerektiğini" bir liste olarak bildiriyorsun — Dart Bölüm 4'te öğrendiğimiz List<Widget> (burada List<Page>) mantığı. Flutter, bu listeyi önceki listeyle karşılaştırıp (Bölüm 1 Konu 1'de öğrendiğimiz diffing mekanizmasına benzer), hangi sayfaların eklenip/çıkarılacağına kendisi karar verir.

#3. MaterialApp.router — Hepsini Birleştirme

MaterialApp.router(
  routerDelegate: UygulamaRouterDelegate(),
  routeInformationParser: UygulamaRotaAyristirici(),
)

Bölüm 3 Konu 10'da öğrendiğimiz MaterialApp(home: ...) yerine, MaterialApp.router(...) — Dart Bölüm 6 Konu 27'de öğrendiğimiz named constructor kalıbının, Flutter'ın kendi framework'ünde gerçek bir kullanımı! MaterialApp.router, MaterialApp'in navigasyonu Navigator 2.0'a devreden alternatif bir oluşturma yoludur.

#Neden Bu Kadar Karmaşık Görünüyor?

Bu üç bileşeni elle yazmak, dürüst olmak gerekirse, çok fazla "boilerplate" (tekrarlayan, zorunlu) kod gerektirir — zorunlu metodları implemente etmek, state senkronizasyonunu elle yönetmek gibi. Bu tam olarak Bölüm 7 Konu 30'da öğreneceğin go_router'ın var olma sebebidir — go_router, Navigator 2.0'ın gücünü (bildirimsel navigasyon, web URL desteği, deep linking) korurken, bu karmaşıklığı büyük ölçüde gizler.

#Navigator 1.0 vs Navigator 2.0 — Ne Zaman Hangisi?

Pratik gerçek: Bugün, Navigator 2.0'ı tamamen elle yazan geliştirici nadirdir — bunun yerine, hemen herkes go_router (veya benzer bir paket) kullanır. Bu dersin amacı, go_router'ı kullanırken "arka planda ne oluyor" sorusuna cevap verebilmen ve karşılaştığın hataları (özellikle web/deep linking ile ilgili) daha derinlemesine anlayabilmendir.

#🎯 Bu Dersten Çıkarılması Gerekenler

• Navigator 1.0, zorunlu (imperative) "adım adım" navigasyon sunar; web URL senkronizasyonu ve deep linking'de zayıf kalır.
• Navigator 2.0, bildirimsel (declarative) bir yaklaşımla, "o anki state'e göre hangi sayfalar gösterilmeli" mantığıyla çalışır.
• RouteInformationParser, bir URL'yi anlamlı bir Dart nesnesine çevirir; RouterDelegate, bu nesneye göre hangi sayfaların gösterileceğine karar verir ve ChangeNotifier mixin'ini kullanır.
• MaterialApp.router, bu ikisini birleştiren named constructor'dır.
• Navigator 2.0'ı elle yazmak yoğun boilerplate gerektirir — pratikte neredeyse herkes go_router gibi bir paket kullanır (bir sonraki dersimiz).

#📝 Ödevler

• [ ] Kendi cümlelerinle, "Navigator 1.0'ın push/pop mantığı ile Navigator 2.0'ın bildirimsel yaklaşımı arasındaki temel felsefe farkını" açıkla.
• [ ] RouteInformationParser'ın görevini, Dart'ta öğrendiğimiz fromJson() kalıbıyla karşılaştırarak açıkla.
• [ ] RouterDelegate'in neden ChangeNotifier kullandığını, Bölüm 6'da öğrendiğin state management bilgisiyle ilişkilendir.
• [ ] Basit bir RouteInformationParser taslağı yaz (en az 2 farklı URL yolu ayrıştıran), çalıştırmana gerek yok, sadece mantığı pratik et.
• [ ] Kendi cümlelerinle, "neden pratikte çoğu geliştirici Navigator 2.0'ı elle yazmak yerine go_router kullanıyor" sorusuna cevap ver.

Sıradaki konu: Bölüm 7 — Konu 30: go_router Paketi (Pratik ve Modern Çözüm)