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

Trước đây, tính năng xác thực đườ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 đã phát hành một giải pháp thay thế trong SDK iOS Firebase Authentication phiên bản 11.8.0 trở lên. Nếu ứng dụng của bạn sử dụng Firebase Dynamic Links, bạn nên di chuyển ứng dụng sang hệ thống dựa trên Firebase Hosting mới.

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

Từ giờ trở đi, 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 email và các hành động liên kết ngoài phạm vi 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 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 phần Xác thực bằng Firebase bằng cách sử dụng đường liên kết email trên các nền tảng của Apple để cập nhật ứng dụng của bạn 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 Firebase Hosting để tạo đường liên kết đến ứng dụng di động trong tương lai.

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í là miền Firebase Dynamic Links tuỳ chỉnh làm miền liên kết mới, hãy sử dụng hướng dẫn trong phần Tuỳ chỉnh đường liên kết trên thiết bị di động, điều chỉnh các bước cho phù hợp với miền mà bạn muốn sử dụng.

  1. Liên kết miền Firebase Hosting với miền liên kết của ứng dụng.

    Bạn cần định cấu hình miền đã chọn làm Miền được liên kết cho các đường liên kết ứng dụng. Để thiết lập quyền trong ứng dụng, hãy mở thẻ Signing & Capabilities (Ký và chức năng) của mục tiêu trong Xcode rồi thêm các miền Firebase Hosting từ bước trước vào chức năng Miền được liên kết. Nếu sử dụng miền Firebase Hosting mặc định, thì giá trị này sẽ là applinks:PROJECT_ID.firebaseapp.com.

    Hãy xem phần Hỗ trợ các miền được liên kết trên trang web tài liệu của Apple để biết thêm thông tin.

    Tệp miền được liên kết đã được triển khai trong tất cả các miền Firebase Hosting của bạn. Để truy cập vào tệp này, hãy chuyển đến PROJECT_ID.firebaseapp.com/.well-known/apple-app-site-association. Tệp AASA này có thể bị ghi đè; hãy xem phần Tạo và lưu trữ tệp cấu hình Đường liên kết phổ quát để biết thêm thông tin.

  2. Định cấu hình dự án của bạ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 miền mới, bạn có thể sử dụng SDK quản trị Firebase để cập nhật cách bạn muốn tạo đường liên kết email và hướng dẫn phần 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);
});
}

  3. Gửi và sử dụng đường liên kết trong email.

    Gửi đường liên kết đăng nhập qua email như trước. 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.

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 đường liên kết mới cho thiết bị di động.

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

  1. Làm theo hướng dẫn về Firebase Hosting để thiết lập miền tuỳ chỉnh.
  2. Liên kết miền tuỳ chỉnh với miền được liên kết của ứng dụng.
  3. 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 với miền tuỳ chỉnh là linkDomain.
  1. Bạn có thể sử dụng lại bất kỳ miền Firebase Dynamic Links nào 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ợ nữa (ví dụ: người dùng không thể được chuyển hướng đến cửa hàng ứng dụng nếu ứng dụng không được cài đặt trên thiết bị của họ).
  2. 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 với miền tuỳ chỉnh là linkDomain.