本頁面由 Cloud Translation API 翻譯而成。

從 Dynamic Links 遷移至應用程式連結 &

本遷移指南著重於使用應用程式連結和通用連結，並可選擇使用 Firebase 託管代管應用程式網站關聯檔案。

這項遷移作業會取代下列 Firebase Dynamic Links 功能：

功能	Firebase Dynamic Links	應用程式連結 / 通用連結
只要點選單一連結，即可將使用者導向裝置的正確商店		^★
使用延遲深層連結，在使用者下載及安裝應用程式後提供後續歷程		^★
透過應用程式中的深層連結內容 (已安裝) 為使用者提供內容相關體驗
提供與動態連結點擊事件相關的分析資料
提供建立短連結網址的功能

如果您需要遷移其他 Firebase 動態連結功能，但這份指南不支援這些功能，請參閱「Dynamic Links 淘汰常見問題解答」說明文件中的其他遷移情境。

假設您有如下所示的 Firebase 動態連結：

動態連結範例
連結名稱	歡迎使用 Example.com
深層連結	`https://example.web.app/welcome`
Android 應用程式	`com.example.android`
Apple 應用程式	`com.example.ios`
完整動態連結	`https://example.page.link/?link=https://example.web.app/welcome&apn=com.example.android&isi=123456789&ibi=com.example.iuos`
簡短動態連結	`https://example.page.link/m9Mm`

本遷移指南的目標是取代以下 Firebase Dynamic Links：

https://example.page.link/m9Mm

使用應用程式連結 / 通用連結深層連結時，看起來會像這樣：

https://your-project-domain.web.app/welcome

請注意，應用程式連結 / 通用連結深層連結會向使用者提供下列資訊：

使用者可點擊的深層連結，在已安裝應用程式的情況下開啟您的應用程式
接續使用者歷程，從使用者開啟應用程式的特定部分前往特定部分

不過，應用程式連結 / 通用連結深層連結不會為使用者提供下列行為 (Firebase Dynamic Links 先前提供的行為)：

將使用者導向裝置的正確商店，以便下載及安裝應用程式
在使用者首次下載、安裝及開啟應用程式後，提供持續的使用者歷程

請注意，這些應用程式連結 / 通用連結的行為和功能與上表中列出的 Firebase Dynamic Links 有所不同。

事前準備

Firebase Dynamic Links 會在其本身的基礎實作中使用應用程式連結 (在 Android 上) 和通用連結 (在 iOS 上)，以便在應用程式安裝完成後提供深層連結功能。

本指南將逐步介紹如何使用 Firebase 託管建立自己的應用程式連結和通用連結，以取代 Firebase 動態連結提供的這部分功能，同時將 Firebase 動態連結遷移至新的應用程式連結 / 通用連結遷移解決方案。

您需要下列資訊才能完成遷移作業：

您要遷移的 Firebase 動態連結
動態連結中包含的深層連結網址參數
您打算用來取代先前 Firebase Dynamic Links 網域的網域 (如適用)

您可以參閱匯出動態連結中繼資料指南，匯出現有的連結中繼資料，並取得上述資訊。

遷移步驟總覽

佈建新網域 (如果沒有要使用的網域)，以便使用 Firebase 託管服務託管應用程式連結 / 通用連結設定檔。
在代管網域上建立及代管應用程式連結 / 通用連結設定檔。
根據 Firebase Dynamic Links 中使用的深層連結結構定義，建立新的應用程式連結 / 通用連結。
更新 Android / iOS 應用程式和應用程式程式碼，以便接收深層連結。
測試應用程式連結 / 通用連結整合功能。
將已發布或共用的 Firebase 動態連結，替換為應用程式連結和通用連結。

應用程式連結或通用連結遷移流程的第一步都相同。其餘工具會因平台而異，因此請根據您要先遷移的平台，參閱本指南的章節。

