متطلبات تغيير الرموز والاختصارات والألوان والبيانات الوصفية الأخرى لتطبيق الويب التقدّمي (PWA)
عند تثبيت تطبيق ويب تقدّمي (PWA)، يستخدم المتصفّح معلومات من بيان تطبيق الويب عن اسم التطبيق والرموز التي يجب أن يستخدمها التطبيق وعنوان URL الذي يجب فتحه عند تشغيل التطبيق. ولكن ماذا لو كنت بحاجة إلى تحديث اختصارات التطبيق أو تجربة لون مظهر جديد؟ متى وكيف تظهر هذه التغييرات في المتصفح؟
في معظم الحالات، يجب أن تظهر التغييرات خلال يوم أو يومين من إطلاق تطبيق الويب التقدّمي (PWA)، بعد تعديل البيان.
تحديثات على Chrome لأجهزة سطح المكتب
عند تشغيل تطبيق الويب التقدّمي (PWA) أو فتحه في علامة تبويب في المتصفّح، يحدّد Chrome آخر مرة تم فيها التحقّق من البيان المحلي بحثًا عن أي تغييرات. إذا لم يتم التحقق من البيان منذ آخر 24 ساعة، أو لم يتم التحقق منه خلال آخر 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)، يتم توصيل الجهاز واتصاله بشبكة WiFi، يطلب Chrome من الخادم تحديث WebAPK. وبعد التحديث، يتم استخدام جميع الحقول من البيان الجديد.
ما هي المواقع التي ستؤدي إلى إجراء تعديل؟
background_color
display
orientation
scope
shortcuts
start_url
theme_color
web_share_target
إذا لم يتمكن Chrome من الحصول على بيان معدَّل من الخادم، قد يؤدي ذلك إلى زيادة الوقت بين عمليات التحقّق إلى 30 يومًا.
اختبار تعديلات بيان التطبيق
تتضمن صفحة about://webapks
معلومات تفصيلية حول جميع تطبيقات الويب التقدّمية (PWA) المثبَّتة على الجهاز، ويمكنها أن تخبرك بتاريخ آخر تعديل للبيان وعدد مرات تعديله وغير ذلك.
لجدولة تحديث للبيان يدويًا، يؤدي إلغاء المؤقت والبيان المحلي إلى إجراء ما يلي:
- يُرجى توصيل الجهاز بمصدر الطاقة والتأكّد من اتصاله بشبكة Wi-Fi.
- استخدِم إدارة مهام Android لإيقاف تطبيق الويب التقدّمي (PWA)، ثم استخدِم لوحة التطبيق في إعدادات Android لفرض إيقاف تطبيق الويب التقدّمي (PWA).
- في Chrome، افتح
about://webapks
وانقر على الزر "تحديث" لتطبيق الويب التقدّمي (PWA). يجب أن تتغير "حالة التحديث" إلى "في انتظار المراجعة". - فعِّل تطبيق الويب التقدّمي (PWA) وتأكَّد من تحميله بشكل صحيح.
- استخدِم إدارة مهام Android لإيقاف تطبيق الويب التقدّمي (PWA)، ثم استخدِم لوحة التطبيق في إعدادات Android لفرض إيقاف تطبيق الويب التقدّمي (PWA).
يتم عادةً تحديث تطبيق الويب التقدّمي (PWA) في غضون بضع دقائق، وبعد اكتمال التحديث، من المفترض أن تتغيّر حالة التحديث إلى "تم بنجاح".
المراجع
- تعداد
UpdateReason
لمتصفّح Chrome على أجهزة Android