İçeriğe geç
Çılgın Yazılım

Mobil ve Oyun Geliştirme kod örnekli

Mobil Uygulamada Derin Bağlantı (Deep Link) Kurmanın Doğru Yolu

Bildirime tıklayan kullanıcı ana ekrana düşüyorsa derin bağlantı kurulumunuz eksiktir. Şema, doğrulama ve yönlendirme adım adım.

Çılgın Yazılım 5 dk okuma

Mobil Uygulamada Derin Bağlantı (Deep Link) Kurmanın Doğru Yolu
İçindekiler
  1. İki farklı mekanizma, sık karıştırılır
  2. Android tarafı: assetlinks.json
  3. iOS tarafı: apple-app-site-association
  4. Sunucu tarafında doğru servis etme
  5. Uygulama içinde: tek bir yönlendirme tablosu
  6. Oturum sorunu: en çok atlanan adım
  7. Test etmeden yayınlamayın
  8. Sonuç
  9. Pratik Uygulama Kontrol Listesi
  10. Sık Yapılan Yanlışlar
  11. Sonuç
  12. İlgili Yazılar

Derin bağlantı, bir adresin uygulamayı açıp kullanıcıyı doğrudan ilgili ekrana götürmesidir. Kulağa küçük bir ayrıntı gibi gelir, ama kullanıcı yolculuğunda en çok kayıp veren yerlerden biri tam burasıdır: bildirime tıklayan kişi sipariş detayını değil ana ekranı görür ve aradığını bulmak için baştan gezinmek zorunda kalır.

Derin bağlantı akışının kırılma noktaları
Beş halkanın biri kopunca kullanıcı hep ana ekranda uyanır.

İki farklı mekanizma, sık karıştırılır