Android 應用程式連結的遷移步驟
iOS 版通用連結的遷移步驟

使用 Firebase 代管功能，為代管 App Link / 通用連結設定檔案提供新網域

選擇網域

第一步是選擇要用於應用程式連結/通用連結的網域。這個網域會用於您要分享給使用者的新連結。

如果您使用 Firebase 託管，系統會自動免費佈建 your-project-domain.web.app 或 your-project-domain.firebaseapp.com 格式的專案子網域。您也可以選擇使用自訂網域 (不論是否搭配 Firebase 代管) 來代管應用程式連結 / 通用連結設定檔。

設定 Firebase 託管

接下來，您必須設定及設定 Firebase 託管執行個體。

設定 Firebase 託管執行個體後，您將擁有類似 your-project-domain.web.app 的網域，或者您也可以選擇自訂網域。

Android 應用程式連結的遷移步驟

在新託管網域上建立及代管 App Link 設定檔

如要使用 App Links，您必須代管設定檔，以便在連結和應用程式使用的網域之間建立安全關聯。對於 App Links，這就是 assetlinks.json 檔案。

建立及代管 assetlinks.json 檔案的步驟

assetlinks.json 檔案可讓我們提供授權應用程式清單，這些應用程式可處理我們用於應用程式連結的網域內容。assetlinks.json 檔案本身必須託管在網域根目錄的 /.well-known 路徑下。

請按照下列步驟完成這項設定：

在 Firebase 代管根目錄的 public 資料夾下建立 .well-known 資料夾。
在 .well-known 資料夾下建立名為 assetlinks.json 的檔案。
將下列內容複製到 assetlinks.json 檔案中，並注意下列各欄位的含義：
```
[{
  "relation": ["delegate_permission/common.handle_all_urls"],
  "target": {
    "namespace": "android_app",
    "package_name": "com.example.android",
    "sha256_cert_fingerprints":
      ["01:23:45:67:89:AB:CD:EF:01:23:45:67:89:AB:CD:EF:01:23:45:67:89:AB:CD:EF:01:23:45:67:89:AB:CD:EF"]
  }
}]
```
- namespace - 指的是您要提供的應用程式名稱
- package_name：指的是應用程式 build.gradle 檔案中宣告的 applicationId
- sha256_cert_fingerprints - 指的是您用來簽署應用程式的 KeyStore 檔案 SHA256 指紋。
您可以使用 Android Studio 使用的 debug.keystore 檔案，為偵錯目的產生 sha256_cert_fingerprints 記錄。您可以在 Mac 和 Linux 的 /Users/<username>/.android/debug.keystore 和 Windows 的 C:\Users\<username>\.android\debug.keystore 中找到該檔案。

您可以使用 KeyTool 從這個 KeyStore 擷取 SHA256 值。

如要進一步瞭解如何完成這個步驟，請參閱應用程式連結說明文件的這個部分。

您也可以使用 Android Studio 中的應用程式連結小幫手產生 assetlinks.json 檔案內容，並設定應用程式以處理應用程式連結。

更新 firebase.json 檔案，為要代管的檔案建立索引。

"headers": [
  {
    "source": "/.well-known/assetlinks.json",
    "headers": [
      {
        "key": "Content-Type",
        "value": "application/json"
      }
    ]
  }
]

既然我們已設定好 assetlinks.json 檔案，請執行 firebase deploy 來代管變更。

請注意，您必須先安裝 Firebase CLI，才能執行上述部署指令。
```
firebase deploy --only hosting
```
前往 https://your-project-domain.web.app/.well-known/assetlinks.json 驗證 assetlinks.json 檔案

建立新的應用程式連結，與 Firebase 動態連結中使用的深層連結架構相符

在這個步驟中，您將使用與應用程式連結建立的新網域相符的一般深層連結網址，重新建立 Firebase 動態連結的深層連結。

舉例來說，假設您擁有下列 Firebase 動態連結：

