為動態連結進行偵錯

預覽頁面流程圖

為了協助您對 Dynamic Links 進行偵錯,您可以利用自動產生的流程圖,預覽動態連結在不同平台和設定中的行為。將 d=1 參數新增至任何短或長的動態連結,即可產生流程圖。例如,example.page.link/suffix?d=1 代表短動態連結。

預覽頁面看起來會像這樣:

預覽網頁的螢幕截圖

iOS 自我診斷工具

如果無法順利在 iOS 上整合動態連結,請使用 Dynamic Links SDK 2.1.0 以上版本內建的自我診斷工具。

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

Swift

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

Objective-C

注意事項:這項 Firebase 產品不適用於 macOS、Mac Catalyst、tvOS 或 watchOS 目標。
[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。應用程式未啟用 AppLink。

如要在應用程式中使用 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」、「blob」、「http」、「https」、「time-time」、「live-time」、「live」。

您的專案尚未設定 Dynamic Links

如要開始使用 Dynamic Links,請在 Firebase 主控台中為專案啟用 Dynamic Links。

你想找的是其他地點嗎?

如果還有其他問題,請參閱 Firebase 支援頁面