زر «تثبيت التطبيق» لا يستطيع إجبار كل جهاز على تنزيل التطبيق بالطريقة نفسها. في متصفحات Chromium قد يوفّر الحدث beforeinstallprompt نافذة تثبيت، بينما يحتاج مستخدم iPhone أو iPad غالبًا إلى إضافة الموقع إلى الشاشة الرئيسية من قائمة المشاركة. لذلك يجب أن يظهر الزر عندما توجد خطوة قابلة للتنفيذ، ويختفي بعد التثبيت أو عند عدم دعم المسار، مع تقديم إرشاد مناسب بدل زر لا يستجيب.
توضح دروس web.dev عن تثبيت PWA أن متطلبات التثبيت تختلف حسب المتصفح والنظام، وأن iOS لا يملك مطالبة متصفح مماثلة ويعتمد على الإضافة اليدوية إلى الشاشة الرئيسية. وتشرح وثائق MDN لجعل PWA قابلة للتثبيت متطلبات البيان وHTTPS، وكيف يمكن للواجهة الاستماع إلى beforeinstallprompt وإظهار زر خاص ثم إخفائه بعد appinstalled.
جهّز أساس التثبيت قبل تصميم الزر
تأكد أن الموقع يعمل عبر HTTPS وأن ملف Web App Manifest يحتوي اسمًا مختصرًا وأيقونات مناسبة وstart_url ووضع عرض مثل standalone. اختبر أن المسارات والأيقونات متاحة ولا تعيد 404، وأن scope يشمل الصفحات التي يجب أن يفتحها التطبيق.
الزر ليس دليلًا على صلاحية التطبيق. إذا لم يمر الموقع بشروط المتصفح، فلن يصل حدث التثبيت. كذلك قد يكون التطبيق مثبتًا بالفعل، أو قد يزور العميل المتجر من متصفح لا يدعم المطالبة البرمجية. ابدأ بحالة مخفية، ولا تعرض الزر افتراضيًا ثم تتركه معطلًا.
خطوات بناء زر تثبيت تطبيق المتجر
- استمع إلى
beforeinstallprompt، امنع السلوك الافتراضي عند الحاجة، واحتفظ بمرجع الحدث ثم أظهر الزر للمستخدم. - عند نقر المستخدم، استدعِ
prompt()من تفاعل مباشر، وانتظر النتيجة ثم امسح المرجع لأن الحدث لا يُستخدم أكثر من مرة. - استمع إلى
appinstalledوأخفِ الزر، وافحص وضع العرض المستقل عند فتح التطبيق حتى لا تطلب التثبيت داخل نسخة مثبتة.
على iOS، اعرض تعليمات قصيرة تعتمد على الجهاز: افتح المشاركة ثم اختر «إضافة إلى الشاشة الرئيسية». لا تقل «تم التحميل» قبل أن يؤكد النظام التثبيت، ولا تعرض APK إذا كان المنتج PWA. على جهاز لا يدعم التثبيت، اترك الموقع يعمل كاملًا كتجربة ويب عادية.
اختبر الحالات التي لا تظهر في المتصفح نفسه
اختبر Android Chrome، سطح مكتب Chrome أو Edge، وiPhone أو iPad. جرّب مستخدمًا جديدًا، وآخر رفض المطالبة، وتطبيقًا مثبتًا. راقب أن الزر لا يعود فورًا بعد الرفض بصورة مزعجة، وأنه يختفي عند تشغيل التطبيق بوضع مستقل.
تحقق من start_url بعد التثبيت ومن تسجيل الدخول والسلة والعودة داخل نافذة التطبيق. قد ينجح التثبيت بينما تكون تجربة التنقل غير مناسبة بسبب غياب زر الرجوع أو فقدان حالة الصفحة. يساعد المقال المكمل اختبار زر الرجوع في المتجر: حفظ الفلاتر وتحديث السلة بعد العودة في مراجعة هذه الحالة.
مثال افتراضي
متجر افتراضي عرض زرًا ثابتًا لكل الزوار. على iPhone لم يحدث شيء، وعلى Android ظل الزر ظاهرًا بعد تثبيت التطبيق. عدّل الفريق المنطق ليكون الزر مخفيًا حتى يصل beforeinstallprompt، ثم أخفاه بعد appinstalled. ولمستخدمي iOS عرض بطاقة إرشاد منفصلة بدل تشغيل دالة غير مدعومة. هذا مثال افتراضي للتوضيح ولا يثبت توافق كل جهاز أو متجر تطبيقات.
قائمة مراجعة قبل إطلاق زر التثبيت
- [ ] الموقع يعمل عبر HTTPS والبيان صالح ويمكن الوصول إليه.
- [ ] الأيقونات تشمل مقاسات مناسبة وتظهر بالشكل الصحيح.
- [ ] الزر مخفي افتراضيًا ولا يظهر إلا لمسار قابل للتنفيذ.
- [ ] النقر يأتي من تفاعل المستخدم ويستدعي المطالبة مرة واحدة.
- [ ] الزر يختفي بعد
appinstalledوداخل وضع العرض المستقل. - [ ] مستخدمو iOS يحصلون على إرشاد يدوي واضح.
- [ ] رفض التثبيت لا ينتج مطالبة متكررة في كل صفحة.
- [ ] السلة والحساب والتنقل اختُبرت داخل النسخة المثبتة.
عند الحاجة إلى تجهيز التطبيق للنشر أو مراجعة تجربة التثبيت، يمكن الرجوع إلى خدمة رفع تطبيقاتك في متاجر التطبيقات. التثبيت يعتمد على المتصفح والنظام واختيار المستخدم؛ الواجهة الجيدة تشرح المسار الصحيح ولا تدعي إتمامه قبل تأكيد الجهاز.
المراجع والمصادر
محتوى إرشادي أُعد بمساعدة الذكاء الاصطناعي. الأمثلة افتراضية للتوضيح، وليست نتائج لعملاء تمايز.
تمايز للتسويق وتطوير المتاجر الإلكترونيةتقنية وتسويق
نسمعك