動態連結範例
連結名稱	歡迎使用 Example.com
深層連結	`https://example.web.app/welcome`
Android 應用程式	`com.example.android`
Apple 應用程式	`com.example.ios`
完整動態連結	`https://example.page.link/?link=https://example.web.app/welcome&apn=com.example.android&isi=123456789&ibi=com.example.iuos`
簡短動態連結	`https://example.page.link/m9Mm`

在此情況下，您必須擷取深層連結參數 - 例如 https://example.web.app/welcome，接下來會用此參數做為應用程式的應用程式連結參數。

請針對您要遷移至應用程式連結 / 通用連結的每個 Firebase 動態連結，重複這個程序，並複製您使用的深層連結配置。

例如，請參閱下列 Firebase Dynamic Links 短連結、深層連結參數和已遷移的深層連結值：

簡短連結	深層連結參數	已遷移的深層連結
yourapp.page.link/welcome	https://example.com/welcome	yourapp.web.app/welcome
yourapp.page.link/c7sn	https://example.com/main/?p=23&t=1	yourapp.web.app/main/?p=23&t=1
yourapp.page.link/social	https://example.com/friendinvite/?add=1	yourapp.web.app/friendinvite/?add=1

接著，您需要將已發布或共用的所有 Firebase Dynamic Links 例項，替換為新遷移的深層連結，這樣使用者就會點選這些 App Links，而非先前的 Firebase Dynamic Links。

請更新 Android 應用程式和應用程式的程式碼，以便接收深層連結

選取網域、選擇深層連結結構定義，以及將 Firebase 動態連結遷移至應用程式連結後，下一步就是更新 Android 應用程式和應用程式程式碼，以便接收新的深層連結。

如要設定應用程式以處理深層連結，建議您參閱這裡的完整應用程式連結說明文件，或是 Android Studio 指南。主要步驟如下：

找出應處理相應深層連結的活動
在 AndroidManifest.xml 檔案中，為這些活動新增意圖篩選器
在活動的應用程式程式碼中接收深層連結

假設您想使用 MainActivity 處理部分深層連結。如要執行這項操作，您必須在 AndroidManifest.xml 檔案的 MainActivity 中加入下列 Intent 篩選器：

<activity android:name=".MainActivity"
   android:exported="true">
   <intent-filter>
       <action android:name="android.intent.action.MAIN" />
       <category android:name="android.intent.category.LAUNCHER" />
   </intent-filter>
   <intent-filter android:autoVerify="true">
       <action android:name="android.intent.action.VIEW" />
       <category android:name="android.intent.category.DEFAULT" />
       <category android:name="android.intent.category.BROWSABLE" />
       <data android:host="example.web.app" android:scheme="http"
           android:pathPrefix="/welcome" />
       <data android:host="example.web.app" android:scheme="https"
           android:pathPrefix="/welcome" />
   </intent-filter>
</activity>

在此步驟中，您會指定 MainActivity 為處理 wxample.web.app 網域深層連結的目的地，且包含 /welcome 路徑前置字串。請注意，您也必須指定 android:autoVerify="true" 屬性，以便將應用程式指定為此指定連結類型的預設處理常式。

最後，您需要在 MainActivity 中加入程式碼，以便擷取深層連結資料，並用於在應用程式中提供深層連結體驗。這類似於您在整合 Firebase 動態連結時，可能已在應用程式中編寫的邏輯。

override fun onCreate(savedInstanceState: Bundle?) {
  super.onCreate(savedInstanceState)
  setContentView(R.layout.main)

  val  data: Uri? = intent?.data

  val toast = Toast.makeText(this, data, duration)
  toast.show()
}

測試應用程式連結

您可以在實體裝置或 Android Emulator 中執行應用程式，測試剛建立的應用程式連結。

您必須使用針對應用程式連結設定的網域，建立可點選的連結，然後按一下該連結，確保連結可開啟至您的應用程式，並讓您前往預定的活動。

