Trình xác thực tệp kê khai ứng dụng web

Ứng dụng web lũy tiến chỉ cài đặt sạch khi tệp kê khai.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 xác thực này phân tích cú pháp tệp kê khai đã tải lên của bạn và duyệt qua trường thông số của Bản kê khai ứng dụng web W3C theo từng trường: nó gắn cờ tên và short_name bị thiếu, mảng biểu tượng trống hoặc không đúng định dạng, biểu tượng thiếu src, kích thước hoặc loại, start_url không thể phân tích cú pháp, giá trị hiển thị 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 đều được hiển thị dưới dạng một câu tiếng Anh đơn giản — không phải là trích dẫn thông số kỹ thuật thô — để bạn biết chính xác những gì cần khắc phục và tại sao điều đó lại quan trọng đối 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ó biểu tượng có thể che được. Các 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 tròn, hình giọt nước, v.v. — cho bất kỳ biểu tượng nào được đánh dấu "mục đích": "có thể đeo mặt nạ". Bất cứ thứ gì nằm ngoài vòng tròn ở giữa chiếm 40% khung nhìn của biểu tượng đều có thể bị cắt bớt tùy thuộc vào mặt nạ mà thiết bị áp dụng. Tải lên các tệp hình ảnh biểu tượng được tệp kê khai của bạn tham chiếu cùng với tệp kê khai.json và công cụ này khớp với chúng theo tên tệp, vẽ từng biểu tượng có thể che trên canvas theo kích thước đã khai báo và phủ lên vòng tròn vùng an toàn chính xác đó để bạn có thể tận mắt nhìn thấy liệu tác phẩm nghệ thuật của bạn có sống sót sau mùa vụ hay không.

Huy hiệu đạt/không đạt trong mỗi bản xem trước không phải là một mục danh sách kiểm tra mang tính thẩm mỹ - nó xuất phát từ phân tích thực tế trên mỗi pixel của dữ liệu hình ảnh được giải mã. Công cụ này đo lường lượng nội dung không có nền nằm bên ngoài vòng tròn vùng an toàn (nội dung mà mặt nạ sẽ cắt bớt) và mức độ trong suốt của biểu tượng (các biểu tượng có thể che phải có nền mờ tràn toàn bộ, vì độ trong suốt cho phép màu mặt nạ bên dưới hiển thị xuyên suốt). Cả hai bước kiểm tra đều chạy dựa trên bitmap thực tế mà bạn đã tải lên, do đó kết quả phản ánh tệp biểu tượng thực của bạn chứ 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: tệp kê khai.json được đọc bằng API tệp, các biểu tượng được giải mã bằng createImageBitmap hoặc dự phòng FileReader/Hình ảnh và các pixel được phân tích trên khung vẽ trong bộ nhớ. Không có gì được tải lên máy chủ, điều này quan trọng nếu tệp kê khai 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 được phát triển.