為動態連結進行偵錯

預覽頁面流程圖

為協助您偵錯 Dynamic Links,系統會自動產生流程圖,讓您預覽 Dynamic Links 在不同平台和設定中的行為。在任何短或長 Dynamic Link 中加入 d=1 參數,即可生成流程圖。例如,example.page.link/suffix?d=1 代表短暫的Dynamic Link

預覽頁面如下所示:

預覽頁面的螢幕截圖

iOS 自我診斷工具

如果 iOS 上的 Dynamic Link 整合發生問題,請使用 Dynamic Links SDK 2.1.0 以上版本內建的自我診斷工具。

您可以在程式碼中的任何位置叫用這項工具,如下所示。

Swift

注意:macOS、Mac Catalyst、tvOS 或 watchOS 目標不支援這項 Firebase 產品。
DynamicLinks.performDiagnostics(completion: nil)

Objective-C

注意:macOS、Mac Catalyst、tvOS 或 watchOS 目標不支援這項 Firebase 產品。
[FIRDynamicLinks performDiagnosticsWithCompletion:nil];

根據預設,這項工具會將偵錯資訊 (包括偵測到的錯誤) 輸出至標準輸出。舉例來說,假設您的 iOS 應用程式未如預期收到 Dynamic Links,自我診斷工具會輸出下列資訊:

---- Firebase Dynamic Links diagnostic output start ----
Firebase Dynamic Links framework version 2.1.0
System information: OS iOS, OS version 11.0, model iPhone
Current date 2017-08-14 22:52:56 +0000
AutomaticRetrievalEnabled: YES
ERROR: Specified custom URL scheme is com.google.AppInvitesSample.dev but Info.plist do not contain such scheme in CFBundleURLTypes key.
AppID Prefix: EQHXZ8M8AV, Team ID: EQHXZ8M8AV, AppId Prefix equal to Team ID: YES
performDiagnostic detected 1 ERRORS.
---- Firebase Dynamic Links diagnostic output end ----

在這個範例中,Dynamic Links 無法運作,是因為自訂網址架構設定有誤。

常見錯誤和警告

Android 應用程式缺少 SHA256。應用程式未啟用 AppLinks。

如要在應用程式中使用 Android 應用程式連結,您必須建立 SHA256 憑證

建立 SHA256 憑證後,請在Firebase管理中心將憑證新增至應用程式。請參閱「新增 SHA 指紋」。

找不到 Android 套件名稱「com.example」和/或 iOS 軟體包 ID「com.example」

如要在 Android 或 iOS 應用程式中使用 Dynamic Links,請務必將應用程式新增至 Firebase 專案。請參閱「新增應用程式」。

iOS 應用程式缺少團隊 ID。應用程式未啟用 UniversalLinks。

如要在應用程式中使用通用連結,請在 Firebase 控制台中新增團隊 ID。 請參閱「新增 App Store ID 或團隊 ID」。

你可以在 Apple Member Center 的「Membership」(會員) 分頁中找到團隊 ID。

指定的 iOS 軟體包 ID 中沒有 iOS 商店 ID。正在略過。

這表示 https://itunes.apple.com/us/app/yourapp/idSTOREID 列出的應用程式沒有指定的套件 ID。

iOS 自訂配置無效

自訂配置必須以字母字元 (A–Z、a–z) 開頭,後面可接任意數量的英數字元、+-.。此外,自訂配置也不得為下列任一字串:「javascript」、「vbscript」、「data」、「blob」、「http」、「https」、「mailto」、「livescript」、「facetime」、「facetime-audio」。

您的專案尚未設定動態連結

如要開始使用 Dynamic Links,請在 Firebase 控制台中為專案啟用這項功能。

你想找的是其他地點嗎?

如果遇到其他問題,請參閱 Firebase 支援頁面