مدقّق أيقونات ملف PWA manifest

الصق محتوى JSON الخاص بـ manifest.json للتحقق من وجود أحجام الأيقونات الموصى بها (192x192 و512x512) وpurpose من نوع «maskable» والصيغ الصحيحة، قبل نشر تطبيق الويب التقدمي الخاص بك.

مثال:

كيف يعمل

قد يكون ملف PWA manifest صالحًا من الناحية التقنية بصيغة JSON ومع ذلك تنقصه الأيقونات التي تتوقعها المتصفحات لعرض خيار التثبيت، أو يصرّح بأيقونات سيُعاد قصها على نحو خاطئ في Android لعدم وجود منطقة «maskable». تحلل هذه الأداة المصفوفة icons في ملف manifest الخاص بك وتسرد المشكلات الشائعة: الأحجام المفقودة، وغياب purpose من نوع maskable، والصيغ غير المعتادة، أو الحقول المطلوبة غير الموجودة.

لماذا يُوصى بالحجمين 192x192 و512x512؟

هما الحجمان الأكثر توقعًا على نطاق واسع من المتصفحات وأنظمة التشغيل لعرض الأيقونة على الشاشة الرئيسية (192x192) وفي السياقات التي تتطلب دقة أعلى مثل شاشة البدء (512x512). وبدونهما ترفض بعض المتصفحات ببساطة اقتراح تثبيت التطبيق.

ما هي الأيقونة «maskable»؟

الأيقونة التي تحمل "purpose": "maskable" مصممة بمنطقة أمان مركزية كافية بحيث يمكن قصها بأشكال مختلفة (دائرة، مربع بحواف مستديرة، قطرة...) بحسب نظام Android لدى المستخدم، دون قطع العناصر المهمة من الشعار. وبدون أيقونة maskable مخصصة، قد يطبّق Android قصًا تلقائيًا يشوّه الصورة أو يبتر جزءًا منها.

الخصوصية: يُحلَّل المحتوى الملصق بالكامل في متصفحك، ولا تُرسَل أي بيانات إلى خادم.