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

Firebase Dynamic Links Builder API ile kısa veya uzun Dinamik Bağlantılar oluşturabilirsiniz. Bu API, uzun bir dinamik bağlantıyı veya dinamik bağlantı 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 dinamik bağlantıları 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ükleyin ve başlatı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ı kullanıyorsanız SHA-256 anahtarınızı da belirtin.

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

   1. Dinamik Bağlantılarınız için henüz bir alan adı ayarlamadıysanız Başlayın düğmesini tıklayın ve istemleri uygulayın.

      Daha önce bir Dinamik Bağlantılar alanınız varsa bunu not edin. Dinamik Bağlantıları programatik olarak 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. Bu sayede, yetkisiz tarafların alanınızdan kontrol etmediğiniz sitelere yönlendiren dinamik bağlantılar oluşturmasını önlersiniz.

      Belirli URL kalıplarına izin verme başlıklı makaleyi inceleyin.

Parametrelerden Dinamik Bağlantı oluşturma

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

Aşağıdaki minimum örnek, Android'de com.example.app.android ile ve iOS'te com.example.app.ios uygulamasıyla açılan https://www.example.com/ uzun bir dinamik bağlantı 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 Dynamic Link oluşturmak için DynamicLinkParameters nesnesini buildShortLink()'e iletin. Kısa bağlantı 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 dinamik bağlantılar yalnızca birkaç karakter uzunluğunda soneklerle oluşturulur. Bu durum bağlantıları daha kompakt hale getirse de geçerli bir kısa bağlantının tahmin edilebilme olasılığını da ortaya çıkarır. Bağlantı herkese açık bilgilere yönlendirdiği için genellikle bu durumun bir zararı yoktur.

Ancak kısa bağlantılarınız kullanıcıya özel bilgilere yönlendiriyorsa 17 karakterlik sonekler içeren daha uzun bağlantılar oluşturmanız gerekir. Bu sayede, geçerli bir Dinamik Bağlantı'nın tahmin edilmesi çok zorlaşır. Bunun için ShortDynamicLinkType.unguessable değerini buildShortLink() yöntemine iletin:

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

Dynamic Link parametreleri

Desteklenen parametrelerden herhangi biriyle Dinamik Bağlantılar oluşturmak için Dinamik Bağlantı Oluşturucu API'sini kullanabilirsiniz. API referansına bakın.

Aşağıdaki örnekte, birkaç yaygın parametrenin ayarlandığı bir dinamik bağlantı oluşturuluyor:

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