Pengesah Manifest Aplikasi Web

Aplikasi Web Progresif hanya dipasang dengan lancar apabila manifest.jsonnya memenuhi medan yang sebenarnya diperiksa oleh pelayar dan gedung aplikasi. Pengesah ini menghurai manifes yang dimuat naik dan meneliti spesifikasi Manifest Aplikasi Web W3C satu persatu: ia menanda name dan short_name yang tiada, tatasusun ikon yang kosong atau rosak, ikon yang tiada src, sizes, atau type, start_url yang tidak boleh dihurai, nilai paparan yang tidak dikenali, dan rentetan theme_color atau background_color yang bukan warna CSS yang sah. Setiap penemuan ditunjukkan sebagai ayat bahasa biasa — bukan petikan spesifikasi mentah — supaya anda tahu dengan tepat apa yang perlu dibaiki dan mengapa ia penting untuk kebolehpasangan.

Ciri utama adalah pratonton zon selamat ikon boleh topeng. Ikon suai Android mengenakan bentuk topeng yang dipilih oleh OS — bulatan, squircle, titisan air dan banyak lagi — pada setiap ikon yang ditandakan "purpose": "maskable". Apa-apa di luar bulatan berpusat yang meliputi 40% daripada viewport ikon boleh dipotong bergantung pada topeng yang digunakan oleh peranti. Muat naik fail imej ikon yang dirujuk oleh manifes bersama manifest.json, dan alat ini memadankannya mengikut nama fail, melukis setiap ikon boleh topeng pada kanvas mengikut saiz yang diisytiharkan, dan menindih bulatan zon selamat yang tepat supaya anda dapat lihat dengan mata sendiri sama ada karya seni anda terselamat daripada pemotongan.

Lencana lulus/gagal di bawah setiap pratonton bukanlah item senarai semak kosmetik — ia datang daripada analisis per piksel sebenar data imej yang dinyahkod. Alat ini mengukur berapa banyak kandungan bukan latar belakang berada di luar bulatan zon selamat (kandungan yang akan dipotong oleh topeng) dan berapa banyak ikon yang telus (ikon boleh topeng sepatutnya mempunyai latar belakang legap penuh, kerana ketelusan membenarkan warna topeng asas kelihatan). Kedua-dua semakan dijalankan terhadap bitmap sebenar yang dimuat naik, jadi hasilnya mencerminkan fail ikon sebenar anda, bukan tekaan.

Segala-galanya berlaku secara setempat dalam pelayar anda: manifest.json dibaca dengan API Fail, ikon dinyahkod dengan createImageBitmap atau sandaran FileReader/Imej, dan piksel dianalisis pada kanvas dalam ingatan. Tiada apa-apa dimuat naik ke pelayan, yang penting jika manifes anda merujuk nama aplikasi yang belum awam, laluan start_url dalaman, atau ikon yang sedang dibangunkan.