طريقة الاستخدام
- اكتب الاسم والاسم القصير، ثم عنوان البداية والنطاق للتطبيق.
- اختر وضع العرض، واكتب لون الخلفية ولون السمة بصيغة hex.
- اكتب أيقونة في كل سطر تحت الأيقونات: العنوان، ثم الأبعاد والنوع والأغراض، مفصولة بخط عمودي |.
- احفظ النص تحت manifest.webmanifest، وأصلح كل ملاحظة مدرجة تحت فحوص قابلية التثبيت.
معنى الأعضاء
البيان ملف JSON. تُوصف أعضاؤه في مواصفة W3C لبيان تطبيق الويب (القسم 1). تُكتب الأعضاء التي تملؤها فقط، فالحقل الفارغ يترك عضوه خارج الملف. ويحدد وضع العرض كيف يُظهر المتصفح التطبيق؛ وإذا لم يدعم المتصفح وضعًا، يستخدم التالي له في هذه السلسلة (القسم 6): ملء الشاشة، ثم مستقل، ثم واجهة مبسطة، ثم لسان المتصفح.
عنوان البداية الواقع على أصل مختلف عن أصل الصفحة يُتجاهل، لأن المواصفة تشترط الأصل نفسه. ولا يُستخدم النطاق إلا إذا احتوى عنوان البداية؛ وإلا تستخدم المتصفحات النطاق الذي هو عنوان البداية دون اسم الملف والاستعلام والجزء الذي يبدأ بـ #.
ما تفحصه الملاحظات
تسرد MDN الأعضاء التي تحتاجها المتصفحات المبنية على Chromium قبل أن تعرض تثبيت تطبيق ويب: اسمًا أو اسمًا قصيرًا، وأيقونتين بحجم 192 و512 بكسل، وعنوان بداية، ووضع عرض. وتذكر أيضًا أن الموقع يجب أن يُقدَّم عبر https أو من localhost، وأن عامل الخدمة (service worker) ليس مطلوبًا. ولا يثبّت Firefox تطبيق ويب من ملف بيان على سطح المكتب.
تفحص الأداة الأعضاء السابقة وقاعدة النطاق. ولا تختبر ملفات الأيقونات ولا عنوان https ولا الرابط في صفحاتك؛ فهذه عليك أنت التأكد منها.
القيم الافتراضية
مع القيم التي تفتح بها الصفحة، يحتوي البيان على الأعضاء أدناه. ولا تظهر أي ملاحظة، لأن الاسم وعنوان البداية وكلا حجمي الأيقونة موجودة.
| العضو | القيمة |
|---|---|
| name, short_name | ملاحظات، ملاحظات |
| start_url, scope | /، / |
| display | standalone |
| background_color, theme_color | #ffffff، #1f6feb |
| icons | ملفا PNG بأبعاد 192x192 و512x512؛ وللأيقونة 512 الغرض any maskable |
الأسئلة الشائعة
أين أحفظ ملف البيان؟
احفظه في جذر الموقع، أو في مجلد التطبيق، وسمِّه manifest.webmanifest. ثم اربطه من كل صفحة في التطبيق بعنصر link تكون قيمة rel فيه manifest، كما تصف MDN.
هل أحتاج إلى عامل خدمة لتثبيت التطبيق؟
لا. تقول MDN إن عامل الخدمة ليس شرطًا لقابلية تثبيت PWA، مع أن تطبيقات كثيرة تستخدمه ليعمل دون اتصال. ويجب مع ذلك أن يُقدَّم الموقع عبر https، أو من localhost.
ما أبعاد الأيقونات التي أحتاجها؟
تسرد MDN أيقونة بحجم 192 بكسل وأخرى بحجم 512 بكسل للمتصفحات المبنية على Chromium. اكتب الأبعاد بصيغة WIDTHxHEIGHT، وافصل بينها بمسافات إذا كان لملف واحد أكثر من بُعد. ويمكن أن يكون بُعد ملف SVG هو any.
ما الفرق بين الاسم والاسم القصير؟
الاسم هو الاسم الكامل للتطبيق. أما الاسم القصير فللأماكن التي تضيق فيها المساحة، مثل النص تحت الأيقونة على الشاشة الرئيسية. اكتب واحدًا منهما على الأقل؛ وتحذّر الأداة إذا كانا فارغين معًا.
لماذا تحذّر الأداة بشأن النطاق؟
لا يُستخدم النطاق إلا إذا احتوى عنوان البداية (القسم 1 من W3C). فإذا كان عنوان البداية خارج النطاق، تتجاهل المتصفحات النطاق وتستخدم نطاقها الافتراضي، فقد يُفتح التطبيق خارج المنطقة التي قصدتها.
المصادر
- W3C (باللغة الإنجليزية): Web Application Manifest (Working Draft, 6 November 2026): sections 1, 2 and 6
- MDN (باللغة الإنجليزية): Making PWAs installable
- MDN (باللغة الإنجليزية): display member of the web app manifest
- MDN (باللغة الإنجليزية): icons member of the web app manifest
آخر مراجعة للأرقام والنص: الثلاثاء، 30 جمادى الأولى 1448 بعد الهجرة.