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à các siêu dữ liệu khác cho PWA

Adriana Jara
François Beaufort
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ột màu chủ đề mới thì sao? Khi nào và bằng cách nào những thay đổi đó được phản ánh 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 PWA được ra mắt, sau khi tệp kê khai được cập nhật.

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

Khi PWA được 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 để 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ẽ đưa ra 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 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à cài đặt tệp kê khai đó sau khi tất cả các cửa sổ đã đóng. Sau khi cài đặt, tất cả các trường trong tệp kê khai mới, ngoại trừ icons, sẽ được cập nhật.

Những thuộc tính nào sẽ kích hoạt quá trình cập nhật?

  • name
  • short_name
  • display (xem bên dưới)
  • scope
  • shortcuts
  • start_url Thận trọng: Bạn cần đặt tệp kê khai id thì mới có thể thay đổi start_url. Tìm hiểu thêm.
  • 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 thành 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ó 2 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 (do bạn kiểm soát) và một chế độ cài đặt cửa sổ và thẻ 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ử các bản 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ả các ứng dụng PWA được cài đặt trên thiết bị và có thể giúp bạn biết được thời điểm tệp kê khai được cập nhật lần gần đây 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ộ hẹn giờ để Chrome kiểm tra tệp kê khai đã cập nhật vào lần tiếp theo PWA được chạy. Sau đó, hãy chạy PWA. Sau khi đóng PWA, PWA 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

Thông tin cập nhật về Chrome dành cho Android

Khi PWA được 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 chưa kiểm tra tệp kê khai 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 trong tệp kê khai đã thay đổi (xem danh sách bên dưới), Chrome sẽ xếp hàng tệp kê khai mới và sau khi tất cả cá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 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 dùng.

Những thuộc tính nào kích hoạt việc cập nhật?

  • name
  • short_name
  • icons
  • background_color
  • display
  • orientation
  • scope
  • shortcuts
  • start_url
  • theme_color
  • web_share_target

Nếu không thể nhận được tệp kê khai mới 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ử các bản cập nhật tệp kê khai

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

  1. Cắm thiết bị 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, sau đó 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" cho PWA. "Cập nhật trạng thái" sẽ thay đổi 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, sau đó 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ẽ thay đổi thành "Thành công"

Tài liệu tham khảo