Özel şema (myapp://siparis/123) kurulumu kolaydır ama zayıftır: uygulama kurulu değilse bağlantı hiçbir şey yapmaz ve başka bir uygulama aynı şemayı ilan edebilir. Universal Link (iOS) / App Link (Android) ise normal bir https adresidir; sistem, alan adınızda barındırılan bir doğrulama dosyasına bakarak bağlantıyı uygulamanıza yönlendirir. Uygulama yoksa aynı adres tarayıcıda açılır — yani bağlantı hiçbir zaman kırılmaz.

Üretim için tercih net: https tabanlı bağlantı kullanın. Özel şemayı yalnızca uygulama içi geçişler için saklayın.

Android, https://alanadiniz.com/.well-known/assetlinks.json dosyasını okur. Dosya, uygulama imza parmak izinizi içerir.

JSON
[{
  "relation": ["delegate_permission/common.handle_all_urls"],
  "target": {
    "namespace": "android_app",
    "package_name": "com.sirket.uygulama",
    "sha256_cert_fingerprints": [
      "1A:2B:3C:4D:5E:6F:70:81:92:A3:B4:C5:D6:E7:F8:09:1A:2B:3C:4D:5E:6F:70:81:92:A3:B4:C5:D6:E7:F8:09"
    ]
  }
}]

Manifest tarafında adres kalıbını ilan edersiniz:

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="alanadiniz.com"
        android:pathPrefix="/siparis" />
</intent-filter>

iOS tarafı: apple-app-site-association

iOS aynı işi /.well-known/apple-app-site-association dosyasıyla yapar. Dosyanın uzantısı olmamalı ve application/json tipiyle sunulmalıdır.

JSON
{
  "applinks": {
    "apps": [],
    "details": [{
      "appID": "TEAMID123.com.sirket.uygulama",
      "paths": ["/siparis/*", "/kampanya/*", "NOT /siparis/yardim"]
    }]
  }
}

Sunucu tarafında doğru servis etme

En sık yapılan hata, bu iki dosyanın yönlendirme (redirect) arkasında kalması veya yanlış içerik tipiyle sunulmasıdır. İkisi de doğrulamayı sessizce başarısız kılar. CodeIgniter'da açık bir rota tanımlamak en güvenli yoldur:

PHP
$routes->get('.well-known/assetlinks.json', static function () {
    return service('response')
        ->setContentType('application/json')
        ->setBody(file_get_contents(WRITEPATH . 'mobil/assetlinks.json'));
});

Uygulama içinde: tek bir yönlendirme tablosu

Bağlantıyı yakalamak yetmez; hangi adresin hangi ekrana gideceğini tek bir yerde tanımlamak gerekir. Dağınık if zincirleri zamanla kaçınılmaz olarak ayrışır.

JavaScript
const ROTALAR = [
  { kalip: /^\/siparis\/(\d+)$/,   ekran: 'SiparisDetay', param: (m) => ({ id: m[1] }) },
  { kalip: /^\/kampanya\/([\w-]+)$/, ekran: 'Kampanya',   param: (m) => ({ slug: m[1] }) },
];

export function baglantiyiCoz(url) {
  const yol = new URL(url).pathname;

  for (const r of ROTALAR) {
    const m = yol.match(r.kalip);
    if (m) return { ekran: r.ekran, params: r.param(m) };
  }

  return { ekran: 'AnaSayfa', params: {} };   // bilinmeyen adres → güvenli varsayılan
}

Adres kalıplarını düzenli ifadeyle eşleştirmek ilk bakışta korkutucu gelebilir; düzenli ifadeleri korkmadan kullanmak yazımız bu kalıpları okumayı kolaylaştıran bir yaklaşım sunuyor.

Uygulama içinde çok sayıda kısa ömürlü nesne üreten ekranlarda nesne havuzu deseni akıcılığı korur.

Oturum sorunu: en çok atlanan adım

Kullanıcı bağlantıya tıkladığında oturumu kapalı olabilir. Doğru davranış, hedefi hatırlayıp giriş sonrası oraya dönmektir. Aksi hâlde giriş ekranından sonra ana sayfaya düşen kullanıcı, bağlantının hiç çalışmadığını düşünür. Bu davranışı bir kez merkezî olarak kurun; her ekranda tekrar yazmak, mağaza incelemesinde tutarsız akış olarak geri dönebilir.

Test etmeden yayınlamayın

Bash
# Android: bağlantıyı doğrudan tetikle
adb shell am start -a android.intent.action.VIEW \
  -d "https://alanadiniz.com/siparis/123" com.sirket.uygulama

# Android: doğrulama durumunu gör
adb shell pm get-app-links com.sirket.uygulama

# iOS Simulator
xcrun simctl openurl booted "https://alanadiniz.com/siparis/123"

Platform gereksinimlerinin güncel hâli için Android App Links belgeleri başvuru kaynağıdır. Platform seçimi hâlâ tartışmadaysa native mi cross-platform mı karşılaştırmamız kararı netleştirebilir.

Sonuç

Derin bağlantı beş halkalı bir zincirdir: şema ilanı, alan adı doğrulaması, doğru içerik tipiyle servis, uygulama içi yönlendirme tablosu ve oturum sonrası hedefe dönüş. Halkalardan biri koptuğunda belirti hep aynıdır — kullanıcı ana ekranda uyanır — ama sebep her seferinde farklıdır. Kurulumu yaparken her adımı ayrı ayrı test edin, özellikle doğrulama dosyalarının yönlendirme arkasında kalmadığını kontrol edin. Bir sonraki kampanya bildiriminizde tıklama sonrası hedefe varış oranını ölçün; bu tek sayı, kurulumun gerçekten çalışıp çalışmadığını her şeyden net söyler.

Pratik Uygulama Kontrol Listesi

Bu yazıdaki önerileri kendi ekibinize uyarlarken aşağıdaki adımları sırasıyla uygulamanız, teoriden pratiğe geçişi kolaylaştırır:

  1. Mevcut durumu ölçün. Değişiklik yapmadan önce bugünkü performansı/süreyi/hata oranını kaydedin; aksi halde iyileşmeyi kanıtlayamazsınız.
  2. Küçük bir pilot seçin. Tüm sisteme veya tüm ekibe birden uygulamak yerine tek bir modülde veya tek bir sprintte deneyin.
  3. Sonuçları ekiple paylaşın. Elde ettiğiniz veriyi (olumlu ya da olumsuz) kısa bir notla ekibe aktarın; kararın gerekçesi belgelenmemişse aynı tartışma birkaç ay sonra tekrar açılır.
  4. Süreci tekrarlanabilir hale getirin. İşe yarayan pratiği bir kontrol listesine veya şablona dönüştürün ki yeni katılan ekip üyeleri de aynı standardı hızlıca öğrensin.

Derin Bağlantı konusunda attığınız her küçük adım ölçülebilir olduğu sürece değerlidir; büyük ve tek seferlik dönüşümler yerine sürekli, küçük iyileştirmeler uzun vadede daha kalıcı sonuç verir.

Sık Yapılan Yanlışlar

Bu konuda ekiplerin en çok düştüğü tuzak, çözümü tek bir kişiye ya da tek bir araca yüklemektir. Oysa kalıcı iyileşme, sürecin ekibin günlük rutinine (code review kontrol listesi, sprint planlama, onboarding dokümanı gibi) gömülmesiyle mümkün olur. İkinci yaygın hata ise "en iyi pratiği" olduğu gibi kopyalamaktır — başka bir ekipte işe yarayan bir yaklaşım, farklı bir ölçekte veya farklı bir teknoloji yığınında aynı sonucu vermeyebilir; önce kendi bağlamınızda küçük ölçekte test edin, sonra genişletin. Üçüncü tuzak ise ölçmeden karar vermektir: "daha iyi hissettiriyor" öznel bir gerekçedir, ekip içi tartışmalarda nesnel veriyle desteklenmeyen kararlar er ya da geç sorgulanır ve geri alınır. Son olarak, dokümantasyonu atlamak da sık görülen bir hatadır: bir kararın "neden" alındığı yazılı değilse, ekip altı ay sonra aynı tartışmayı sıfırdan yeniden yapmak zorunda kalır ve önceki deneyimden öğrenilenler kaybolur.

Sonuç

Mobil Uygulamada Derin Bağlantı (Deep Link) Kurmanın Doğru Yolu konusunda burada değindiğimiz noktalar, konuyu ilk kez ele alan ekipler için de deneyimli geliştiriciler için de pratik bir kontrol listesi görevi görür. derin bağlantı üzerine çalışırken en çok fayda sağlayan yaklaşım, tek seferde her şeyi mükemmelleştirmeye çalışmak yerine küçük, ölçülebilir adımlarla ilerlemektir. Ekibinizde bu konuyu bir sonraki sprint retrospektifinde veya teknik tartışma toplantısında gündeme getirmenizi, burada anlatılan pratiklerden hangilerinin sizin bağlamınıza uyduğunu birlikte değerlendirmenizi öneririz. Sonuç olarak, doğru araçları seçmek kadar bunları ekip kültürüne oturtmak da başarıyı belirleyen asıl etkendir.

İlgili Yazılar

Beğeniniz benzer içerikleri öne çıkarmamıza yardımcı olur.

Sık sorulan sorular

Derin bağlantı ile universal link arasındaki fark tam olarak nedir?

Derin bağlantı genel kavramdır; universal link ise Apple'ın https tabanlı, alan adı doğrulamalı uygulamasıdır. Android tarafındaki karşılığı App Links'tir. Özel şemalı bağlantılar da bir tür derin bağlantıdır ama doğrulanmadıkları için başka uygulamalar tarafından sahiplenilebilir.

Uygulama kurulu değilse ne olur?

https tabanlı bağlantı kullanıyorsanız adres normal bir web sayfası olarak açılır — bu sayfada mağaza yönlendirmesi gösterebilirsiniz. Özel şema kullanıyorsanız hiçbir şey olmaz, bu da kullanıcı için sessiz bir hata deneyimidir.

Doğrulama dosyasını güncelledim ama çalışmıyor, neden?

En yaygın üç sebep: dosyanın yönlendirme arkasında olması, yanlış içerik tipiyle sunulması ve imza parmak izinin yayın anahtarı yerine hata ayıklama anahtarından alınmış olması. Android tarafında pm get-app-links komutu doğrulamanın hangi aşamada takıldığını gösterir.

Derin bağlantılar güvenlik riski oluşturur mu?

Adresten gelen parametrelere doğrulamasız güvenirseniz evet. Gelen kimlik değerlerinin o kullanıcıya ait olup olmadığını sunucu tarafında mutlaka kontrol edin; aksi hâlde bağlantıyı elle değiştiren biri başka kullanıcının kaydını açmayı deneyebilir.

Yazan

Çılgın Yazılım

Ben Evren Çılgın; yazılım geliştirme, web teknolojileri ve sistem tasarımı alanlarında uzmanlaşmış bir geliştiriciyim. Uzun yıllardır hem frontend hem de backend tarafında üretken, ölçeklenebilir ve kullanıcı dostu çözümler üretiyorum.

Hakkımızda Bize ulaşın

Bu konuda bir projeniz mi var?

İhtiyacınızı birkaç cümleyle anlatın; uygun yaklaşımı birlikte belirleyelim.

Projenizi Anlatın

İlgili yazılar

Yorumlar

Henüz yorum yok. Sorunuzu ya da deneyiminizi ilk siz yazın.

Yorum yazın

Yorumunuz onaylandıktan sonra yayınlanır. Ekibimiz gerekirse konuyla ilgili bir yanıt da paylaşır.

Yayınlanmaz; yalnızca gerektiğinde size ulaşmak için.

En az 10 karakter.

Tüm yazılar