Flutter uygulamasında Dinamik Bağlantılar oluşturma

Firebase Dynamic Links Builder API ile kısa veya uzun Dynamic Links oluşturabilirsiniz. Bu API, uzun bir Dynamic Link'i veya Dynamic Link parametrelerini içeren bir nesneyi kabul eder ve aşağıdaki örneklerdeki gibi URL'ler döndürür:

https://example.com/link/WXYZ
https://example.page.link/WXYZ

Firebase ve Dynamic Links SDK'sını ayarlar

Android uygulamanızda Dynamic Links oluşturabilmek için Firebase SDK'sını eklemeniz gerekir. Uygulamanız Dynamic Links'i alacak şekilde ayarlanmışsa bu adımları zaten tamamlamışsınızdır ve bu bölümü atlayabilirsiniz.

1. Henüz yapmadıysanız Flutter için Firebase SDK'larını yükleyip ilk kullanıma hazırlayın.

2. Dynamic Links eklentisini yüklemek için Flutter projenizin kök dizininden aşağıdaki komutu çalıştırın:

   flutter pub add firebase_dynamic_links
   

3. Android uygulaması geliştiriyorsanız Firebase konsolunun Proje ayarları sayfasını açın ve SHA-1 imzalama anahtarınızı belirttiğinizden emin olun. Uygulama Bağlantıları'nı kullanıyorsanız SHA-256 anahtarınızı da belirtin.

4. Firebase konsolunda Dynamic Links bölümünü açın.

   1. Dynamic Links için henüz bir alan oluşturmadıysanız Başlayın düğmesini tıklayın ve talimatları uygulayın.

      Zaten bir Dynamic Links alanınız varsa bunu not edin. Programatik olarak Dynamic Links oluştururken bir Dynamic Links alanı sağlamanız gerekir.

   2. Önerilen: "Diğer" (⋮) menüsünden, derin bağlantılarınızda ve yedek bağlantılarınızda izin verilen URL kalıplarını belirtin. Bunu yaparak yetkisiz tarafların, alanınızdan kontrol etmediğiniz sitelere yönlendiren Dynamic Links oluşturmasını engellersiniz.

      Belirli URL kalıplarına izin verme bölümünü inceleyin.

Parametrelerden Dynamic Link oluşturma

Dinamik Bağlantı oluşturmak için yeni bir DynamicLinkParameters nesnesi oluşturun ve bunu buildLink() veya buildShortLink() yöntemine iletin.

Aşağıdaki minimal örnek, Android'de com.example.app.android ve iOS'te com.example.app.ios uygulamasıyla açılan https://www.example.com/ için uzun bir Dynamic Link oluşturur:

final dynamicLinkParams = DynamicLinkParameters(
  link: Uri.parse("https://www.example.com/"),
  uriPrefix: "https://example.page.link",
  androidParameters: const AndroidParameters(packageName: "com.example.app.android"),
  iosParameters: const IOSParameters(bundleId: "com.example.app.ios"),
);
final dynamicLink =
    await FirebaseDynamicLinks.instance.buildLink(dynamicLinkParams);

Kısa bir Dinamik Bağlantı oluşturmak için DynamicLinkParameters nesnesini buildShortLink() yöntemine iletin. Kısa bağlantıyı oluşturmak için ağ çağrısı gerekir. Örneğin:

final dynamicLinkParams = DynamicLinkParameters(
  link: Uri.parse("https://www.example.com/"),
  uriPrefix: "https://example.page.link",
  androidParameters: const AndroidParameters(packageName: "com.example.app.android"),
  iosParameters: const IOSParameters(bundleId: "com.example.app.ios"),
);
final dynamicLink =
    await FirebaseDynamicLinks.instance.buildShortLink(dynamicLinkParams);

Varsayılan olarak, kısa Dynamic Links yalnızca birkaç karakter uzunluğunda olan son eklerle oluşturulur. Bu sayede bağlantılar daha kısa hale gelse de bir kullanıcının geçerli bir kısa bağlantıyı tahmin etme olasılığı da ortaya çıkar. Bağlantı herkese açık bilgilere yönlendirdiği için genellikle bu durumun bir zararı olmaz.

Ancak kısa bağlantılarınız kullanıcıya özel bilgilere yönlendiriyorsa 17 karakterlik son ekler içeren daha uzun bağlantılar oluşturmanız gerekir. Böylece, geçerli bir Dynamic Link'in tahmin edilmesi neredeyse imkansız hale gelir. Bunun için buildShortLink() yöntemine ShortDynamicLinkType.unguessable değerini iletin:

final unguessableDynamicLink = await FirebaseDynamicLinks.instance.buildShortLink(
    dynamicLinkParams,
    shortLinkType: ShortDynamicLinkType.unguessable,
);

Dynamic Link parametreleri

Desteklenen parametrelerden herhangi birini içeren Dynamic Links oluşturmak için Dynamic Link Builder API'yi kullanabilirsiniz. API referansına bakın.

Aşağıdaki örnekte, birkaç yaygın parametre ayarlanarak bir Dinamik Bağlantı oluşturulmaktadır:

final dynamicLinkParams = DynamicLinkParameters(
  link: Uri.parse("https://www.example.com/"),
  uriPrefix: "https://example.page.link",
  androidParameters: const AndroidParameters(
    packageName: "com.example.app.android",
    minimumVersion: 30,
  ),
  iosParameters: const IOSParameters(
    bundleId: "com.example.app.ios",
    appStoreId: "123456789",
    minimumVersion: "1.0.1",
  ),
  googleAnalyticsParameters: const GoogleAnalyticsParameters(
    source: "twitter",
    medium: "social",
    campaign: "example-promo",
  ),
  socialMetaTagParameters: SocialMetaTagParameters(
    title: "Example of a Dynamic Link",
    imageUrl: Uri.parse("https://example.com/image.png"),
  ),
);
final dynamicLink =
    await FirebaseDynamicLinks.instance.buildShortLink(dynamicLinkParams);

Dinamik Bağlantı parametrelerini aşağıdaki yöntemlerle ayarlayabilirsiniz:

https://example.com/link
https://example.page.link