在 Flutter 應用中創建動態鏈接

您可以使用 Firebase Dynamic Links Builder API 創建短動態鏈接或長動態鏈接。此 API 接受長動態鏈接或包含動態鏈接參數的對象，並返回如下例所示的 URL：

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

設置 Firebase 和動態鏈接 SDK

在您的 Android 應用程序中創建動態鏈接之前，您必須包含 Firebase SDK。如果您的應用設置為接收動態鏈接，則您已完成這些步驟，可以跳過此部分。

1. 如果您還沒有安裝並初始化 Firebase SDKs for Flutter，請執行此操作。

2. 在 Flutter 項目的根目錄中，運行以下命令來安裝動態鏈接插件：

   flutter pub add firebase_dynamic_links
   

3. 如果您正在構建 Android 應用程序，請打開 Firebase 控制台的項目設置頁面並確保您已指定 SHA-1 簽名密鑰。如果您使用 App Links，還請指定您的 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,
);

動態鏈接參數

您可以使用 Dynamic Link Builder 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