在 Flutter 應用程式中建立動態鏈接

您可以使用 Firebase 動態連結產生器 API 建立短動態連結或長動態連結。此 API 接受長動態連結或包含動態連結參數的對象，並傳回如下範例所示的 URL：

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

設定 Firebase 和動態連結 SDK

您必須先包含 Firebase SDK，然後才能在 Android 應用程式中建立動態連結。如果您的應用程式設定為接收動態鏈接，則您已經完成了這些步驟，並且可以跳過此部分。

1. 如果您尚未安裝並初始化適用於 Flutter 的 Firebase SDK，請執行此操作。

2. 從 Flutter 專案的根目錄中，執行以下命令來安裝 Dynamic Links 外掛程式：

   flutter pub add firebase_dynamic_links
   

3. 如果您正在建立 Android 應用程式，請開啟 Firebase 控制台的專案設定頁面，並確保您已指定 SHA-1 簽章金鑰。如果您使用應用程式鏈接，也請指定您的 SHA-256 金鑰。

4. 在 Firebase 控制台中，開啟動態連結部分。

   1. 如果您尚未為動態連結設定網域，請按一下「開始」按鈕並依照指示操作。

      如果您已有動態連結網域，請記下它。以程式設計方式建立動態連結時，您需要提供動態連結網域。

   2. 建議：從「更多」(⋮) 選單中，指定深層連結和後備連結中允許的 URL 模式。透過這樣做，您可以防止未經授權的各方建立從您的網域重定向到您無法控制的網站的動態連結。

      請參閱允許特定 URL 模式。

從參數建立動態鏈接

要建立動態鏈接，請建立一個新的DynamicLinkParameters物件並將其傳遞給buildLink()或buildShortLink() 。

以下最小範例建立一個指向https://www.example.com/長動態鏈接，在 Android 上使用com.example.app.android打開，在 iOS 上使用應用程式com.example.app.ios打開：

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);

若要建立短動態鏈接，請將DynamicLinkParameters物件傳遞給buildShortLink() 。建立短連結需要網路呼叫。例如：

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);

預設情況下，產生的短動態連結的後綴只有幾個字元長。雖然這使得連結更加緊湊，但它也帶來了有人猜測有效短連結的可能性。通常，如果有人這樣做並沒有什麼壞處，因為該連結會指向公共資訊。

但是，如果您的短鏈接指向特定於用戶的信息，則您應該創建帶有 17 個字符後綴的較長鏈接，這樣別人就不太可能猜出有效的動態鏈接。為此，請將ShortDynamicLinkType.unguessable傳遞給buildShortLink()方法：

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

動態連結參數

您可以使用動態連結產生器 API 透過任何支援的參數建立動態連結。請參閱API 參考。

以下範例建立具有多個常用參數集的動態連結：

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);

您可以透過以下方法設定動態連結參數：

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