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

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

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

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

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

تحديثات على Chrome لأجهزة سطح المكتب

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

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

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

  • display (انظر أدناه)
  • scope
  • shortcuts
  • start_url
  • theme_color
  • file_handlers

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

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

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

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

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

المراجع