使用 C++ 建立 Dynamic Links

您可以使用 Firebase Dynamic Links API 建立短或長 Dynamic Links。API 會採用多個選用參數結構來建構連結。您也可以使用先前產生的長連結建立短連結。Firebase Dynamic Links 會產生類似以下的網址：

https://example.page.link/WXYZ

C++ SDK 適用於 Android 和 iOS，但每個平台都需要額外設定。

事前準備

使用 Firebase Dynamic Links 前，請先完成下列事項：

  • 註冊 C++ 專案，並設定使用 Firebase。

    如果 C++ 專案已使用 Firebase，代表已註冊並設定 Firebase。

  • 將 Firebase C++ SDK 新增至 C++ 專案。

請注意，將 Firebase 新增至 C++ 專案時，您必須在 Firebase 控制台和開啟的 C++ 專案中執行工作 (例如從控制台下載 Firebase 設定檔，然後移至 C++ 專案)。

Android

  1. 在 Firebase 控制台中，開啟 Dynamic Links部分。

  2. 如果您尚未接受服務條款，也未設定 Dynamic Links 的 URI 前置字元，請在系統提示時完成這些操作。

    如果您已有 Dynamic Links URI 前置字元，請記下該前置字元。以程式輔助方式建立 Dynamic Links 時，您必須提供 Dynamic Links URI 前置字串。

  3. 建議：指定深層連結和備用連結中允許的網址模式。這樣一來，未經授權的第三方就無法建立 Dynamic Links，從你的網域重新導向至你無法控制的網站。請參閱「允許特定網址模式」。

iOS

  1. 在 Firebase 控制台中，開啟 Dynamic Links部分。

  2. 如果您尚未接受服務條款，也未設定 Dynamic Links 的 URI 前置字元，請在系統提示時完成這些操作。

    如果您已有 Dynamic Links URI 前置字元，請記下該前置字元。以程式輔助方式建立 Dynamic Links 時，您必須提供 Dynamic Links 網域。

  3. Firebase Dynamic Links C++ 用戶端程式庫在 iOS 上使用自訂網址配置處理連結。您必須在應用程式中新增自訂網址配置，才能支援接收 Dynamic Links：
    1. 如要開啟專案設定，請在左側樹狀檢視中按兩下專案名稱。從「TARGETS」部分選取應用程式，然後選取「Info」分頁標籤，並展開「URL Types」部分。
    2. 按一下「+」按鈕，然後為反向用戶端 ID 新增網址配置。如要找出這個值，請開啟 GoogleService-Info.plist 設定檔，並尋找 REVERSED_CLIENT_ID 鍵。複製該鍵的值，並貼到設定頁面的「URL Schemes」(網址配置) 方塊中。其他欄位則留空。
    3. 按一下「+」按鈕，新增第二個網址配置。這個 ID 與應用程式的軟體包 ID 相同。舉例來說，如果軟體包 ID 是 com.example.ios，請在「URL Schemes」(網址配置) 方塊中輸入該值。您可以在專案設定的「General」分頁中，找到應用程式的軟體包 ID (依序前往「Identity」>「Bundle Identifier」)。

使用 Firebase 控制台

如要產生單一 Dynamic Link (用於測試，或方便行銷團隊建立連結，用於社群媒體貼文等)，最簡單的方法是前往 Firebase 控制台，按照逐步表單手動建立。

自訂網域

您可以使用自己的網域，而非 goo.gl 或 page.link 子網域，進一步控管 Dynamic Link 的品牌宣傳。請按照這些操作說明，為專案設定自訂網域。

使用 Firebase Dynamic Links API

建立及初始化應用程式

建立 Dynamic Links 前，您必須先建立並初始化 firebase::App 物件。

加入 firebase::App 的標頭檔案：

#include "firebase/app.h"

接下來的步驟會因平台而異：

Android

建立 firebase::App，並將 JNI 環境和 Java 活動的 jobject 參照做為引數傳遞：

app = ::firebase::App::Create(::firebase::AppOptions("APPLICATION NAME"), jni_env, activity);

iOS

建立 firebase::App：

app = ::firebase::App::Create(::firebase::AppOptions("APPLICATION NAME"));

初始化 Dynamic Links 程式庫

建立 Dynamic Link 前，請先初始化 Dynamic Links 程式庫：

::firebase::dynamic_links::Initialize(app, null);

從參數建立長 Dynamic Link

如要建立 Dynamic Link，請建立 DynamicLinkComponents 物件，設定任何選用成員以進行額外設定，然後將其傳遞至 dynamic_links::GetShortLink 或 dynamic_links::GetLongLink。

以下簡短範例會建立指向 https://www.example.com/ 的長 Dynamic Link，並使用 Android 應用程式 com.example.android.package_name 和 iOS 應用程式 com.example.ios 開啟：

firebase::dynamic_links::IOSParameters ios_parameters("com.example.ios");

firebase::dynamic_links::AndroidParameters android_parameters(
    "com.example.android.package_name");

firebase::dynamic_links::DynamicLinkComponents components(
    "https://www.example.com/", "example.page.link");
components.android_parameters = &android_parameters;
components.ios_parameters = &ios_parameters;

firebase::dynamic_links::GeneratedDynamicLink long_link =
    firebase::dynamic_links::GetLongLink(components);

建立短連結 Dynamic Link

如要建立短 Dynamic Link，請將先前產生的長連結傳遞至 GetShortLink，或按照上述方式建構 DynamicLinkComponents。

GetShortLink 可選擇接受額外的 DynamicLinkOptions 設定參數和 PathLength，以便控制連結的產生方式。產生短連結時，必須向 Firebase 後端發出網路要求，因此 GetShortLink 是非同步作業，會傳回 Future<GeneratedLink>。

例如：

firebase::dynamic_links::DynamicLinkOptions short_link_options;
short_link_options.path_length = firebase::dynamic_links::kPathLengthShort;

firebase::Future<firebase::dynamic_links::GeneratedDynamicLink> result =
    firebase::dynamic_links::GetShortLink(components, short_link_options);

如果程式有定期執行的更新迴圈 (例如每秒 30 或 60 次)，您可以在每次更新時檢查結果：

if (result.status() == firebase::kFutureStatusComplete) {
  if (result.error() == firebase::dynamic_links::kErrorCodeSuccess) {
    firebase::dynamic_links::GeneratedDynamicLink link = *result.result();
    printf("Create short link succeeded: %s\n", link.url.c_str());
  } else {
    printf("Created short link failed with error '%s'\n",
           result.error_message());
  }
}