كيفية تعامل Chrome مع تحديثات بيان تطبيق الويب

متطلبات تغيير الرموز المختصرة والألوان والبيانات الوصفية الأخرى لتطبيقك المتوافق مع الأجهزة الجوّالة

Adriana Jara
François Beaufort
François Beaufort
GitHub
Pete LePage

عند تثبيت تطبيق متوافق مع تقنية الويب، يستخدم المتصفّح معلومات من بيان تطبيق الويب لتحديد اسم التطبيق والرموز التي يجب أن يستخدمها التطبيق وعنوان URL الذي يجب فتحه عند تشغيل التطبيق. ولكن ماذا لو كنت بحاجة إلى تحديث اختصارات التطبيق أو تجربة لون مظهر جديد؟ متى وكيف يتم عرض هذه التغييرات في المتصفّح؟

في معظم الحالات، من المفترض أن تظهر التغييرات في غضون يوم أو يومَين من إطلاق تطبيق الويب التقدّمي (PWA)، بعد تعديل البيان.

التحديثات على متصفّح Chrome للكمبيوتر المكتبي

عند تشغيل تطبيق الويب المتوافق مع الأجهزة الجوّالة أو فتحه في علامة تبويب متصفّح، يحدِّد Chrome آخر مرة تم فيها التحقّق من البيان المحلي بحثًا عن تغييرات. إذا لم يتم التحقق من البيان منذ آخر مرة تم فيها تشغيل المتصفّح، أو إذا لم يتم التحقق منه في آخر 24 ساعة، سيُرسِل Chrome طلبًا على الشبكة للحصول على البيان، ثم تتم مقارنة البيان بالنسخة المحلية.

إذا تم تغيير خصائص محددة في البيان (انظر القائمة أدناه)، يدرج Chrome في قائمة انتظار البيان الجديد، وبعد إغلاق جميع النوافذ، يثبّته. بعد التثبيت، يتم تعديل جميع الحقول من البيان الجديد باستثناء icons.

ما هي المواقع التي ستؤدي إلى إجراء تعديل؟

  • name
  • short_name
  • display (راجِع المعلومات أدناه)
  • scope
  • shortcuts
  • start_url
  • theme_color
  • file_handlers

ماذا يحدث عند تعديل الحقل display؟

إذا حدّثت وضع عرض تطبيقك من browser إلى standalone، لن تفتح تطبيقات المستخدمين الحاليين في نافذة بعد التحديث. هناك إعدادان للعرض لتطبيق الويب، أحدهما من البيان (الذي تتحكم فيه) وإعداد علامة تبويب نافذة/متصفّح يتحكّم فيه المستخدم. يتم دائمًا احترام تفضيل المستخدم.

تعديلات بيان الاختبار

تتضمّن صفحة chrome://web-app-internals (المتوفّرة في Chrome 85 أو الإصدارات الأحدث) معلومات مفصّلة حول جميع تطبيقات الويب التقدّمية (PWA) المثبَّتة على الجهاز، ويمكن أن تساعدك في معرفة تاريخ آخر تعديل على البيان وعدد مرّات تعديله وغير ذلك.

لإجبار Chrome يدويًا على البحث عن ملف بيان مُعدَّل، يمكنك إما تشغيل Chrome باستخدام علامة سطر الأوامر --disable-manifest-update-throttle أو إعادة تشغيل Chrome (باستخدام about://restart)، وسيؤدي ذلك إلى إعادة ضبط الموقِّت حتى يتحقق Chrome من وجود بيان معدَّل عند إطلاق تطبيق الويب التقدّمي (PWA) في المرة التالية. بعد ذلك، شغّل تطبيق الويب التقدّمي (PWA). بعد إغلاق تطبيق الويب التقدّمي (PWA)، يجب تحديثه بخصائص البيان الجديدة.

المراجع

تحديثات على Chrome لنظام Android

عند تشغيل تطبيق الويب التقدّمي، يحدِّد Chrome آخر مرة تم فيها التحقّق من البيان المحلي بحثًا عن تغييرات. إذا لم يتم التحقق من البيان خلال آخر 24 ساعة، سيحدّد Chrome موعدًا لطلب الشبكة للبيان، ثم يقارنه بالنسخة المحلية.

في حال تغيير خصائص محددة في البيان (انظر القائمة أدناه)، سيضيف Chrome إلى قائمة انتظار البيان الجديد، وبعد إغلاق جميع نوافذ تطبيق الويب التقدّمي (PWA)، يتم توصيل الجهاز واتصاله بشبكة WiFi، يطلب Chrome من الخادم تحديث WebAPK. وبعد التحديث، يتم استخدام جميع الحقول من البيان الجديد.

ما هي المواقع التي ستؤدي إلى إجراء تعديل؟

  • name
  • short_name
  • icons
  • background_color
  • display
  • orientation
  • scope
  • shortcuts
  • start_url
  • theme_color
  • web_share_target

إذا تعذّر على Chrome الحصول على بيان مُحدَّث من الخادم، قد يزيد المدة بين عمليات البحث إلى 30 يومًا.

اختبار تعديلات بيان التطبيق

تتضمن صفحة about://webapks معلومات تفصيلية حول جميع تطبيقات الويب التقدّمية (PWA) المثبَّتة على الجهاز، ويمكنها أن تخبرك بتاريخ آخر تعديل للبيان وعدد مرات تعديله وغير ذلك.

لجدولة تحديث للبيان يدويًا، يؤدي إلغاء المؤقت والبيان المحلي إلى إجراء ما يلي:

  1. وصِّل الجهاز بالطاقة وتأكَّد من أنّه متصل بشبكة Wi-Fi.
  2. استخدِم مدير مهام Android لإيقاف تطبيق الويب التقدمي، ثم استخدِم لوحة التطبيقات في إعدادات Android لإيقاف تطبيق الويب التقدمي بشكلٍ قسري.
  3. في Chrome، افتح about://webapks وانقر على الزر "تحديث" لتطبيق الويب التقدّمي (PWA). يجب أن تتغير "حالة التحديث" إلى "في انتظار المراجعة".
  4. افتح تطبيق الويب المتوافق مع الأجهزة الجوّالة وتأكَّد من تحميله بشكل صحيح.
  5. استخدِم مدير مهام Android لإيقاف تطبيق الويب التقدمي، ثم استخدِم لوحة التطبيقات في إعدادات Android لإيقاف تطبيق الويب التقدمي بشكلٍ قسري.

يتم عادةً تحديث تطبيق الويب التقدّمي (PWA) في غضون بضع دقائق، وبعد اكتمال التحديث، من المفترض أن تتغيّر حالة التحديث إلى "تم بنجاح".

المراجع