قد تغيّر اسم المتجر أو شعار التطبيق في ملفات الموقع، ثم يظل التطبيق المثبت يعرض الاسم أو الأيقونة القديمة. هذا لا يعني دائمًا أن manifest لم يتحدث؛ فالمتصفح ونظام التشغيل يحتفظان ببيانات التطبيق، ويطبقان تحديثات manifest وفق دورة وشروط تختلف بين الحاسوب وAndroid. كما أن تغيير مسار manifest أو هوية التطبيق قد يجعل المتصفح يراه تطبيقًا آخر بدل تحديث التطبيق الحالي.
يمكن تطوير التجربة عبر خدمة تصميم تطبيقات احترافية، ويكمل هذا الموضوع مقال تحديث Service Worker دون إبقاء نسخة قديمة. Service Worker يدير ملفات التطبيق وسلوكها، بينما manifest يصف الاسم والأيقونات والألوان ونطاق التشغيل.
تحديث اسم وشعار PWA يبدأ من manifest ثابت
تشرح web.dev في دليل تحديث web app manifest أن Chrome يفحص manifest دوريًا ويقارن خصائصه بالنسخة المثبتة. وتحذر من تغيير اسم ملف manifest أو موقعه لأن ذلك قد يمنع تحديث التطبيق القائم.
اجعل رابط manifest في الصفحة ثابتًا، وأبقِ id ثابتًا ليمثل هوية التطبيق. غيّر name وshort_name وicons داخل الملف نفسه. إذا غيرت id أو start_url بطريقة تجعل الهوية مختلفة، قد يتعامل المتصفح مع النسخة كتطبيق جديد، فيرى العميل تطبيقين أو لا تتحدث النسخة القديمة.
تحقق من أن الخادم يعيد نوع محتوى صحيحًا للملف، وأن manifest قابل للتحميل بلا تسجيل دخول أو تحويلات غريبة. افتح الرابط مباشرة وافحص النسخة التي وصلت، لا النسخة الموجودة في مشروعك فقط.
جهز الأيقونات بمقاسات ومسارات واضحة
توضح MDN في مرجع icons داخل manifest أن كل عنصر يحتاج src، ويمكن تحديد sizes وtype وpurpose. وفر على الأقل الأيقونات التي يحتاجها التطبيق بمقاسات فعلية، واستخدم PNG واضحًا، وأضف نسخة maskable إذا كان التصميم مناسبًا.
لا تستبدل ملف الصورة بمحتوى جديد فقط مع إبقاء ذاكرة CDN طويلة من دون تغيير نسخة المسار. استخدم اسم ملف جديدًا مثل icon-192-v2.png وicon-512-v2.png، ثم حدّث manifest. هذا يساعد المتصفح وCDN على طلب الملف الجديد بدل الاعتماد على نسخة مخزنة.
نفذ الخطوات التالية:
- حدّث name وshort_name وicons مع إبقاء manifest وid ثابتين.
- ارفع ملفات الأيقونات الجديدة بمسارات جديدة، وتحقق من أبعادها ونوعها واستجابتها دون خطأ.
- افتح التطبيق، انتظر دورة الفحص، أغلق كل نوافذه ثم اختبر التحديث على جهاز مثبت فعليًا.
لا تضف sizes لا يطابق الملف. إذا كان الملف 512×512 واستخدمت 192×192 في الحقل، قد يختار المتصفح أيقونة غير مناسبة أو يتجاهلها.
لماذا يختلف Chrome على الحاسوب عن Android؟
وفق web.dev، يفحص Chrome على الحاسوب manifest دوريًا عند فتح التطبيق أو الموقع، ثم يطبق الخصائص بعد إغلاق النوافذ. لكن تحديث الأيقونات المثبتة على سطح المكتب له قيود وقد لا ينعكس بالطريقة نفسها التي تنعكس بها خصائص مثل الاسم واللون.
على Android، قد يُنشئ Chrome WebAPK ويحدثه بشروط تشمل فتح التطبيق ثم إغلاقه واتصال الجهاز. قد تستغرق العملية وقتًا، وإذا فشل جلب manifest قد يطيل Chrome فترة الفحص. لذلك لا تعرض رسالة “تم تحديث التطبيق” بمجرد نشر الملف على الخادم.
مثال افتراضي: متجر يغير اسمه من “متجر ألف” إلى “متجر باء” ويستبدل icon-192.png في المسار نفسه. الموقع يعرض الشعار الجديد، لكن التطبيق المثبت يحتفظ بالقديم. يعدّل الفريق name وshort_name، يرفع icon-192-v2.png وicon-512-v2.png، يحدث مسارات icons مع id ثابت، ثم يختبر بعد إغلاق التطبيق وانتظار دورة التحديث. يظهر الاسم الجديد، بينما يحتاج بعض أجهزة الحاسوب إلى إعادة تثبيت الأيقونة بسبب قيود المنصة.
اختبر دون إجبار العميل على إعادة التثبيت أولًا
استخدم أدوات المطور لفحص manifest الحالي، ومسارات الصور، وid وstart_url وscope. قارن ما يصل عبر الشبكة بما تتوقعه. امسح كاش المتصفح في جهاز اختبار فقط لتشخيص الخادم، لكن لا تجعل مسح الكاش تعليماتك الأولى لكل العملاء؛ المطلوب أن يعمل مسار التحديث الطبيعي.
اختبر تثبيتًا جديدًا أيضًا. إذا ظهر الشعار القديم في تثبيت جديد، فالمشكلة في manifest أو CDN أو ملف الصورة. إذا ظهر الجديد في تثبيت جديد فقط، فالمشكلة مرتبطة بدورة تحديث التطبيق المثبت أو دعم المنصة.
راجع CSP إذا كانت الأيقونات على نطاق مختلف، لأن سياسة img-src قد تمنع تحميلها. وتأكد من عدم وجود manifest ثانٍ في القالب أو نسخة مختلفة بين www والنطاق الأساسي.
قائمة مراجعة قبل إعلان اكتمال التحديث
- رابط manifest ثابت ولم يُنقل.
- id ثابت ويطابق هوية التطبيق الحالية.
- name وshort_name مكتوبان كما يجب أن يظهرا.
- ملفات الأيقونات الجديدة لها مسارات جديدة.
- sizes وtype وpurpose تطابق الملفات.
- start_url وscope لم يتحولا إلى تطبيق مختلف.
- manifest والأيقونات متاحان بلا تسجيل دخول.
- CDN يعيد النسخة الجديدة.
- جرى اختبار تثبيت جديد وتطبيق مثبت.
- أُغلقت نوافذ التطبيق وأُعطي المتصفح وقت الفحص.
- لم تُعرض رسالة نجاح قبل التحقق على الجهاز.
تحديث الهوية في PWA ليس تنزيل ملف تنفيذي جديدًا بالضرورة، بل تحديث بيانات يطبقها المتصفح وفق دورة محددة. إبقاء هوية التطبيق ثابتة، وتغيير مسارات الأيقونات، واختبار جهاز مثبت يمنع الرسائل المضللة ويعطي العميل توقعًا واقعيًا عن وقت ظهور التغيير.
المراجع والمصادر
محتوى إرشادي أُعد بمساعدة الذكاء الاصطناعي. الأمثلة افتراضية للتوضيح، وليست نتائج لعملاء تمايز.
تمايز للتسويق وتطوير المتاجر الإلكترونيةتقنية وتسويق
نسمعك