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 bạn cài đặt PWA, trình duyệt sẽ sử dụng thông tin từ ứng dụng web tệp kê khai cho tên ứng dụng, các biểu tượng mà ứng dụng sẽ sử dụng và URL sẽ được mở khi ứng dụng được khởi chạy. Nhưng nếu bạn cần cập nhật hoặc thử một màu giao diện mới? Những thay đổi đó diễn ra khi nào và như thế nào có trong trình duyệt không?

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

Nội dung cập nhật về 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 đây nhất tệp kê khai cục bộ được kiểm tra thay đổi. 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, Chrome sẽ thực hiện yêu cầu mạng cho tệp kê khai, sau đó so sánh nó 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 đưa tệp kê khai mới vào hàng đợi và sau khi đóng tất cả các cửa sổ, 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) đã đượ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, người dùng hiện tại sẽ không mở ứng dụng của mình trong một cửa sổ sau khi cập nhật. Có là hai cài đặt hiển thị cho một ứng dụng web, cài đặt từ tệp kê khai (mà bạn kiểm soát) và cài đặt thẻ cửa sổ/trình duyệt do người dùng kiểm soát. Người dùng lựa chọn ưu tiên 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), 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ể giúp bạn nắm được lần gần nhất tệp kê khai được cập nhật là khi nào, tần suất nó được cập nhật và nhiều nội dung 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 với 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ìm tệp kê khai mới 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 tệp kê khai mới các thuộc tính.

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 tệp kê khai cục bộ đã được kiểm tra các thay đổi. Nếu tệp kê khai không được kiểm tra trong 24 năm qua giờ, Chrome sẽ lên lịch yêu cầu mạng cho tệp kê khai, sau đó so sánh bản sao đó dựa vào 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 đư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 nguồn và kết nối với Wi-Fi, Chrome sẽ yêu cầu bạn cập nhật WebAPK 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ẽ đã 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 không thể tải tệp kê khai cập nhật từ máy chủ, 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ử việc 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 tệp kê khai nằm gần đây nhất đượ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, hãy ghi đè bộ tính giờ và tệp kê khai cục bộ sẽ thực hiện những việc 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. Dùng trình quản lý tác vụ Android để tắt PWA rồi 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" nút dành cho PWA. "Trạng thái của bản 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. Dùng trình quản lý tác vụ Android để tắt PWA rồi 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ủa bản cập nhật" sẽ chuyển thành "Thành công"

Tài liệu tham khảo