Trang này được dịch bởi Cloud Translation API.

Di chuyển từ Đường liên kết động sang Đường liên kết ứng dụng và Đường liên kết chung

Hướng dẫn di chuyển này tập trung vào việc sử dụng Đường liên kết đến ứng dụng và Đường liên kết phổ quát, có thể sử dụng tính năng Lưu trữ Firebase để lưu trữ các tệp liên kết ứng dụng với trang web.

Quá trình di chuyển này sẽ thay thế các tính năng sau của Đường liên kết động của Firebase:

Tính năng	Liên kết động của Firebase	Đường liên kết trong ứng dụng / Đường liên kết phổ quát
Chuyển hướng người dùng đến đúng cửa hàng cho thiết bị của họ chỉ bằng một lượt nhấp vào đường liên kết		^★
Tiếp tục hành trình của người dùng sau khi tải xuống và cài đặt ứng dụng bằng đường liên kết sâu bị trì hoãn		^★
Cung cấp cho người dùng trải nghiệm theo bối cảnh bằng cách sử dụng nội dung được liên kết sâu trong ứng dụng của bạn (khi đã cài đặt)
Cung cấp dữ liệu phân tích liên quan đến sự kiện nhấp vào đường liên kết động
Cung cấp khả năng tạo URL đường liên kết ngắn

Nếu bạn vẫn cần các tính năng khác của Đường liên kết động Firebase cho quá trình di chuyển mà không được hỗ trợ trong hướng dẫn này, hãy xem các tình huống di chuyển khác trong tài liệu Câu hỏi thường gặp về việc ngừng sử dụng Đường liên kết động.

Giả sử bạn có một Liên kết động Firebase như sau:

Ví dụ về đường liên kết động
Tên liên kết	Chào mừng bạn đến với Example.com
Đường liên kết sâu	`https://example.web.app/welcome`
Ứng dụng Android	`com.example.android`
Ứng dụng Apple	`com.example.ios`
Đường liên kết động dài	`https://example.page.link/?link=https://example.web.app/welcome&apn=com.example.android&isi=123456789&ibi=com.example.iuos`
Đường liên kết động ngắn	`https://example.page.link/m9Mm`

Mục tiêu của hướng dẫn di chuyển này là thay thế Đường liên kết động của Firebase như sau:

https://example.page.link/m9Mm

Với các đường liên kết sâu của Đường liên kết ứng dụng / Đường liên kết phổ quát như sau:

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

Xin lưu ý rằng đường liên kết sâu Đường liên kết đến ứng dụng / Đường liên kết phổ quát sẽ cung cấp cho người dùng những thông tin sau:

Một đường liên kết sâu mà người dùng có thể nhấp vào. Đường liên kết này sẽ mở ứng dụng của bạn khi ứng dụng đã được cài đặt
Tiếp tục hành trình của người dùng khi điều hướng họ đến một phần cụ thể trong ứng dụng khi ứng dụng được mở

Tuy nhiên, đường liên kết sâu đến Đường liên kết ứng dụng / Đường liên kết phổ quát sẽ không cung cấp các hành vi sau đây cho người dùng của bạn (mà trước đây Đường liên kết động của Firebase đã làm):

Chuyển người dùng đến đúng cửa hàng cho thiết bị của họ để tải và cài đặt ứng dụng
Tiếp tục hành trình của người dùng sau khi tải xuống, cài đặt và mở ứng dụng lần đầu tiên

Hãy lưu ý sự khác biệt về hành vi và chức năng của các Đường liên kết ứng dụng / Đường liên kết phổ quát này so với Đường liên kết động của Firebase được nêu trong bảng trên.

Trước khi bắt đầu

Liên kết động của Firebase sử dụng Đường liên kết đến ứng dụng (trên Android) và Đường liên kết toàn cầu (trên iOS) trong quá trình triển khai cơ bản của riêng mình để cung cấp chức năng liên kết sâu sau khi ứng dụng của bạn được cài đặt.

Hướng dẫn này trình bày cách tạo Đường liên kết ứng dụng và Đường liên kết phổ quát của riêng bạn bằng cách sử dụng tính năng Lưu trữ Firebase để thay thế phần chức năng do Đường liên kết động của Firebase cung cấp trong khi di chuyển Đường liên kết động của Firebase sang giải pháp di chuyển Đường liên kết ứng dụng / Đường liên kết phổ quát mới.

Bạn cần có những thông tin sau để hoàn tất quá trình di chuyển:

