Trình kiểm tra Web App Manifest

Một Progressive Web App chỉ cài đặt mượt mà khi manifest.json của nó đáp ứng các trường mà trình duyệt và cửa hàng ứng dụng thực sự kiểm tra. Trình kiểm tra này phân tích manifest bạn tải lên và duyệt qua từng trường của đặc tả W3C Web App Manifest: nó đánh dấu tên và tên ngắn bị thiếu, mảng icons trống hoặc sai định dạng, biểu tượng thiếu src, sizes hoặc type, start_url không thể phân tích, giá trị display không được nhận dạng, và các chuỗi theme_color hoặc background_color không phải là màu CSS hợp lệ. Mỗi phát hiện được hiển thị dưới dạng một câu tiếng Việt dễ hiểu – không phải trích dẫn đặc tả thô – để bạn biết chính xác cần sửa gì và tại sao nó quan trọng với khả năng cài đặt.

Tính năng nổi bật là bản xem trước vùng an toàn của biểu tượng maskable. Biểu tượng thích ứng của Android áp dụng hình dạng mặt nạ do hệ điều hành chọn – hình tròn, hình vuông bo tròn, giọt nước, và nhiều hơn nữa – cho bất kỳ biểu tượng nào được đánh dấu "purpose": "maskable". Bất kỳ thứ gì nằm ngoài vòng tròn tập trung bao phủ 40% khung nhìn của biểu tượng có thể bị cắt bỏ tùy thuộc vào mặt nạ mà thiết bị áp dụng. Hãy tải lên các tệp hình ảnh biểu tượng được manifest tham chiếu cùng với manifest.json, và công cụ này sẽ ghép chúng theo tên tệp, vẽ từng biểu tượng maskable trên canvas ở kích thước được khai báo, và phủ lên chính xác vòng tròn vùng an toàn đó để bạn có thể tận mắt thấy liệu thiết kế của mình có sống sót sau khi cắt xén hay không.

Huy hiệu đạt/không đạt bên dưới mỗi bản xem trước không phải là một mục đánh dấu hình thức – nó đến từ phân tích điểm ảnh thực tế của dữ liệu hình ảnh đã giải mã. Công cụ đo lường lượng nội dung không phải nền nằm ngoài vòng tròn vùng an toàn (nội dung sẽ bị mặt nạ cắt bỏ) và mức độ trong suốt của biểu tượng (biểu tượng maskable nên có nền đục toàn phần, vì độ trong suốt sẽ để lộ màu mặt nạ bên dưới). Cả hai kiểm tra đều chạy trên bitmap thực tế bạn đã tải lên, vì vậy kết quả phản ánh tệp biểu tượng thực của bạn, không phải phỏng đoán.

Mọi thứ diễn ra cục bộ trong trình duyệt của bạn: manifest.json được đọc bằng File API, biểu tượng được giải mã bằng createImageBitmap hoặc phương án dự phòng FileReader/Image, và điểm ảnh được phân tích trên canvas trong bộ nhớ. Không có gì được tải lên máy chủ, điều này quan trọng nếu manifest của bạn tham chiếu đến tên ứng dụng chưa công khai, đường dẫn start_url nội bộ, hoặc biểu tượng đang phát triển.