زر «تثبيت التطبيق» لا ينشئ ملفًا يُحمّل على كل جهاز بالطريقة نفسها؛ في تطبيق الويب التقدمي يقرر المتصفح طريقة التثبيت حسب الأمان والـmanifest وقدرات النظام. إعداد Web App Manifest للمتجر يجعل الاسم والأيقونة ومسار البداية وطريقة العرض واضحة، ثم يأتي اختبار المتصفحات للتأكد من أن الزر لا يقول «مثبت» بلا أثر. إذا احتاج المشروع تطبيقًا أصليًا منفصلًا، فذلك مسار مختلف عن تصميم تطبيقات احترافية.
الحقول التي تثبت هوية التطبيق
يشرح دليل Web App Manifest أن الملف يصف كيفية ظهور تجربة الويب كتطبيق، ويشمل الاسم والأيقونات واللون ولقطات الشاشة. استخدم name كاملًا وshort_name مناسبًا للشاشة، وثبّت id لا يتغير مع روابط الحملات، واجعل start_url مسارًا آمنًا داخل نطاق التطبيق. اختر display: standalone عندما تريد نافذة تشبه التطبيق، مع لون خلفية وثيم يطابقان شاشة البداية.
قدم أيقونات مربعة غير شفافة على الأقل بالمقاسات التي تحتاجها الأنظمة، ومنها 192 و512 بكسل، وأضف نسخة maskable إذا كان التصميم يسمح. لا تستخدم شعارًا صغيرًا وسط مساحة شفافة كبيرة؛ قد تقصه بعض الأنظمة أو تضع خلفية غير متوقعة. اجعل كل رابط أيقونة يعيد 200 ونوع MIME صحيحًا، وليس صفحة HTML أو تحويل تسجيل دخول.
بناء manifest واختباره
- أنشئ ملف
.webmanifestصالحًا واربطه في رأس جميع الصفحات القابلة للتثبيت بعلاقة manifest واضحة. - تحقق من
idوstart_urlوscopeحتى لا يفتح التطبيق خارج نطاقه أو يُعتبر تطبيقًا جديدًا بعد تحديث الرابط. - أضف الأيقونات ولقطات شاشة حقيقية تمثل الواجهة، وحدد المقاسات والأنواع بدقة.
- افتح DevTools > Application > Manifest، أصلح أخطاء الجلب والحقول، ثم اختبر تثبيتًا نظيفًا على أجهزة فعلية.
توضح معايير قابلية تثبيت PWA أن التجربة تحتاج HTTPS وmanifest يتضمن حقولًا أساسية مثل الاسم والأيقونات ومسار البداية وطريقة العرض، مع اختلافات بين المتصفحات. لا تعتمد على حدث beforeinstallprompt كضمان عالمي؛ قد لا يطلق في iOS أو بعد رفض المستخدم، وبعض المتصفحات تعرض التثبيت من القائمة فقط.
منطق زر التثبيت الصحيح
أخف الزر عندما لا يتوفر حدث التثبيت المباشر، أو اعرض تعليمات مناسبة للمتصفح بدل ادعاء بدء تحميل. بعد قبول الحوار، راقب النتيجة ثم أعد فحص display-mode أو حدث appinstalled. لا تحفظ علامة «مثبت» في localStorage وحدها؛ قد يحذف المستخدم التطبيق أو يفتح الموقع من جهاز آخر. استخدم حالة المتصفح الحالية كلما أمكن.
اختبر Windows وAndroid وiOS وmacOS حسب جمهورك. تحقق من ظهور الأيقونة في قائمة ابدأ أو الشاشة الرئيسية، ومن فتح التطبيق إلى المسار الصحيح، ومن عمل الرجوع والمشاركة والروابط الخارجية. وللتوسع في اختلاف الدعم اقرأ زر تثبيت PWA عبر الأجهزة والمتصفحات.
مثال افتراضي
مثال افتراضي: متجر يحفظ installed=true فور ضغط الزر، حتى لو أغلق العميل نافذة المتصفح. في الزيارة التالية يختفي الزر وتظهر رسالة «مثبت»، لكن لا يوجد تطبيق. يُعدّل المنطق ليحفظ النتيجة بعد حدث نجاح التثبيت، ويفحص وضع العرض عند كل فتح. على iPhone، حيث لا يوجد الحوار نفسه، يعرض خطوات «إضافة إلى الشاشة الرئيسية» بدل زر تحميل وهمي. ويثبت id حتى لا تُنشئ حملة UTM نسخة أخرى من التطبيق.
قائمة مراجعة التثبيت
- الموقع يعمل عبر HTTPS والـmanifest متاح بنوع محتوى صحيح.
nameوshort_nameوidوstart_urlوdisplayمحددة.- أيقونات 192 و512 ونسخة maskable تظهر دون قص غير مقصود.
- روابط الأيقونات ولقطات الشاشة تعيد ملفات فعلية.
- الزر يعتمد على إمكانية المتصفح ولا يعلن نجاحًا قبل النتيجة.
- تم اختبار الإزالة وإعادة التثبيت وفتح التطبيق من النظام.
- توجد تعليمات بديلة واضحة للمتصفحات التي لا تدعم الحوار.
عند تحديث manifest لا تغيّر id بلا سبب، واختبر أثر تغيير الأيقونة والاسم على تثبيت قائم. سجّل المتصفح والنظام في بلاغات العملاء، لأن عبارة «لم يتحمل» لا تكفي لتشخيص هل المشكلة في الدعم أم الملف أم حالة تثبيت قديمة.
المراجع والمصادر
محتوى إرشادي أُعد بمساعدة الذكاء الاصطناعي. الأمثلة افتراضية للتوضيح، وليست نتائج لعملاء تمايز.
تمايز للتسويق وتطوير المتاجر الإلكترونيةتقنية وتسويق
نسمعك