Đường liên kết động của Firebase mà bạn dự định di chuyển
Các tham số URL liên kết sâu có trong các đường liên kết động của bạn
Miền mà bạn dự định sử dụng để thay thế miền Đường liên kết động của Firebase trước đó (nếu có)

Bạn có thể tham khảo Hướng dẫn xuất siêu dữ liệu của đường liên kết động để xuất siêu dữ liệu của đường liên kết hiện có và lấy thông tin nêu trên.

Tổng quan về các bước di chuyển

Cung cấp một miền mới (nếu bạn chưa có miền mà bạn muốn sử dụng) để lưu trữ các tệp cấu hình Đường liên kết trong ứng dụng / Đường liên kết phổ quát bằng tính năng Lưu trữ Firebase.
Tạo và lưu trữ các tệp cấu hình Đường liên kết trong ứng dụng / Đường liên kết phổ quát trên miền lưu trữ của bạn.
Tạo Đường liên kết ứng dụng / Đường liên kết phổ quát mới khớp với giản đồ liên kết sâu được dùng trong Đường liên kết động của Firebase.
Cập nhật ứng dụng Android / iOS và mã ứng dụng để nhận đường liên kết sâu.
Kiểm thử việc tích hợp Đường liên kết trong ứng dụng / Đường liên kết chung.
Thay thế Đường liên kết động của Firebase đã xuất bản hoặc chia sẻ bằng Đường liên kết ứng dụng và Đường liên kết phổ quát.

Bước đầu tiên sẽ giống nhau đối với cả quy trình di chuyển Đường liên kết ứng dụng hoặc Đường liên kết phổ quát. Phần còn lại sẽ khác nhau tuỳ theo nền tảng, vì vậy, hãy chuyển đến phần hướng dẫn bên dưới tuỳ thuộc vào nền tảng mà bạn muốn di chuyển trước tiên.

Các bước di chuyển đối với Đường liên kết trong ứng dụng Android
Các bước di chuyển cho Đường liên kết phổ quát trên iOS

Cung cấp một miền mới để lưu trữ tệp cấu hình Đường liên kết ứng dụng / Đường liên kết phổ quát bằng tính năng Lưu trữ Firebase

Chọn miền

Bước đầu tiên là chọn một miền bạn muốn sử dụng cho Đường liên kết ứng dụng/Đường liên kết phổ quát. Đây sẽ là miền được dùng cho các đường liên kết mới mà bạn sẽ chia sẻ với người dùng.

Nếu bạn sử dụng Dịch vụ lưu trữ Firebase, các miền con của dự án có định dạng your-project-domain.web.app hoặc your-project-domain.firebaseapp.com sẽ tự động được cung cấp mà không tính phí. Bạn cũng có thể sử dụng miền tuỳ chỉnh có hoặc không có tính năng Lưu trữ Firebase để lưu trữ các tệp cấu hình Đường liên kết trong ứng dụng / Đường liên kết phổ quát.

Thiết lập tính năng Lưu trữ Firebase

Tiếp theo, bạn cần thiết lập và định cấu hình thực thể Lưu trữ Firebase.

Khi hoàn tất việc thiết lập thực thể Lưu trữ Firebase, bạn sẽ có một miền tương tự như your-project-domain.web.app hoặc một miền tuỳ chỉnh nếu muốn.

Các bước di chuyển cho Đường liên kết trong ứng dụng Android

Tạo và lưu trữ các tệp cấu hình Đường liên kết trong ứng dụng trên miền lưu trữ mới

Để sử dụng Đường liên kết trong ứng dụng, bạn phải lưu trữ một tệp cấu hình giúp thiết lập mối liên kết an toàn giữa miền dùng trong đường liên kết và ứng dụng. Đối với Đường liên kết trong ứng dụng, đây là tệp assetlinks.json.

Các bước tạo và lưu trữ tệp assetlinks.json

Tệp assetlinks.json cho phép chúng tôi cung cấp danh sách các ứng dụng được uỷ quyền có thể xử lý nội dung của miền web mà chúng tôi sẽ sử dụng cho Đường liên kết ứng dụng. Bản thân tệp assetlinks.json cần được lưu trữ trong thư mục gốc của miền web theo đường dẫn: /.well-known.

Hãy làm theo các bước bên dưới để hoàn tất cấu hình này:

