使用 C++ 接收 Dynamic Links

如要接收Firebase Dynamic Links您建立的，應用程式必須包含 Dynamic Links SDK，並建立實作 OnDynamicLinkReceived 虛擬函式的 firebase::dynamic_links::Listener 物件。

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

事前準備

如要使用 Firebase Dynamic Links， 請先完成下列步驟：

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

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

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

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

新增自訂網址通訊協定 (僅限 iOS)

Firebase Dynamic Links C++ 用戶端程式庫會在 iOS 上使用自訂網址通訊協定處理連結。您必須在應用程式中新增自訂網址配置，才能支援接收 Dynamic Links。

  1. 如要開啟專案設定，請在左側樹狀檢視畫面中，按兩下專案名稱。

  2. 在「目標」部分選取應用程式，然後選取「資訊」分頁，展開「網址類型」部分。

  3. 按一下 + 按鈕，然後為反向用戶端 ID 新增網址架構。如要找出這個值，請按照下列步驟操作：

    1. 開啟 GoogleService-Info.plist 設定檔，然後尋找 REVERSED_CLIENT_ID 鍵。

    2. 複製該鍵的值，然後貼到設定頁面的「URL Schemes」方塊中。

    3. 將其他欄位留空。

  4. 按一下「+」按鈕，然後新增第二個網址架構。這個 ID 與應用程式的軟體包 ID 相同。

    舉例來說，如果套裝組合 ID 為 com.example.ios，請在「網址架構」方塊中輸入該值。

    您可以在專案設定的「一般」分頁中找到應用程式的軟體包 ID (「Identity」>「Bundle Identifier」)。

接收 Dynamic Link

建立及初始化應用程式

如要檢查收到的 Dynamic Links，您必須先建立並初始化 firebase::App 物件。

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

#include "firebase/app.h"

後續步驟會因平台而異：

AndroidiOS

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

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

建立 firebase::App：

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

導入接聽器，檢查 Dynamic Links

如要檢查收到的 Dynamic Link，請實作並使用 firebase::dynamic_links::Listener 類別。

納入接收 Dynamic Links 的標頭檔案： 

#include "firebase/dynamic_links.h"

初始化 Dynamic Links 程式庫： 

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

建立實作 firebase::dynamic_links::Listener 的物件，並使用 SetListener() 將其提供給 Dynamic Links 程式庫，或將其做為第二個引數傳遞至 Initialize。

如要接收 Dynamic Links，Listener 類別必須實作 OnDynamicLinkReceived 虛擬函式。覆寫這個方法後，您就能接收深層連結 (如有)。

class Listener : public firebase::dynamic_links::Listener {
 public:
  // Called on the client when a dynamic link arrives.
  void OnDynamicLinkReceived(
      const firebase::dynamic_links::DynamicLink* dynamic_link) override {
    printf("Received link: %s", dynamic_link->url.c_str());
  }
};