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

Di chuyển tính năng đăng nhập bằng đường liên kết email khỏi Đường liên kết động của Firebase (Android)

Trước đây, tính năng xác thực bằng đường liên kết trong email dựa vào Firebase Dynamic Links. Tính năng này sẽ ngừng hoạt động vào ngày 25 tháng 8 năm 2025. Chúng tôi đã xuất bản một giải pháp thay thế trong Firebase Authentication Android SDK phiên bản 23.2.0 trở lên và Firebase BoM phiên bản 33.9.0 trở lên. Nếu ứng dụng của bạn sử dụng các đường liên kết kiểu cũ và bạn muốn sử dụng một phương thức thay thế để di chuyển ứng dụng, hãy xem phần Xác thực bằng Firebase bằng đường liên kết qua email trong Android để sử dụng hệ thống mới dựa trên Firebase Hosting.

Ngoài ra, nếu đang sử dụng SDK Android Firebase Authentication dưới phiên bản 20.0.0 (hoặc Firebase BoM dưới phiên bản 26.0.0) để quản lý quy trình OAuth bằng Firebase Authentication, bạn cần cập nhật lên SDK Authentication hoặc phiên bản BoM mới nhất (Authentication phiên bản 20.0.0 trở lên hoặc BoM phiên bản 26.0.0 trở lên) để tiếp tục quản lý quy trình OAuth trong Firebase Authentication.

Di chuyển miền Firebase Dynamic Links được liên kết sang miền Firebase Hosting

Trong tương lai, thay vì sử dụng miền Firebase Dynamic Links, Firebase Authentication sẽ sử dụng miền mặc định Firebase Hosting cho dự án của bạn để tạo đường liên kết cho đường liên kết trong email và các hành động liên kết ngoài băng tần khác trong ứng dụng di động. Điều này có nghĩa là bạn cũng cần cập nhật ứng dụng để sử dụng miền mặc định này làm miền được liên kết cho các đường liên kết xác thực email đến ứng dụng di động của bạn.

Bạn có thể làm theo hướng dẫn trong bài viết Xác thực bằng Firebase bằng cách sử dụng đường liên kết qua email trong Android để cập nhật đường liên kết đến ứng dụng di động nhằm sử dụng miền mặc định Firebase Hosting mới được cung cấp tự động.

Hãy làm theo hướng dẫn sau để xử lý các đường liên kết từ miền mới và hướng dẫn Firebase Authentication bắt đầu sử dụng miền mới để tạo các đường liên kết đến ứng dụng di động từ nay về sau.

Nếu bạn muốn tiếp tục sử dụng bất kỳ miền Firebase Hosting tuỳ chỉnh nào hoặc thậm chí cả miền Firebase Dynamic Links tuỳ chỉnh làm miền được liên kết mới, hãy làm theo các bước phù hợp với miền mà bạn muốn sử dụng. Xin lưu ý rằng sau khi bạn hoàn tất hướng dẫn trong phần sau, tính năng liên kết sâu trên miền tuỳ chỉnh Firebase Dynamic Links của bạn sẽ bị xoá; chỉ miền đó vẫn còn để tạo đường liên kết trong email.

Định cấu hình ứng dụng Android để xử lý đường liên kết Firebase Hosting
1. Để xử lý các đường liên kết này từ ứng dụng Android, bạn cần chỉ định tên gói của ứng dụng trong phần cài đặt dự án Firebase của bảng điều khiển. Ngoài ra, bạn cần cung cấp SHA-1 và SHA-256 của chứng chỉ ứng dụng.
2. Nếu muốn các đường liên kết Firebase Hosting này chuyển hướng đến một hoạt động cụ thể, bạn sẽ cần định cấu hình một bộ lọc ý định trong tệp AndroidManifest.xml. Bộ lọc ý định phải bắt được các đường liên kết Firebase Hosting của miền. Trong AndroidManifest.xml:
```
<intent-filter android:autoVerify="true">
  <action android:name="android.intent.action.VIEW" />
  <category android:name="android.intent.category.BROWSABLE" />
  <category android:name="android.intent.category.DEFAULT" />
  <data
    android:scheme="https"
    android:host="PROJECT_ID.firebaseapp.com or a custom hosting domain"
    android:pathPrefix="/__/auth/links" />
</intent-filter>
```
Khi người dùng mở một đường liên kết lưu trữ có đường dẫn "/__/auth/links" và lược đồ cũng như máy chủ mà bạn chỉ định, ứng dụng của bạn sẽ bắt đầu hoạt động bằng bộ lọc ý định này để xử lý đường liên kết.