Tạo thư mục .well-known trong thư mục công khai trong thư mục gốc của Firebase Hosting.
Tạo một tệp có tên assetlinks.json trong thư mục .well-known.
Sao chép nội dung sau vào tệp assetlinks.json, lưu ý ý nghĩa của từng trường bên dưới:
```
[{
  "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 – đề cập đến tên của ứng dụng mà bạn muốn cung cấp
- package_name – tham chiếu đến applicationId được khai báo trong tệp build.gradle của ứng dụng
- sha256_cert_fingerprints – đề cập đến vân tay số SHA256 của tệp kho khoá mà bạn dùng để ký ứng dụng.
Bạn có thể sử dụng tệp debug.keystore mà Android Studio sử dụng để tạo bản ghi sha256_cert_fingerprints cho mục đích gỡ lỗi. Bạn có thể tìm thấy tệp này tại /Users/<username>/.android/debug.keystore trên máy Mac và Linux, cũng như C:\Users\<username>\.android\debug.keystore trên Windows.

Từ kho khoá này, bạn có thể tìm nạp giá trị SHA256 bằng keytool.

Hãy tham khảo phần này trong tài liệu về Đường liên kết trong ứng dụng để biết thêm hướng dẫn về cách hoàn tất bước này.

Ngoài ra, bạn cũng có thể sử dụng Trợ lý đường liên kết trong ứng dụng trong Android Studio để tạo nội dung tệp assetlinks.json và định cấu hình ứng dụng để xử lý Đường liên kết trong ứng dụng.

Cập nhật tệp firebase.json để lập chỉ mục tệp nhằm lưu trữ.

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

Bây giờ, chúng ta đã có tệp assetlinks.json, chạy firebase deploy để lưu trữ các thay đổi.

Xin lưu ý rằng bạn cần phải cài đặt Giao diện dòng lệnh Firebase để chạy lệnh triển khai ở trên.
```
firebase deploy --only hosting
```
Xác minh tệp assetlinks.json bằng cách chuyển đến https://your-project-domain.web.app/.well-known/assetlinks.json

Tạo Đường liên kết trong ứng dụng mới khớp với giản đồ đường liên kết sâu dùng trong Đường liên kết động của Firebase

Ở bước này, bạn sẽ tạo lại các đường liên kết sâu từ Đường liên kết động của Firebase bằng cách sử dụng các URL liên kết sâu thông thường khớp với miền mới bạn đã tạo cho Đường liên kết ứng dụng.

Ví dụ: giả sử bạn có Liên kết động Firebase sau:

Ví dụ về đường liên kết động
Tên liên kết	Chào mừng bạn đến với Example.com
Đường liên kết sâu	`https://example.web.app/welcome`
Ứng dụng Android	`com.example.android`
Ứng dụng Apple	`com.example.ios`
Đường liên kết động dài	`https://example.page.link/?link=https://example.web.app/welcome&apn=com.example.android&isi=123456789&ibi=com.example.iuos`
Đường liên kết động ngắn	`https://example.page.link/m9Mm`

Trong trường hợp này, bạn sẽ trích xuất tham số đường liên kết sâu – tức là https://example.web.app/welcome và hiện sẽ sử dụng tham số này làm tham số Đường liên kết trong ứng dụng cho ứng dụng của bạn.

Lưu ý: Trong lần đầu tạo Đường liên kết động của Firebase, bạn có thể đã tạo một tham số liên kết sâu sử dụng một miền mà bạn không sở hữu (ví dụ: example.com/welcome). Liên kết động của Firebase hỗ trợ việc này, tuy nhiên trong quá trình di chuyển này, bạn phải thay đổi mọi đường liên kết sâu mà bạn dự định sử dụng để sử dụng miền mà bạn sở hữu và đã được định cấu hình trước đó bằng tính năng Lưu trữ Firebase. Nếu bạn đã sử dụng một miền mà bạn sở hữu cho các tham số URL liên kết sâu được sử dụng trong Đường liên kết động Firebase, thì việc này có thể giúp bạn tiết kiệm nhiều thời gian và ứng dụng của bạn có thể đã được định cấu hình để xử lý các Đường liên kết trong ứng dụng sắp tới mà bạn cần tạo.

Bạn nên lặp lại quy trình này cho từng Đường liên kết động Firebase mà bạn muốn chuyển sang sử dụng Đường liên kết trong ứng dụng / Đường liên kết phổ quát và sao chép lược đồ liên kết sâu mà bạn đã sử dụng.

Ví dụ: vui lòng xem nhóm các đường liên kết ngắn, thông số đường liên kết sâu và giá trị đường liên kết sâu đã di chuyển của Firebase sau đây:

