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

Adriana Jara

François Beaufort

Pete LePage

Khi PWA được cài đặt, trình duyệt 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 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 đó. 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
• 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) bao gồm thông tin chi tiết về tất cả các PWA được cài đặt trên thiết bị và có thể giúp bạn hiểu 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 cần cập nhật PWA bằng các thuộc tính tệp kê khai mới.

Tài liệu tham khảo

• Trường tệp kê khai web có thể cập nhật

Các 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 thay đổi. 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ửa sổ của PWA đã đóng, thiết bị được cắm và kết nối với WiFi, 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 thuộc tính nào sẽ kích hoạt quá trình 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ể lấy 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ả các PWA đã cài đặt trên thiết bị và có thể cho bạn biết 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.

Để 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à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ẽ thay đổi 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 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

• UpdateReason enum cho Chrome trên Android