قد يخفي الموقع زر التثبيت لأنه رأى إشارة واحدة تدل على التشغيل المستقل، ثم يكتشف المستخدم أن التطبيق غير موجود في قائمة جهازه. السبب أن وضع تشغيل PWA لا يساوي دائمًا حالة التثبيت: يمكن فتح تطبيق مثبت داخل تبويب، ويمكن فتح صفحة عادية في وضع ملء الشاشة. المطلوب هو دمج إشارات المتصفح مع واجهة واضحة لا تدعي نجاحًا لم يحدث.
توضح وثائق MDN عن التطبيق المستقل دور قيمة display في manifest وكيفية استخدام media query لاكتشاف الوضع، وتنبه إلى عدم وجود طريقة موثوقة واحدة عبر كل المتصفحات لمعرفة أن التطبيق مثبت. وتعرض دروس web.dev عن الاكتشاف استخدام matchMedia وأحداث التثبيت وطرق تمييز أوضاع التشغيل.
يمكن ربط هذه المراجعة ضمن خدمة تصميم تطبيق متجر إلكتروني. ويكملها دليل عرض زر التثبيت فقط على الأجهزة الداعمة.
افصل بين القابلية للتثبيت ووضع التشغيل
القابلية للتثبيت تعني أن المتصفح يرى شروطًا تسمح بعرض مطالبة، وقد يرسل beforeinstallprompt في متصفحات Chromium. وضع التشغيل يخبرك كيف فُتحت الصفحة الآن: داخل المتصفح أو نافذة مستقلة أو ملء الشاشة. أما «مثبت» فهي حالة قد لا يستطيع الموقع معرفتها بصورة موحدة.
ابدأ بزر مخفي، ثم أظهره عند وجود إجراء حقيقي: حدث تثبيت قابل للاستدعاء، أو تعليمات يدوية مناسبة للنظام. لا تعرض رسالة «مثبت» لمجرد أن المستخدم أغلق النافذة أو لأن localStorage يحمل قيمة قديمة.
ثلاث خطوات لاكتشاف وضع تشغيل PWA
- اقرأ وضع العرض: استخدم
matchMedia('(display-mode: standalone)')، وأضف الأوضاع المستخدمة في manifest مثلminimal-uiأوfullscreen. على iOS قد تحتاج إشارة المنصة الخاصة إلى جانب الاختبار. - راقب دورة التثبيت: خزّن حدث
beforeinstallpromptمؤقتًا، واعرض الزر، ثم استدعِprompt()من نقرة المستخدم. سجّل نتيجة المطالبة ولا تعد استخدام الحدث نفسه. - حدّث الواجهة بعد النجاح الحقيقي: استمع إلى
appinstalledوأخفِ الزر في الجلسة، وعند فتح التطبيق المستقل استخدم وضع العرض لتقديم واجهة مناسبة. اترك رابط تعليمات للمتصفحات التي لا توفر المطالبة.
لا تجعل التخزين المحلي مصدر الحقيقة الوحيد. قد يحذف المستخدم التطبيق من الجهاز ويبقى المفتاح في المتصفح، أو يثبت التطبيق من متصفح آخر. استخدم التخزين لتحسين الواجهة مؤقتًا، مع زر «إظهار تعليمات التثبيت» يمكن الوصول إليه لاحقًا.
مثال افتراضي
مثال افتراضي: ضغط عميل زر «تثبيت» على حاسب Windows ثم أغلق مطالبة المتصفح. سجّل الموقع قيمة installed=true عند النقرة لا عند حدث النجاح، فاختفى الزر وظهرت رسالة «تم التثبيت» رغم عدم وجود التطبيق.
يغير الفريق المنطق: لا يسجل النجاح عند النقرة، بل ينتظر نتيجة المطالبة وحدث appinstalled. وعند تحميل الصفحة يفحص وضع العرض الحالي. إذا لم يتوفر beforeinstallprompt يعرض تعليمات المتصفح بدل زر مباشر وهمي. كما يضيف رابطًا ثابتًا صغيرًا للتعليمات في قائمة الموقع.
اختبر المتصفحات والأجهزة فعليًا
اختبر Chrome وEdge على الحاسب، وChrome على Android، وSafari على iPhone وiPad إن كان الجمهور يستخدمها. في كل حالة سجّل: هل وصل حدث المطالبة، هل ظهر خيار يدوي، أين وُضع الاختصار، وما شكل فتح التطبيق بعد التثبيت.
لا تفترض أن Firefox أو متصفحًا مدمجًا داخل تطبيق اجتماعي يدعم المسار نفسه. قد يحتاج المستخدم فتح الرابط في متصفح النظام. اكتب تعليمات قصيرة حسب الجهاز، ولا تستخدم عبارة «تحميل ملف» إذا كان المنتج PWA لا يحمّل APK أو EXE.
قائمة مراجعة لواجهة التثبيت
- [ ] manifest صالح ويحتوي اسمًا وأيقونات وstart_url وdisplay.
- [ ] الموقع يعمل عبر HTTPS.
- [ ] الزر مخفي حتى يتوفر إجراء حقيقي.
- [ ] النجاح لا يُسجل عند مجرد النقر.
- [ ]
appinstalledيحدّث الواجهة. - [ ] وضع العرض يُفحص عند كل تشغيل.
- [ ] التخزين المحلي ليس دليل التثبيت الوحيد.
- [ ] توجد تعليمات للأنظمة بلا مطالبة.
- [ ] الزر قابل للوصول بلوحة المفاتيح وقارئ الشاشة.
- [ ] تمت تجربة الإزالة وإعادة التثبيت.
الواجهة الصادقة تخبر المستخدم بما يستطيع فعله الآن، وتفرق بين فتح الموقع كتطبيق وبين امتلاك ملف مستقل. هذا يقلل الرسائل المضللة ومشكلات الدعم.
المراجع والمصادر
محتوى إرشادي أُعد بمساعدة الذكاء الاصطناعي. الأمثلة افتراضية للتوضيح، وليست نتائج لعملاء تمايز.
تمايز للتسويق وتطوير المتاجر الإلكترونيةتقنية وتسويق
نسمعك