或者，您也可以使用 Android Studio 中的 App Links Assistant 測試應用程式連結整合，或是針對已設定的應用程式連結網址使用下列指令，確保系統能正確啟動相符的活動：

adb shell am start -a android.intent.action.VIEW -d <your_deep_link_url>

將已發布或共用的 Firebase 動態連結替換為應用程式連結

遷移作業的最後一個步驟，是盡可能使用應用程式連結，取代已發布或分享的 Firebase 動態連結，並在日後繼續使用應用程式連結。

完成這個步驟的方式會因您發布 Firebase Dynamic Links 的位置和方式而異，但為了方便追蹤哪些 Dynamic Links 已發布，您可以匯出現有的 Firebase Dynamic Link 中繼資料。請參閱匯出動態連結中繼資料指南。

iOS 版通用連結的遷移步驟

在新代管網域上建立及代管通用連結設定檔

如要使用通用連結，您必須代管設定檔，在連結和應用程式所用的網域之間建立安全關聯。以通用連結來說，這是 apple-app-site-association 檔案 (也稱為 AASA 檔案)。

建立及代管 apple-app-site-association 檔案的步驟

我們可以利用 AASA 檔案提供授權應用程式清單，這些應用程式可以處理要用於通用連結的網域內容。AASA 檔案本身必須代管在網域根目錄的 /.well-known 路徑下。

請按照下列步驟完成這項設定：

在 Firebase 代管根目錄的公開資料夾下建立「.well-known」資料夾。
在「.well-known」資料夾下建立名為「apple-app-site-association」的檔案。

將以下內容複製到 apple-app-site-association 檔案中，並注意下方各欄位的含義：

{
  "applinks": {
    "apps": [],
    "details": [
      {
        "appId": "$TEAM_ID.com.firebase.UniversalLinks",
        "paths": [
          "NOT /_/*",
          "/*"
        ]
      }
    ]
  }
}

$TEAM_ID.BundleId - 授權處理連結的完整應用程式名稱

請更新 firebase.json 檔案，為要代管的檔案建立索引。

"headers": [
  {
    "source": "/.well-known/apple-app-site-association",
    "headers": [
      {
        "key": "Content-Type",
        "value": "application/json"
      }
    ]
  }
]

有了 AASA 檔案後，請執行 Firebase 部署作業，以便代管變更。
前往 https://your-project-domain.web.app/.well-known/app-app-site-association，驗證 AASA 檔案

根據 Firebase Dynamic Links 中使用的深層連結結構定義，建立新的通用連結

在這個步驟中，您將使用一般深層連結網址，重新建立 Firebase 動態連結的深層連結，並與您為通用連結建立的新網域相符。

舉例來說，假設您擁有下列 Firebase 動態連結：

動態連結範例
連結名稱	歡迎使用 Example.com
深層連結	`https://example.web.app/welcome`
Android 應用程式	`com.example.android`
Apple 應用程式	`com.example.ios`
完整動態連結	`https://example.page.link/?link=https://example.web.app/welcome&apn=com.example.android&isi=123456789&ibi=com.example.iuos`
簡短動態連結	`https://example.page.link/m9Mm`

