Cập nhật các tiện ích của bạn trước khi có những thay đổi sắp tới đối với tính năng đồng bộ hoá dấu trang

James Lee
James Lee

Ngày xuất bản: 17 tháng 6 năm 2025

Tháng 8 năm ngoái, chúng tôi đã thông báo về những thay đổi sắp tới đối với mô hình nhận dạng của Chrome trên các nền tảng Windows, Mac và Linux, sau những thay đổi đã được ra mắt trên iOS và Android. Mục tiêu của những thay đổi này là điều chỉnh Chrome cho phù hợp với kỳ vọng hiện tại của người dùng về việc đăng nhập. Người dùng ngày càng mong muốn chỉ cần đăng nhập để truy cập vào dữ liệu của họ, bao gồm cả dấu trang, và đăng xuất để giữ an toàn cho dữ liệu đó.

Trong quá trình triển khai những nội dung cập nhật này, chúng tôi sẽ thay đổi cách Chrome lưu trữ dấu trang trên máy tính. Ví dụ: những dấu trang được lưu trữ cục bộ trên một thiết bị sẽ vẫn là dữ liệu cục bộ sau khi người dùng đăng nhập. Người dùng có thể chọn tải dữ liệu đó lên Tài khoản Google của họ theo từng dấu trang hoặc hàng loạt. Để cho phép các tiện ích hỗ trợ những tính năng này, chúng tôi sẽ cung cấp dữ liệu mới trên Chrome Extensions API. Thông tin sau đây liên quan đến mọi tác giả của Tiện ích Chrome sử dụng API chrome.bookmarks.

Tổng quan

Hiện tại, người dùng luôn có một nhóm thư mục cấp cao nhất, bao gồm cả thư mục "Thanh dấu trang" và "Dấu trang khác". Dữ liệu trong các thư mục này có thể được đồng bộ hoá hoặc không, tuỳ thuộc vào việc người dùng có đăng nhập và bật tính năng đồng bộ hoá hay không.

Trong quá trình thay đổi mô hình nhận dạng, Chrome sẽ tách các dấu trang đồng bộ hoá và không đồng bộ hoá thành hai cây con riêng biệt trong cây dấu trang. Trong một số trường hợp, nếu người dùng không chọn tải tất cả dấu trang lên tài khoản của họ, thì người dùng có thể có cả thư mục dấu trang đồng bộ hoá và không đồng bộ hoá cùng một lúc. Bạn có thể phải cập nhật những tiện ích sử dụng API dấu trang để hiển thị cây dấu trang theo cách rõ ràng đối với người dùng.

Các thay đổi chi tiết về API

Đối với những người dùng có cả dấu trang đồng bộ hoá và không đồng bộ hoá, API dấu trang có thể trả về một cây tương tự như cây sau đây trên API getTree:

  • id=A (name: "Bookmarks bar", folderType: "bookmarks-bar", syncing: true)
    • …
  • id=B (name: "Other bookmarks", folderType: "other", syncing: true)
    • …
  • id=C (name: "Bookmarks bar", folderType: "bookmarks-bar", syncing: false)
    • …
  • id=D (name: "Other bookmarks", folderType: "other", syncing: false)
    • …

Để cho phép nhà phát triển tiện ích phân biệt giữa các thư mục cấp cao nhất này, hai thuộc tính mới đã được thêm vào API:

  • folderType: cho phép các tiện ích xác định các thư mục "đặc biệt" như thanh dấu trang. Xin lưu ý rằng bạn không nên dùng name và id cho mục đích này (name phụ thuộc vào ngôn ngữ và id không cố định)
  • syncing: cho phép các tiện ích phân biệt giữa các phần đồng bộ hoá và không đồng bộ hoá của cây. Đây sẽ là true trước khi mô hình nhận dạng thay đổi nếu người dùng đã đăng nhập và bật tính năng đồng bộ hoá.

Thông tin cập nhật về tiện ích

Nếu bất kỳ điều nào sau đây đúng với tiện ích của bạn, thì có thể bạn cần cập nhật:

  • Nếu tiện ích của bạn hiển thị toàn bộ kết quả của getTree cho người dùng để ngăn các phiên bản có tên giống hệt nhau (ví dụ: thanh dấu trang) xuất hiện. Bạn có thể muốn thêm một hậu tố vào tên hoặc cung cấp một số cách xử lý khác cho giao diện người dùng.
  • Nếu tiện ích của bạn cố gắng so khớp thanh dấu trang, các thư mục khác hoặc thư mục cố định trên thiết bị di động bằng id hoặc name. Những phương thức này đã không được hỗ trợ.
  • Nếu tiện ích của bạn giả định rằng có chính xác hoặc tối đa một phiên bản của thư mục cố định thanh dấu trang, thư mục khác hoặc thư mục cố định trên thiết bị di động

Thử nghiệm

Các thuộc tính API tiện ích folderType và syncing mới được ghi lại và có trong bản phát hành Chrome Canary mới nhất (phiên bản 138.0.7196.0 trở lên).

Người dùng trong các kênh Chrome ổn định chỉ có một bộ nhớ (tức là tối đa một bộ nhớ cho mỗi loại thư mục). Để kiểm thử, bạn có thể bật bộ nhớ kép như sau:

  1. Bật cả hai mục sau trong chrome://flags rồi khởi động lại Chrome
    • sync-enable-bookmarks-in-transport-mode
    • enable-bookmarks-selected-type-on-signin-for-testing
  2. Thêm một hồ sơ Chrome mới (https://support.google.com/chrome/answer/2364824)
    • Không đăng nhập: chọn "Tiếp tục mà không cần tài khoản".
  3. Nếu bạn đánh dấu trang, các trang đó sẽ được thêm vào bộ nhớ không đồng bộ hoá.
  4. Bây giờ, hãy đăng nhập vào Chrome:
    • Nhấp vào ảnh đại diện đó ở trên cùng bên phải, bên cạnh trình đơn có biểu tượng ba dấu chấm.
    • Nhấp vào "Đăng nhập vào Chrome" rồi làm theo lời nhắc.
    • Chọn "Không, cảm ơn" khi được hỏi bạn có muốn bật tính năng đồng bộ hoá hay không.
  5. Nếu bạn đánh dấu trang, các trang đó sẽ được thêm vào bộ nhớ đồng bộ hoá (cho phép bạn kiểm thử trường hợp sử dụng bộ nhớ kép).

Tiến trình

Những thay đổi để hiển thị bộ nhớ kép sẽ được triển khai từng bước và sẽ bắt đầu triển khai cho một nhóm nhỏ người dùng Kênh ổn định của Chrome chậm nhất là vào cuối tháng 6 năm 2025, bắt đầu từ một tỷ lệ nhỏ người dùng rồi mở rộng phạm vi triển khai trong những tuần tiếp theo.