Bölüm 7 — Konu 31: Deep Linking

#Deep Linking Nedir?

Deep linking, uygulamanın dışından (bir web sitesi, bir push bildirimi, başka bir uygulama) gelen bir bağlantının, uygulamayı doğrudan belirli bir ekrana açmasıdır. Bölüm 7 Konu 29-30'da öğrendiğimiz bildirimsel navigasyon (go_router), bu özelliği temelde destekleyecek şekilde tasarlanmıştır — şimdi bunu gerçekten etkinleştirmeyi öğreneceğiz.

Somut örnekler:

• Bir e-posta bildiriminde "Siparişini Görüntüle" bağlantısına tıklandığında, uygulama doğrudan o siparişin detay ekranını açar.
• Bir arkadaşın paylaştığı bir ürün linkine tıklandığında, uygulama o ürünün sayfasında açılır.
• Bir web sayfasında "Uygulamada Aç" butonuna basıldığında, cihazda kurulu olan uygulama doğrudan ilgili içerikle açılır.

#İki Temel Deep Link Türü

#1. Custom URL Scheme (Özel URL Şeması)

myapp://urun/123

Bu, https:// yerine kendi tanımladığın bir "şema" (myapp://) kullanır. Basit ve eski bir yöntemdir, ama sınırlamaları vardır — eğer uygulama kurulu değilse, tarayıcı genelde hata verir (çünkü myapp:// diye bir protokolü tanımaz).

#2. Universal Links (iOS) / App Links (Android)

https://benimuygulamam.com/urun/123

Bu, gerçek bir HTTPS URL'sidir — eğer uygulama kuruluysa, işletim sistemi bunu otomatik olarak uygulamada açar; kurulu değilse, normal bir web sayfası olarak tarayıcıda açılır (bu web sayfası, App Store/Play Store'a yönlendirebilir). Bu, modern ve önerilen yaklaşımdır.

#Flutter'da Kurulum — Kavramsal Bakış

Deep linking'in platform tarafı kurulumu (Android/iOS native yapılandırması), Bölüm 1 Konu 3'te öğrendiğimiz android/ ve ios/ klasörlerinde yapılır — bunlar, günlük geliştirmede nadiren dokunduğumuz ama var olduğunu bildiğimiz klasörlerdi, hatırlarsan.

Android tarafında (android/app/src/main/AndroidManifest.xml):

<intent-filter android:autoVerify="true">
    <action android:name="android.intent.action.VIEW" />
    <category android:name="android.intent.category.DEFAULT" />
    <category android:name="android.intent.category.BROWSABLE" />
    <data android:scheme="https" android:host="benimuygulamam.com" />
</intent-filter>

iOS tarafında (ios/Runner/Info.plist ve Apple Developer hesabı ayarları):

• Associated Domains yapılandırması gerekir.

Bu native yapılandırmaların detaylarına girmiyoruz (bu, platform-spesifik bir konu ve resmi Flutter dokümantasyonunda güncel adımlarla takip edilmelidir) — önemli olan kavramsal olarak ne yaptıklarını anlamak: işletim sistemine, "bu domain'den gelen linkleri, benim uygulamamla aç" diye bildiriyorsun.

#go_router ile Deep Link'i Karşılama

Bölüm 7 Konu 30'da kurduğumuz GoRoute yapısı, aslında deep linking için zaten hazırdır:

final _router = GoRouter(
  routes: [
    GoRoute(path: '/', builder: (context, state) => AnaEkran()),
    GoRoute(
      path: '/urun/:id',
      builder: (context, state) => UrunDetayEkrani(urunId: state.pathParameters['id']!),
    ),
  ],
);

Eğer bir kullanıcı, https://benimuygulamam.com/urun/123 linkine tıklarsa (native yapılandırma doğru yapıldığında), işletim sistemi uygulamayı bu URL bilgisiyle başlatır, ve go_router, Bölüm 7 Konu 29'da öğrendiğimiz RouteInformationParser mekanizmasını (arka planda, senin görmeden) kullanarak, bu URL'yi doğrudan /urun/:id rotasıyla eşleştirip, UrunDetayEkrani'ni açar. Sen hiçbir ek kod yazmadan, sadece rotanı tanımlayarak, deep linking desteğine sahip oluyorsun — bu, go_router'ın en büyük pratik avantajlarından biridir.

#Uygulama Çalışırken Gelen Bir Deep Link — Dinleme

Uygulama zaten açıkken bir deep link tetiklenirse (örneğin başka bir uygulamadan paylaşılan bir link), bunu dinlemek için app_links gibi bir paket kullanılabilir:

flutter pub add app_links

import 'package:app_links/app_links.dart';

class DeepLinkDinleyici {
  final _appLinks = AppLinks();

  void dinlemeyeBasla(GoRouter router) {
    _appLinks.uriLinkStream.listen((uri) { // Dart Bölüm 10'u hatırla — Stream!
      router.go(uri.path);
    });
  }
}

uriLinkStream — Dart Bölüm 10 Konu 47'de öğrendiğimiz Stream kavramının gerçek bir kullanım alanı! Uygulama açıkken gelen her yeni deep link, bu stream'e bir "olay" olarak akar — .listen() ile (Dart Bölüm 10'u hatırla), her yeni link geldiğinde router.go(uri.path) ile anlık olarak o ekrana geçiş yapılır.

#Deep Linking + State Management — Bölüm 6'ya Bağlantı

Gerçek bir uygulamada, deep link ile açılan bir ekran, genelde belirli bir veriye ihtiyaç duyar (örneğin ürün detayı için, o ürünün bilgisini bir API'den çekmek gerekir — Bölüm 5'i hatırla). Bu, Bölüm 6'da öğrendiğimiz state management araçlarıyla doğal olarak birleşir:

GoRoute(
  path: '/urun/:id',
  builder: (context, state) {
    final id = state.pathParameters['id']!;
    return UrunDetayEkrani(urunId: id); // bu widget içinde, Bölüm 5'teki FutureBuilder ile veri çekilir
  },
)

UrunDetayEkrani, Bölüm 5 Konu 20-21'de öğrendiğimiz gibi, initState() içinde id'yi kullanarak API'den veri çeker — deep link ile açılmış olması, bu akışı hiç değiştirmez, çünkü go_router, sadece doğru widget'ı doğru parametrelerle oluşturmaktan sorumludur.

#URL Stratejisi — Web'de "#" (Hash) mi, Yoksa "Path" mi?

Flutter Web'de, varsayılan olarak URL'ler # (hash) içerir:

https://benimuygulamam.com/#/urun/123

Bunu, daha temiz bir URL'ye çevirmek istersen:

void main() {
  usePathUrlStrategy(); // go_router'dan gelen bir fonksiyon
  runApp(MyApp());
}

https://benimuygulamam.com/urun/123

usePathUrlStrategy(), tarayıcının native History API'sini kullanarak, # olmadan temiz URL'ler üretir. Bu, özellikle SEO (arama motoru optimizasyonu) ve paylaşılabilirlik açısından önemlidir — ama sunucu tarafında ek bir yapılandırma (tüm yolları index.html'e yönlendirmek) gerektirir, çünkü artık sunucunun /urun/123 gibi bir yolu doğrudan tanıması beklenir.

#🎯 Bu Dersten Çıkarılması Gerekenler

• Deep linking, uygulama dışından gelen bir bağlantının, doğrudan belirli bir ekranı açmasıdır.
• Universal Links/App Links (gerçek HTTPS URL'leri), eski Custom URL Scheme'lere göre daha modern ve güvenilir bir yaklaşımdır.
• go_router'ın GoRoute yapısı, ek kod yazmadan deep linking'i doğal olarak destekler — arka planda RouteInformationParser'ı kullanır.
• Uygulama çalışırken gelen deep link'ler, Stream tabanlı bir dinleyici (örn. app_links paketi) ile yakalanabilir.
• usePathUrlStrategy(), Flutter Web'de #'siz, temiz URL'ler üretir (sunucu tarafı ek yapılandırma gerektirir).

#📝 Ödevler

• [ ] Kendi cümlelerinle, Custom URL Scheme ile Universal/App Links arasındaki farkı ve neden ikincisinin tercih edildiğini açıkla.
• [ ] Bölüm 7 Konu 30'da kurduğun go_router yapısının, ek kod yazmadan neden deep linking'e "hazır" olduğunu açıkla.
• [ ] app_links paketiyle (veya kavramsal olarak, Stream mantığını kullanarak), uygulama açıkken gelen bir deep link'i dinleyen bir kod taslağı yaz.
• [ ] usePathUrlStrategy()'nin ne işe yaradığını ve neden sunucu tarafında ek yapılandırma gerektirdiğini kendi cümlelerinle açıkla.
• [ ] Kendi uygulaman için (hayali bir senaryo), hangi ekranların deep link ile açılabilir olması gerektiğini listele (örn. ürün detayı, profil, bir kampanya sayfası).

Sıradaki konu: Bölüm 7 — Konu 32: Repository Pattern, Katmanlı Mimari (Data/Domain/Presentation)