Lưu ý quan trọng: Để đảm bảo quá trình khôi phục diễn ra suôn sẻ, bạn nên giữ lại bộ lọc ý định hiện có xử lý Firebase Dynamic Links trong khi dùng thử giải pháp liên kết Firebase Hosting. Giải pháp Firebase Dynamic Links sẽ có hiệu lực cho đến hết ngày 25 tháng 8 năm 2025.
Định cấu hình dự án để sử dụng các đường liên kết mới

Khi đã sẵn sàng xử lý các đường liên kết đến miền mới, bạn có thể sử dụng Firebase Admin SDK để cập nhật cách bạn muốn tạo đường liên kết qua email và hướng dẫn hệ thống phụ trợ của chúng tôi bắt đầu tạo đường liên kết bằng miền Firebase Hosting mới.
```
const updateRequest = {
  mobileLinksConfig: {
      domain: 'HOSTING_DOMAIN'
  }
}
const updateProjectConfig = () => {
  projectConfigManager.updateProjectConfig(updateRequest)
  .then((response) => {
      // updated project config
  }).catch((error) => {
      console.log('Error updating the project:', error);
  });
}
```
Lưu ý quan trọng: Để khôi phục về Firebase Dynamic Links trong khi triển khai và kiểm thử giải pháp sao lưu, bạn nên đặt miền về FIREBASE_DYNAMIC_LINK. Giải pháp Firebase Dynamic Links sẽ có hiệu lực cho đến hết ngày 25 tháng 8 năm 2025.
Gửi và đổi đường liên kết trong email

Gửi đường liên kết đăng nhập bằng email như trước đây. Khi người dùng cuối nhấp vào đường liên kết, họ sẽ được chuyển hướng đến ứng dụng (nếu đã cài đặt) để hoàn tất quy trình đăng nhập.

Tuỳ chỉnh đường liên kết trên thiết bị di động

Bạn có thể sử dụng miền Firebase Hosting tuỳ chỉnh hoặc sử dụng lại miền Firebase Dynamic Links tuỳ chỉnh để làm miền mới cho đường liên kết đến thiết bị di động.

Sử dụng miền Firebase Hosting tuỳ chỉnh

Làm theo Firebase Hostinghướng dẫn để thiết lập một miền tuỳ chỉnh.
Định cấu hình ứng dụng Android để xử lý đường liên kết Firebase Hosting. (hướng dẫn trong phần trước ở trên).
Gửi đường liên kết xác thực đến địa chỉ email của người dùng bằng đối tượng ActionCodeSettings đã cập nhật có miền tuỳ chỉnh là linkDomain.

Sử dụng lại miền tuỳ chỉnh Firebase Dynamic Links

Bạn có thể sử dụng lại bất kỳ miền Firebase Dynamic Links nào của mình làm miền tuỳ chỉnh. Tuy nhiên, mọi chức năng Firebase Dynamic Links sẽ không còn được hỗ trợ (ví dụ: người dùng không thể được chuyển hướng đến một cửa hàng ứng dụng nếu ứng dụng chưa được cài đặt trên thiết bị của họ).
Định cấu hình ứng dụng Android để xử lý đường liên kết Firebase Hosting (hướng dẫn ở phần trước).
Gửi đường liên kết xác thực đến địa chỉ email của người dùng bằng đối tượng ActionCodeSettings đã cập nhật có miền tuỳ chỉnh là linkDomain.