為動態連結進行偵錯

預覽頁面流程圖

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

預覽頁面如下所示:

預覽網頁的螢幕截圖

iOS 自我診斷工具

如果您在 iOS 上遇到 Dynamic Link 整合問題,請使用 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。應用程式未啟用 AppLinks。

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

建立 SHA256 憑證後,請在 Firebase 主控台中將其新增至應用程式。請參閱「新增 SHA 指紋」。

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

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

iOS 應用程式沒有團隊 ID。應用程式未啟用 UniversalLinks。

如要將通用連結與應用程式搭配使用,您必須在 Firebase 控制台中新增 Team ID。請參閱「新增 App Store ID 或團隊 ID」一文。

你可以在 Apple Member Center 的「會員分頁」中找到團隊 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」。

專案未設定動態連結

如要開始使用動態連結,您必須在 Firebase 控制台中為專案啟用這項功能。

你想找的是其他地點嗎?

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