Tệp kê khai ứng dụng web không đáp ứng các yêu cầu về khả năng cài đặt

Khả năng cài đặt là một yêu cầu cốt lõi của Ứng dụng web tiến bộ (PWA). Bằng việc nhắc người dùng cài đặt PWA, bạn cho phép họ thêm PWA vào màn hình chính. Người dùng thêm ứng dụng vào màn hình chính sẽ tương tác với những ứng dụng đó thường xuyên hơn.

Tệp kê khai ứng dụng web bao gồm các phần thông tin chính cần thiết để giúp ứng dụng của bạn có thể cài đặt.

Cách quy trình kiểm tra tệp kê khai ứng dụng web Lighthouse không thành công

Lighthouse gắn cờ các trang không có tệp kê khai ứng dụng web đáp ứng các yêu cầu tối thiểu về khả năng cài đặt:

Kiểm tra Lighthouse cho thấy người dùng không thể cài đặt ứng dụng web từ màn hình chính

Nếu tệp kê khai của một trang không bao gồm các thuộc tính sau, thì quá trình kiểm tra sẽ không thành công:

  • Thuộc tính short_name hoặc name
  • Thuộc tính icons bao gồm biểu tượng 192x192 px và 512x512 px
  • Thuộc tính start_url
  • Thuộc tính display được đặt thành fullscreen, standalone hoặc minimal-ui
  • Thuộc tính prefer_related_applications được đặt thành một giá trị không phải là true.

Cách làm cho PWA có thể cài đặt

Đảm bảo ứng dụng của bạn có tệp kê khai đáp ứng các tiêu chí ở trên. Hãy xem phần Có thể cài đặt để biết thêm thông tin về cách tạo PWA.

Cách kiểm tra để đảm bảo rằng PWA của bạn có thể cài đặt

Trong Chrome

Khi ứng dụng của bạn đáp ứng các yêu cầu tối thiểu về khả năng cài đặt, Chrome sẽ kích hoạt sự kiện beforeinstallprompt mà bạn có thể sử dụng để nhắc người dùng cài đặt PWA của bạn.

Trong các trình duyệt khác

Các trình duyệt khác có các tiêu chí khác nhau để cài đặt và kích hoạt sự kiện beforeinstallprompt. Hãy kiểm tra các trang web tương ứng để biết toàn bộ thông tin chi tiết:

Tài nguyên