在這種情況下，您會擷取深層連結參數 (例如 https://example.web.app/welcome)，並將其用作應用程式的通用連結參數。

請針對您要遷移至應用程式連結 / 通用連結的每個 Firebase 動態連結，重複執行這個程序，並複製您使用的深層連結配置。

例如，請參閱下列 Firebase Dynamic Links 短連結、深層連結參數和已遷移的深層連結值：

簡短連結	深層連結參數	已遷移的深層連結
yourapp.page.link/welcome	https://example.com/welcome	yourapp.web.app/welcome
yourapp.page.link/c7sn	https://example.com/main/?p=23&t=1	yourapp.web.app/main/?p=23&t=1
yourapp.page.link/social	https://example.com/friendinvite/?add=1	yourapp.web.app/friendinvite/?add=1

接著，您需要將已發布或共用的任何 Firebase 動態連結，替換為新遷移的深層連結，讓使用者點選這些通用連結，而非先前的 Firebase 動態連結。

更新 iOS 應用程式和應用程式程式碼，以便接收深層連結

選取網域、選擇深層連結架構，以及將 Firebase 動態連結遷移至通用連結後，下一步就是更新 iOS 應用程式和應用程式程式碼，以便接收新的深層連結。

建議您按照這裡的完整通用連結說明文件設定應用程式來處理深層連結，但主要步驟包括：

更新專案設定，讓應用程式能夠處理新建網域中的深層連結
在應用程式程式碼中接收深層連結

如要更新專案設定，讓應用程式能處理深層連結，您需要針對目前打算用來託管 apple-app-site-associate 檔案的網域，在 xCode 中將額外的關聯網域新增至專案。

方法如下：

開啟 Xcode
在檔案總管中選取專案
前往專案設定的「Signing & Capabilities」(簽署與功能) 分頁
向下捲動至「Associated Domains」(關聯網域) 部分
按一下「+」按鈕，以「applinks:」格式將其他網域新增至專案。

最後，您需要更新應用程式程式碼，才能接收傳入的深層連結。

如要完成這項操作，請先更新 AppDelegate.swift 檔案，以便回應通用連結，方法是新增下列程式碼：

func application(_ application: UIApplication, continue userActivity: NSUserActivity,
                 restorationHandler: @escaping ([UIUserActivityRestoring]?) -> Void) -> Bool {
  AppDelegate.showReceivedUrl(userActivity: userActivity);
  return true
}

static func showReceivedUrl(userActivity: NSUserActivity) {
  if userActivity.activityType == NSUserActivityTypeBrowsingWeb {
    let url = userActivity.webpageURL!
    print(url.absoluteString)
}

上述程式碼會覆寫通用連結回呼方法，並記錄深層連結網址 (如有)。

由於使用者點選通用連結時，應用程式可能已開啟，因此我們也會從 SceneDelegate 類別呼叫相同的 showReceivedUrl 方法，以便在 SceneDelegate 中叫用通用連結回呼。

func scene(_ scene: UIScene, continue userActivity: NSUserActivity) {
  AppDelegate.showReceivedUrl(userActivity: userActivity)
}

測試通用連結

您可以在實體裝置或模擬器上執行應用程式，測試剛建立的通用連結。

您必須使用針對通用連結設定的網域，建立可點選的連結，然後點選該連結，確認連結可開啟至您的應用程式，並將您帶往應用程式中的目標畫面。

支援智慧型應用程式橫幅廣告

強烈建議您使用智慧應用程式橫幅，為使用者提供與 Firebase 動態連結類似的體驗。

如果使用者尚未在裝置上安裝應用程式，系統會透過智慧型應用程式橫幅，將他們帶往應用程式商店的應用程式資訊頁面。您也可以選擇在應用程式下載及安裝完成後，將參數傳遞至應用程式，為使用者提供後續流程。如果應用程式已安裝，系統會開啟並將參數傳遞至應用程式，根據使用者點選的智慧型應用程式橫幅，協助他們前往適當的內容。

將已發布或共用的 Firebase 動態連結替換為應用程式連結

遷移作業的最後一個步驟，就是盡可能使用通用連結取代已發布或共用的 Firebase 動態連結，並繼續使用通用連結。

完成這個步驟會因您發布 Firebase Dynamic Links 的位置和方式而異。

為了協助您追蹤要遷移的現有 Firebase Dynamic Links，我們將發布指南，說明如何從 Firebase Dynamic Links 匯出簡短連結中繼資料。如需更多最新消息，請參閱動態連結停用常見問題文件。