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 những thông tin quan trọng 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 yêu cầu tối thiểu về khả năng cài đặt:

Kiểm tra bằng Lighthouse cho thấy người dùng không thể cài đặt ứng dụng web trên 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ì tệp kê khai của trang sẽ không vượt qua được quá trình kiểm tra:

  • Thuộc tính short_name hoặc name
  • Thuộc tính icons bao gồm biểu tượng 192x192 px và biểu tượng 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í nêu trên. Hãy xem bài viết Giúp ứng dụng dễ cài đặt để biết thêm thông tin về cách tạo một ứng dụng web tiến bộ (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ể dùng để nhắc người dùng cài đặt PWA.

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

Các trình duyệt khác có tiêu chí khác để 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:

Tài nguyên