Đường liên kết ngắn	Thông số đường liên kết sâu	Đường liên kết sâu đã di chuyển
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

Tiếp theo, bạn sẽ cần thay thế mọi bản sao của Đường liên kết động của Firebase đã được xuất bản hoặc chia sẻ với các đường liên kết sâu mới được di chuyển để người dùng sẽ nhấp vào các Đường liên kết ứng dụng đó thay vì Đường liên kết động của Firebase trước đó.

Cập nhật ứng dụng Android và mã ứng dụng để nhận đường liên kết sâu

Bước tiếp theo sau khi chọn một miền, chọn giản đồ liên kết sâu và di chuyển Liên kết động của Firebase sang Đường liên kết trong ứng dụng là cập nhật ứng dụng Android và mã ứng dụng để nhận các đường liên kết sâu mới.

Bạn nên làm theo tài liệu đầy đủ về Đường liên kết đến ứng dụng tại đây hoặc hướng dẫn về Android Studio để định cấu hình ứng dụng xử lý đường liên kết sâu, nhưng các bước chính bao gồm:

Xác định những hoạt động sẽ xử lý các đường liên kết sâu tương ứng
Thêm Bộ lọc ý định cho các hoạt động đó trong tệp AndroidManifest.xml
Nhận đường liên kết sâu trong mã ứng dụng của hoạt động

Giả sử bạn muốn sử dụng MainActivity để xử lý một số đường liên kết sâu. Để thực hiện việc này, bạn cần thêm Bộ lọc ý định sau vào MainActivity trong tệp AndroidManifest.xml:

<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>

Trong bước này, bạn đang chỉ định rằng MainActivity là đích đến để xử lý các đường liên kết sâu từ miền wxample.web.app và miền này bao gồm tiền tố đường dẫn /welcome. Xin lưu ý rằng bạn cũng cần chỉ định thuộc tính android:autoVerify="true". Thuộc tính này cho phép bạn chỉ định ứng dụng của mình làm trình xử lý mặc định cho loại đường liên kết cụ thể này.

Cuối cùng, bạn cần thêm mã trong MainActivity để truy xuất dữ liệu liên kết sâu và sử dụng dữ liệu đó để thúc đẩy trải nghiệm liên kết sâu trong ứng dụng. Điều này tương tự như logic mà bạn có thể đã lập trình trong ứng dụng khi tích hợp với Đường liên kết động 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()
}

Thử nghiệm Đường liên kết trong ứng dụng

Bạn có thể kiểm thử Đường liên kết trong ứng dụng mà bạn vừa tạo bằng cách chạy ứng dụng trên thiết bị thực hoặc trong Trình mô phỏng Android.

Bạn cần tạo một đường liên kết có thể nhấp vào bằng cách sử dụng miền được định cấu hình cho Đường liên kết ứng dụng, sau đó nhấp vào đường liên kết đó để đảm bảo đường liên kết đó mở trong ứng dụng và chuyển bạn đến hoạt động dự kiến.

Ngoài ra, bạn cũng có thể kiểm thử tính năng tích hợp Đường liên kết trong ứng dụng bằng cách sử dụng Trợ lý đường liên kết trong ứng dụng trong Android Studio hoặc sử dụng lệnh sau cho URL đường liên kết trong ứng dụng mà bạn đã định cấu hình để đảm bảo URL đó khởi chạy chính xác hoạt động trùng khớp:

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

Thay thế Đường liên kết động của Firebase đã xuất bản hoặc chia sẻ bằng Đường liên kết ứng dụng

Bước cuối cùng để di chuyển là thay thế Liên kết động của Firebase đã xuất bản hoặc chia sẻ bằng Liên kết ứng dụng bất cứ khi nào có thể và tiếp tục sử dụng Liên kết ứng dụng trong tương lai.

Việc hoàn tất bước này sẽ khác nhau tuỳ thuộc vào vị trí và cách bạn phát hành Đường liên kết động của Firebase. Tuy nhiên, để theo dõi những đường liên kết hiện có, bạn có thể xuất siêu dữ liệu Đường liên kết động của Firebase hiện có. Xem Hướng dẫn xuất siêu dữ liệu về đường liên kết động.

Các bước di chuyển cho Đường liên kết phổ quát trên iOS

Tạo và lưu trữ tệp cấu hình Đường liên kết phổ quát trên miền lưu trữ mới của bạn

