Cách Chrome xử lý bản cập nhật cho tệp kê khai ứng dụng web

Những việc cần làm để thay đổi biểu tượng, lối tắt, màu sắc và các siêu dữ liệu khác cho PWA của bạn

Adriana Jara
François Beaufort
François Beaufort
GitHub
Pete LePage

Khi PWA được cài đặt, trình duyệt sẽ sử dụng thông tin từ tệp kê khai ứng dụng web cho tên ứng dụng, các biểu tượng mà ứng dụng sẽ sử dụng và URL nên mở khi khởi chạy ứng dụng. Nhưng nếu bạn cần cập nhật lối tắt ứng dụng hoặc thử một màu giao diện mới thì sao? Những thay đổi đó được phản ánh trong trình duyệt khi nào và như thế nào?

Trong hầu hết các trường hợp, các thay đổi sẽ được phản ánh trong vòng một hoặc hai ngày kể từ khi PWA khởi động, sau khi tệp kê khai được cập nhật.

Nội dung cập nhật về Chrome dành cho máy tính

Khi PWA khởi chạy hoặc mở trong một thẻ trình duyệt, Chrome sẽ xác định thời điểm gần nhất mà tệp kê khai cục bộ được kiểm tra để xem có thay đổi hay không. Nếu tệp kê khai chưa được kiểm tra kể từ lần gần đây nhất trình duyệt khởi động hoặc chưa được kiểm tra trong 24 giờ qua, thì Chrome sẽ đưa ra yêu cầu mạng cho tệp kê khai, sau đó so sánh tệp đó với bản sao cục bộ.

Nếu một số thuộc tính trong tệp kê khai đã thay đổi (xem danh sách bên dưới), Chrome sẽ đưa tệp kê khai mới vào hàng đợi và sau khi tất cả cửa sổ đã đóng, hãy cài đặt tệp kê khai đó. Sau khi cài đặt, tất cả các trường trong tệp kê khai mới (ngoại trừ name, short_name và icons) đều được cập nhật.

Cơ sở lưu trú nào sẽ kích hoạt quá trình cập nhật?

  • display (xem bên dưới)
  • scope
  • shortcuts
  • start_url
  • theme_color
  • file_handlers

Điều gì sẽ xảy ra khi trường display được cập nhật?

Nếu bạn cập nhật chế độ hiển thị của ứng dụng từ browser thành standalone, thì người dùng hiện tại của bạn sẽ không mở ứng dụng trong một cửa sổ sau khi cập nhật. Có hai chế độ cài đặt hiển thị cho một ứng dụng web, một chế độ cài đặt trong tệp kê khai (mà bạn kiểm soát) và một chế độ cài đặt thẻ cửa sổ/trình duyệt do người dùng kiểm soát. Lựa chọn ưu tiên của người dùng sẽ luôn được tôn trọng.

Kiểm thử việc cập nhật tệp kê khai

Trang chrome://web-app-internals (có trong Chrome 85 trở lên) chứa thông tin chi tiết về tất cả PWA được cài đặt trên thiết bị, đồng thời có thể giúp bạn nắm được thời điểm cập nhật tệp kê khai gần đây nhất, tần suất cập nhật tệp kê khai và nhiều thông tin khác.

Để buộc Chrome kiểm tra tệp kê khai cập nhật theo cách thủ công, bạn có thể chạy Chrome bằng cờ dòng lệnh --disable-manifest-update-throttle hoặc khởi động lại Chrome (sử dụng about://restart). Thao tác này sẽ đặt lại bộ tính giờ để Chrome kiểm tra tệp kê khai đã cập nhật khi PWA khởi chạy tiếp theo. Sau đó, chạy PWA. Sau khi đóng PWA, bạn phải cập nhật PWA bằng các thuộc tính mới của tệp kê khai.

Tài liệu tham khảo

Các cập nhật trên Chrome dành cho Android

Khi PWA khởi chạy, Chrome sẽ xác định thời điểm gần đây nhất mà tệp kê khai cục bộ được kiểm tra để xem có thay đổi hay không. Nếu tệp kê khai chưa được kiểm tra trong 24 giờ qua, Chrome sẽ lên lịch yêu cầu mạng cho tệp kê khai, sau đó so sánh tệp đó với bản sao cục bộ.

Nếu một số thuộc tính trong tệp kê khai đã thay đổi (xem danh sách bên dưới), Chrome sẽ đưa tệp kê khai mới vào hàng đợi và sau khi tất cả các cửa sổ của PWA đóng, thiết bị được cắm và kết nối với Wi-Fi, Chrome sẽ yêu cầu WebAPK cập nhật từ máy chủ. Sau khi cập nhật, tất cả các trường trong tệp kê khai mới sẽ được sử dụng.

Cơ sở lưu trú nào sẽ kích hoạt quá trình cập nhật?

  • background_color
  • display
  • orientation
  • scope
  • shortcuts
  • start_url
  • theme_color
  • web_share_target

Nếu Chrome không thể tải tệp kê khai cập nhật từ máy chủ, thì thời gian giữa các lần kiểm tra có thể tăng lên 30 ngày.

Kiểm thử việc cập nhật tệp kê khai

Trang about://webapks có thông tin chi tiết về tất cả PWA đã cài đặt trên thiết bị, đồng thời có thể cho bạn biết tệp kê khai được cập nhật lần gần nhất là khi nào, tần suất cập nhật tệp kê khai và nhiều thông tin khác.

Để lên lịch cập nhật tệp kê khai theo cách thủ công, việc ghi đè bộ tính giờ và tệp kê khai cục bộ sẽ thực hiện như sau:

  1. Cắm thiết bị vào nguồn điện và đảm bảo thiết bị kết nối với Wi-Fi.
  2. Sử dụng trình quản lý tác vụ Android để tắt PWA, sau đó sử dụng Bảng điều khiển ứng dụng trong phần cài đặt Android để buộc dừng PWA.
  3. Trong Chrome, hãy mở about://webapks rồi nhấp vào nút "Cập nhật" của PWA. "Trạng thái cập nhật" sẽ chuyển thành "Đang chờ xử lý".
  4. Khởi chạy PWA và xác minh rằng PWA đã được tải đúng cách.
  5. Sử dụng trình quản lý tác vụ Android để tắt PWA, sau đó sử dụng Bảng điều khiển ứng dụng trong phần cài đặt Android để buộc dừng PWA.

PWA thường cập nhật trong vòng vài phút, sau khi quá trình cập nhật hoàn tất, "Trạng thái cập nhật" sẽ chuyển thành "Thành công"

Tài liệu tham khảo