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

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

Adriana Jara

François Beaufort

Pete LePage

ملاحظة: نعمل حاليًا على جمع البيانات في المتصفّحات الأخرى غير Chrome. إذا كنت تريد مساعدتنا في جمع هذه البيانات أو إضافة محتوى إلى هذه الصفحة، يُرجى ترك تعليق في المشكلة رقم 4038.

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

تنبيه: لا تغيِّر اسم ملف بيان تطبيق الويب أو موقعه الجغرافي، لأنّ ذلك قد يمنع المتصفِّح من تحديث تطبيق الويب التقدّمي (PWA).

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

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

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

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

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

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

تنبيه: لا يمكن حاليًا إجراء تغييرات على name وshort_name وicons لا في متصفّح Chrome على أجهزة الكمبيوتر المكتبي، ولكنّنا نعمل على توفير هذه التغييرات.

تنبيه: يتطلّب إجراء تغييرات على start_url ضبط البيان id. مزيد من المعلومات

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

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

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

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

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

المراجع

• Updatable Web Manifest

تحديثات على 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 يومًا.

تنبيه: لا يمكن حاليًا إجراء تغييرات على name وshort_name وicons غير متاحة حاليًا على متصفّح Chrome في نظام التشغيل Android، ولكنّنا نعمل حاليًا على إتاحة هذه التغييرات.

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

تتضمن صفحة 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