在 Flutter 應用程式中建立 Dynamic Links

您可以使用 Firebase Dynamic Links Builder API 建立短或長的動態連結。這個 API 會接受長型動態連結或包含動態連結參數的物件，並傳回以下範例中的網址：

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

您必須先加入 Firebase SDK，才能在 Android 應用程式中建立動態連結。如果您的應用程式已設為接收 Dynamic Links，則您已完成這些步驟，因此可略過這一節。

  1. 如果您尚未安裝並初始化 Flutter 專用的 Firebase SDK，請先完成這項操作。

  2. 在 Flutter 專案的根目錄中執行下列指令，安裝 Dynamic Links 外掛程式：

    flutter pub add firebase_dynamic_links

  3. 如果您要建構 Android 應用程式，請開啟 Firebase 控制台的「Project settings」頁面，並確認您已指定 SHA-1 簽署金鑰。如果您使用應用程式連結，請一併指定 SHA-256 金鑰。

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

    1. 如果您尚未為動態連結設定網域，請按一下「開始使用」按鈕，然後按照提示操作。

      如果您已擁有動態連結網域，請記下網域名稱。透過程式碼建立動態連結時，您必須提供動態連結網域。

    2. 建議做法：透過「更多」(⋮) 選單，指定深層連結和備用連結允許的網址模式。這樣一來，您就能防止未經授權的對象建立動態連結，從您的網域重新導向至您無法控管的網站。

      請參閱「允許特定網址模式」。

如要建立動態連結，請建立新的 DynamicLinkParameters 物件，並將其傳遞至 buildLink() 或 buildShortLink()。

以下簡單範例會建立長的動態連結，以便在 Android 上透過 com.example.app.android 和 iOS 上的應用程式 com.example.app.ios 開啟 https://www.example.com/：

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

如要建立 Dynamic Link 短網址，請將 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);

根據預設，系統會產生簡短的 Dynamic Links，其中的後置字串只有幾個字元長度。雖然這可以讓連結更緊湊，但也可能導致使用者猜到有效的短連結。這種做法通常不會造成傷害，因為連結會導向公開資訊。

不過，如果短連結會導向使用者的資訊，您應建立長度為 17 個字元的加長連結，這樣他人就不太可能猜到有效的動態連結。如要這麼做，請將 ShortDynamicLinkType.unguessable 傳遞至 buildShortLink() 方法：

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

您可以使用 Dynamic Link Builder API，搭配任何支援的參數建立 Dynamic Links。請參閱 API 參考資料。

以下範例會建立 Dynamic Link，並設定幾個常見的參數：

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

您可以透過下列方法設定 Dynamic Link 參數：

DynamicLink 參數
setLink 應用程式會開啟的連結。指定應用程式可處理的網址，通常是應用程式內容或酬載，可啟動應用程式專屬邏輯 (例如使用優待券為使用者加分或顯示歡迎畫面)。這個連結必須是格式正確的網址，且經過正確的網址編碼，使用 HTTP 或 HTTPS，且不得是另一個動態連結。
setDomainUriPrefix 動態連結網址前置字串，可在 Firebase 控制台中找到。Dynamic Link 網域如以下範例所示：
https://example.com/link
https://example.page.link
AndroidParameters
setFallbackUrl 未安裝應用程式時開啟的連結。指定這個值，即可在未安裝應用程式時執行其他操作，例如開啟內容的行動版網頁版本，或顯示應用程式的宣傳頁面。
setMinimumVersion 可開啟連結的應用程式最低版本的 versionCode。如果安裝的應用程式為舊版，系統會將使用者帶往 Play 商店升級應用程式。
IosParameters
setAppStoreId 應用程式的 App Store ID，用於在使用者未安裝應用程式時將使用者導向 App Store
setFallbackUrl 未安裝應用程式時要開啟的連結。除了從 App Store 安裝應用程式之外，請指定這項要採用的處理方式，例如開啟行動版網站的內容版本，或顯示應用程式的宣傳頁面。
setCustomScheme 應用程式的自訂網址通訊協定 (如果已定義為應用程式的軟體包 ID 以外的值)
setIpadFallbackUrl 在未安裝應用程式的 iPad 上開啟的連結。指定這個值，即可在未安裝應用程式時，執行其他操作 (例如開啟內容的網頁版，或顯示應用程式的宣傳頁面)，而非從 App Store 安裝應用程式。
setIpadBundleId 在 iPad 上用來開啟連結的 iOS 應用程式軟體包 ID。應用程式必須透過 Firebase 主控台的總覽頁面連結至專案。
setMinimumVersion 可開啟連結的應用程式最低版本號碼。此標記會在應用程式開啟時傳遞至應用程式，而應用程式必須決定使用方式。
NavigationInfoParameters
setForcedRedirectEnabled 如果設為「1」，開啟動態連結時會略過應用程式預覽頁面，改為重新導向至應用程式或商店。應用程式預覽頁面 (預設為啟用) 可在使用者在應用程式中開啟動態連結時，將使用者帶往最適當的目的地。不過，如果您希望只在應用程式中開啟動態連結 (無需使用這個頁面)，可以透過這個參數停用該頁面。這個參數只會影響 iOS 版動態連結的行為。
SocialMetaTagParameters
setTitle 在社群媒體貼文中分享動態連結時使用的標題。
setDescription 在社群媒體貼文中分享動態連結時使用的說明。
setImageUrl 與此連結相關的圖片網址。圖片尺寸不得小於 300 x 200 像素，且大小不得超過 300 KB。
GoogleAnalyticsParameters
setSource
setMedium
setCampaign
setTerm
setContent		 Google Play 分析參數。這些參數 (`utm_source`、`utm_medium`、`utm_campaign`、`utm_term`、`utm_content`) 會傳遞至 Play 商店，並附加至連結酬載。
ItunesConnectAnalyticsParameters
setProviderToken
setAffiliateToken
setCampaignToken		 iTunes Connect 數據分析參數。這些參數 (``pt``、``at``、``ct``) 會傳送至 App Store。