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ı parametreleri içeren bir nesneyi kabul eder ve aşağıdaki örneklere benzer 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 ayarlandıysa 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 başlatın.

2. Flutter projenizin kök dizininden Dynamic Links eklentisini yüklemek için 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 Dinamik Bağlantılar bölümünü açın.

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

      Zaten bir Dinamik Bağlantılar alanınız varsa bu alanı 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ı engellemiş olursunuz. 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()'ye iletin.

Aşağıdaki minimal örnekte, 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 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"),
  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()'a 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 Dynamic Links, yalnızca birkaç karakter uzunluğunda son eklerle oluşturulur. Bu, bağlantıların daha kompakt olmasını sağlar ancak geçerli bir kısa bağlantının tahmin edilme olasılığını da doğurur. Bağlantı herkese açık bilgilere yönlendirdiği için genellikle bu tür bağlantıların paylaşılmasında bir sakınca yoktur.

Ancak kısa bağlantılarınız kullanıcıya özel bilgilere yönlendiriyorsa 17 karakterlik son eklerle daha uzun bağlantılar oluşturmanız gerekir. Bu sayede, geçerli bir Dinamik Bağlantıyı tahmin etme olasılığı çok düşük olur. Bunun için ShortDynamicLinkType.unguessable değerini buildShortLink() yöntemine iletin:

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

Dinamik Bağlantı parametreleri

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

Aşağıdaki örnekte, birkaç yaygın parametre grubu içeren 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