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

متطلبات تغيير الرموز والاختصارات والألوان والبيانات الوصفية الأخرى لتطبيق الويب التقدّمي (PWA)

أدريانا جارا

فرانسوا بوفورت

بيت ليب

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

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

آخر الأخبار على متصفِّح Chrome المتوافق مع أجهزة الكمبيوتر المكتبي

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

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

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

• 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

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

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

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

• background_color
• display
• orientation
• scope
• shortcuts
• start_url
• theme_color
• web_share_target

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

اختبار تحديثات البيان

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

لجدولة عملية تعديل على البيان يدويًا، يؤدي إلغاء الموقّت والبيان المحلي إلى تنفيذ ما يلي:

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

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

المراجع

• تعداد UpdateReason لمتصفِّح Chrome على نظام التشغيل Android