Join us in person and online for Firebase Summit on October 18, 2022. Learn how Firebase can help you accelerate app development, release your app with confidence, and scale with ease. Register now

在 Flutter 應用中創建動態鏈接

透過集合功能整理內容 你可以依據偏好儲存及分類內容。

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

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

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

  1. 如果您尚未安裝並初始化 Flutter 的 Firebase SDK

  2. 在 Flutter 項目的根目錄中,運行以下命令來安裝 Dynamic Links 插件:

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

您可以通過以下方法設置動態鏈接參數:

動態鏈接參數
設置鏈接您的應用將打開的鏈接。指定您的應用程序可以處理的 URL,通常是應用程序的內容或負載,它會啟動特定於應用程序的邏輯(例如向用戶提供優惠券或顯示歡迎屏幕)。此鏈接必須是格式正確的 URL、正確的 URL 編碼、使用 HTTP 或 HTTPS,並且不能是另一個動態鏈接。
setDomainUriPrefix您可以在 Firebase 控制台中找到您的動態鏈接網址前綴。動態鏈接域類似於以下示例:
https://example.com/link
https://example.page.link
安卓參數
setFallbackUrl未安裝應用程序時打開的鏈接。指定此項以在未安裝應用程序時從 Play 商店安裝應用程序以外的其他操作,例如打開內容的移動 Web 版本,或顯示應用程序的促銷頁面。
設置最小版本可以打開鏈接的應用的最低版本的 versionCode。如果安裝的應用程序是舊版本,則用戶將被帶到 Play 商店以升級應用程序。
IOS參數
設置AppStoreId您應用的 App Store ID,用於在未安裝應用時將用戶引導至 App Store
setFallbackUrl未安裝應用程序時打開的鏈接。指定此項以在未安裝應用程序時從 App Store 安裝應用程序以外的其他操作,例如打開內容的移動 Web 版本,或顯示應用程序的促銷頁面。
設置自定義方案您的應用的自定義 URL 方案(如果定義為您的應用的捆綁包 ID 以外的內容)
setIpadFallbackUrl未安裝應用程序時在 iPad 上打開的鏈接。指定此項以在未安裝應用程序時從 App Store 安裝應用程序以外的其他操作,例如打開內容的 Web 版本,或顯示應用程序的促銷頁面。
setIpadBundleId用於在 iPad 上打開鏈接的 iOS 應用程序的捆綁包 ID。該應用必須從 Firebase 控制台的概覽頁面連接到您的項目。
設置最小版本可以打開鏈接的應用的最低版本號。此標誌在打開時傳遞給您的應用程序,您的應用程序必須決定如何處理它。
導航信息參數
setForcedRedirectEnabled如果設置為“1”,則在打開動態鏈接時跳過應用預覽頁面,而是重定向到應用或商店。應用預覽頁面(默認啟用)在用戶打開應用中的動態鏈接時,可以更可靠地將用戶引導至最合適的目的地;但是,如果您希望僅在可以在沒有此頁面的情況下可靠地打開動態鏈接的應用中打開動態鏈接,則可以使用此參數禁用它。此參數只會影響動態鏈接在 iOS 上的行為。
社交元標記參數
設置標題在社交帖子中共享動態鏈接時使用的標題。
設置描述在社交帖子中共享動態鏈接時使用的描述。
設置圖片網址與此鏈接相關的圖像的 URL。圖片至少應為 300x200 像素,且小於 300 KB。
谷歌分析參數
設置源
設置中
設置活動
設置期限
設置內容
谷歌播放分析參數。這些參數(`utm_source`、`utm_medium`、`utm_campaign`、`utm_term`、`utm_content`)被傳遞到 Play 商店並附加到鏈接有效負載中。
iTunesConnectAnalyticsParameters
setProviderToken
setAffiliateToken
setCampaignToken
iTunes Connect 分析參數。這些參數(`pt`、`at`、`ct`)被傳遞到 App Store。