在 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