Để sử dụng Đường liên kết phổ quát, bạn phải lưu trữ một tệp cấu hình giúp thiết lập mối liên kết an toàn giữa miền dùng trong đường liên kết và ứng dụng. Đối với Đường liên kết phổ quát, đây là tệp apple-app-site-association (còn gọi là tệp AASA).

Các bước để tạo và lưu trữ tệp apple-app-site-association

Tệp AASA cho phép chúng tôi cung cấp danh sách các ứng dụng được uỷ quyền có thể xử lý nội dung của miền web mà chúng tôi sẽ sử dụng cho Đường liên kết phổ quát. Bản thân tệp AASA cần được lưu trữ trong thư mục gốc của miền web theo đường dẫn: /.well-known.

Hãy làm theo các bước dưới đây để hoàn tất cấu hình này:

Tạo thư mục ".well-known" trong thư mục công khai trong thư mục gốc của tính năng Lưu trữ Firebase.
Tạo một tệp có tên là "apple-app-site-association" trong thư mục ".well-known".

Sao chép nội dung sau vào tệp apple-app-site-association, lưu ý ý nghĩa của từng trường bên dưới:

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

$TEAM_ID.BundleId – tên ứng dụng đủ điều kiện được uỷ quyền để xử lý các đường liên kết

Cập nhật tệp firebase.json để lập chỉ mục tệp nhằm lưu trữ.

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

Bây giờ, chúng ta đã có tệp AASA, hãy triển khai firebase để lưu trữ các thay đổi.
Xác minh tệp AASA bằng cách truy cập vào https://your-project-domain.web.app/.well-known/app-app-site-association

Tạo Đường liên kết toàn cầu mới khớp với giản đồ đường liên kết sâu dùng trong Đường liên kết động của Firebase

Trong bước này, bạn sẽ tạo lại các đường liên kết sâu từ Đường liên kết động của Firebase bằng cách sử dụng các URL liên kết sâu thông thường khớp với miền mới bạn đã tạo cho Đường liên kết phổ quát của mình.

Ví dụ: giả sử bạn có Đường liên kết động của Firebase như sau:

Ví dụ về đường liên kết động
Tên liên kết	Chào mừng bạn đến với Example.com
Đường liên kết sâu	`https://example.web.app/welcome`
Ứng dụng Android	`com.example.android`
Ứng dụng Apple	`com.example.ios`
Đường liên kết động dài	`https://example.page.link/?link=https://example.web.app/welcome&apn=com.example.android&isi=123456789&ibi=com.example.iuos`
Đường liên kết động ngắn	`https://example.page.link/m9Mm`

Trong trường hợp này, bạn sẽ trích xuất tham số đường liên kết sâu – tức là https://example.web.app/welcome và hiện sẽ sử dụng tham số này làm tham số Đường liên kết toàn cầu cho ứng dụng của bạn.

Lưu ý: Trong lần đầu tạo Đường liên kết động của Firebase, bạn có thể đã tạo một tham số liên kết sâu sử dụng một miền mà bạn không sở hữu (ví dụ: example.com/welcome). Đường liên kết động của Firebase đã hỗ trợ việc này. Tuy nhiên, trong quá trình di chuyển này, bạn phải thay đổi mọi đường liên kết sâu mà bạn định sử dụng để sử dụng miền mà bạn sở hữu và đã được định cấu hình trước đó thông qua tính năng Lưu trữ Firebase. Nếu bạn đã sử dụng miền bạn sở hữu cho các tham số URL liên kết sâu dùng trong Đường liên kết động của Firebase, thì việc này có thể giúp bạn tiết kiệm nhiều thời gian và ứng dụng của bạn có thể đã được định cấu hình để xử lý các Đường liên kết phổ quát sắp tới mà bạn cần tạo.

Ví dụ: vui lòng xem nhóm các đường liên kết ngắn, thông số đường liên kết sâu và giá trị đường liên kết sâu đã di chuyển của Firebase sau đây:

Đường liên kết ngắn	Thông số đường liên kết sâu	Đường liên kết sâu đã di chuyển
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

Tiếp theo, bạn cần thay thế mọi thực thể của Liên kết động Firebase đã được phát hành hoặc chia sẻ bằng các đường liên kết sâu mới di chuyển để người dùng nhấp vào các Đường liên kết phổ quát đó thay vì Liên kết động Firebase trước đó.

Cập nhật ứng dụng iOS và mã ứng dụng để nhận đường liên kết sâu

