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

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

Adriana Jara

François Beaufort

Pete LePage

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

في معظم الحالات، من المفترض أن تظهر التغييرات في غضون يوم أو يومَين من إطلاق التطبيق المتوافق مع الأجهزة الجوّالة (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 (المتوفّرة في الإصدار 85 من Chrome أو الإصدارات الأحدث) معلومات مفصّلة عن جميع التطبيقات المتوافقة مع الأجهزة الجوّالة التي تم تثبيتها على الجهاز، ويمكن أن تساعدك في معرفة وقت آخر تعديل للملفات البيانية ومعدّل تحديثها وغير ذلك.

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

المراجع

• حقول بيان الويب القابلة للتعديل

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

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

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

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

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

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

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

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

لجدولة تعديل على البيان يدويًا، وتجاوز الموقّت وملف البيان المحلي، اتّبِع الخطوات التالية:

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

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

المراجع

• UpdateReason enum لمتصفّح Chrome على Android