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

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

Adriana Jara
[Tên người]
François Beaufort
GitHub
Pete LePage

Khi một 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 nên sử dụng và URL sẽ được mở khi ứng dụng khởi chạy. Nhưng nếu bạn cần cập nhật lối tắt ứng dụng hoặc thử màu giao diện mới thì sao? Những thay đổi đó được phản ánh khi nào và được phản ánh như thế nào trong trình duyệt?

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 khởi chạy PWA, sau khi tệp kê khai được cập nhật.

Các bản cập nhật trên Chrome dành cho máy tính

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

Nếu một số thuộc tính chọn 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 đó. Sau khi cài đặt, tất cả các trường của tệp kê khai mới (ngoại trừ name, short_name và icons) đều được cập nhật.

Những tài sản nào sẽ kích hoạt quy trình cập nhật?

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

Điều gì 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 lên standalone, thì người dùng hiện tại 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 ứng dụng web, một chế độ từ tệp kê khai (mà bạn kiểm soát) và chế độ cài đặt thẻ cửa sổ/trình duyệt do người dùng kiểm soát. Chúng tôi luôn tôn trọng lựa chọn ưu tiên của người dùng.

Kiểm thử bản 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 biết thời điểm gần đây nhất tệp kê khai được cập nhật, tần suất cập nhật 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 sẽ kiểm tra tệp kê khai đã cập nhật vào lần tiếp theo bạn chạy PWA. Sau đó, chạy PWA. Sau khi đóng PWA, ứng dụng sẽ được cập nhật bằng các thuộc tính tệp kê khai mới.

Tài liệu tham khảo

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

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

Nếu một số thuộc tính chọn 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ổ của PWA đã đóng, thiết bị được cắm điện và kết nối với Wi-Fi, Chrome sẽ yêu cầu một 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.

Những tài sản nào sẽ kích hoạt quy 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ì Chrome có thể tăng thời gian giữa các lần kiểm tra lên 30 ngày.

Kiểm thử bản cập nhật tệp kê khai

Trang about://webapks bao gồm thông tin chi tiết về tất cả PWA đã cài đặt trên thiết bị, và có thể cho bạn biết thời điểm gần đây nhất tệp kê khai được cập nhật, tần suất cập nhật 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ẽ làm như sau:

  1. Cắm thiết bị vào nguồn điện và đảm bảo rằng 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 chế độ 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" cho PWA. "Trạng thái của bản cập nhật" sẽ chuyển thành "Đang chờ xử lý".
  4. Chạy PWA và xác minh rằng PWA đã 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 chế độ 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