Bước tiếp theo sau khi chọn miền, bạn cần chọn giản đồ liên kết sâu và di chuyển Đường liên kết động của Firebase sang Đường liên kết phổ quát là cập nhật ứng dụng iOS và mã xử lý ứng dụng để nhận được các đường liên kết sâu mới.

Bạn nên làm theo tài liệu đầy đủ về Đường liên kết phổ quát tại đây để định cấu hình ứng dụng xử lý đường liên kết sâu, nhưng các bước chính bao gồm:

Cập nhật cấu hình dự án để cho phép ứng dụng xử lý các liên kết sâu từ miền mới tạo
Nhận đường liên kết sâu trong mã xử lý ứng dụng của bạn

Để cập nhật cấu hình dự án nhằm cho phép ứng dụng xử lý các đường liên kết sâu, bạn cần thêm một Miền được liên kết vào dự án trong xCode cho miền mà bạn hiện đang dự định sử dụng để lưu trữ tệp apple-app-site-associate.

Điều này có thể được thực hiện bằng cách:

Mở Xcode
Chọn dự án trong trình điều hướng tệp
Chuyển đến thẻ Ký và chức năng trong phần cài đặt dự án
Chuyển xuống phần Miền được liên kết
Nhấp vào nút + để thêm miền bổ sung vào dự án của bạn ở định dạng "applinks:".

Cuối cùng, bạn cần cập nhật mã ứng dụng để có thể nhận được các đường liên kết sâu đến.

Để thực hiện việc này, trước tiên, hãy cập nhật tệp AppDelegate.swift để phản hồi Universal Link bằng cách thêm mã sau:

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)
}

Mã trên ghi đè phương thức gọi lại Đường liên kết phổ quát và ghi lại URL đường liên kết sâu nếu có.

Bây giờ, chúng ta cũng sẽ gọi cùng một phương thức showReceivedUrl từ lớp SceneDelegate vì nếu ứng dụng đã mở vào thời điểm người dùng nhấp vào đường liên kết phổ quát, thì lệnh gọi lại đường liên kết phổ quát bên trong SceneDelegate sẽ là lệnh được gọi.

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

Kiểm thử đường liên kết phổ quát

Bạn có thể kiểm thử các Đường liên kết phổ quát mà bạn vừa tạo bằng cách chạy ứng dụng trên thiết bị thực hoặc trình mô phỏng.

Bạn cần tạo một đường liên kết có thể nhấp bằng miền được định cấu hình cho Universal Links, sau đó nhấp vào đường liên kết đó để đảm bảo rằng đường liên kết đó mở ra ứng dụng và đưa bạn đến màn hình dự kiến trong ứng dụng.

Hỗ trợ Biểu ngữ ứng dụng thông minh

Bạn nên sử dụng Biểu ngữ ứng dụng thông minh để mang đến cho người dùng trải nghiệm tương tự với Đường liên kết động của Firebase.

Khi sử dụng Biểu ngữ ứng dụng thông minh, người dùng sẽ được chuyển đến trang thông tin của ứng dụng trên Cửa hàng ứng dụng nếu họ chưa cài đặt ứng dụng của bạn trên thiết bị. Bạn cũng có thể tuỳ ý định cấu hình một tham số để truyền vào ứng dụng sau khi tải xuống và cài đặt để cung cấp cho người dùng sự tiếp nối hành trình của họ. Nếu bạn đã cài đặt ứng dụng, ứng dụng sẽ mở ra và truyền tham số vào ứng dụng để giúp người dùng chuyển đến nội dung phù hợp dựa trên Biểu ngữ ứng dụng thông minh mà họ đã nhấp vào.

Thay thế Đường liên kết động của Firebase đã xuất bản hoặc chia sẻ bằng Đường liên kết trong ứng dụng

Bước cuối cùng để di chuyển là thay thế Liên kết động của Firebase đã xuất bản hoặc được chia sẻ bằng Đường liên kết phổ quát bất cứ khi nào có thể và tiếp tục sử dụng Đường liên kết phổ quát trong tương lai.

Cách hoàn tất bước này sẽ khác nhau tuỳ thuộc vào vị trí và cách bạn phát hành Liên kết động của Firebase.

Để giúp bạn theo dõi các Đường liên kết động hiện có của Firebase cần di chuyển, chúng tôi sẽ phát hành hướng dẫn về cách xuất siêu dữ liệu đường liên kết ngắn từ Đường liên kết động của Firebase. Vui lòng kiểm tra lại tài liệu Câu hỏi thường gặp về việc ngừng sử dụng đường liên kết động để biết thêm thông tin mới.