איך Chrome מטפל בעדכונים למניפסט של אפליקציית האינטרנט

מה נדרש כדי לשנות סמלים, קיצורי דרך, צבעים ומטא-נתונים אחרים של ה-PWA

אדריאנה ג'ארה

פרנסואה בופורט

פיט לה פייג'

כשמתקינים PWA, הדפדפן משתמש במידע ממניפסט האפליקציה לציון שם האפליקציה, הסמלים שבהם יש להשתמש ובכתובת ה-URL שאמורה להיפתח עם הפעלת האפליקציה. אבל מה קורה אם אתם צריכים לעדכן את קיצורי הדרך של אפליקציות או לנסות צבע עיצוב חדש? מתי ואיך השינויים האלה באים לידי ביטוי בדפדפן?

ברוב המקרים, השינויים אמורים להתעדכן תוך יום או יומיים מרגע הפעלת ה-PWA, לאחר עדכון המניפסט.

עדכונים ב-Chrome במחשב

כש-PWA מופעלת או נפתחת בכרטיסייה בדפדפן, Chrome קובע מתי בפעם האחרונה נבדקה שינויים במניפסט המקומי. אם המניפסט לא נבדק מאז ההפעלה האחרונה של הדפדפן או אם הוא לא נבדק ב-24 השעות האחרונות, 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, צריך לעדכן אותה במאפייני המניפסט החדשים.

קובצי עזר

• שדות Updatable Web Manifest

עדכונים ב-Chrome ל-Android

כשמפעילים את PWA, דפדפן Chrome קובע את הפעם האחרונה שבה נבדקו שינויים במניפסט המקומי. אם המניפסט לא נבדק ב-24 השעות האחרונות, Chrome יתזמן בקשת רשת עבור המניפסט, ולאחר מכן ישווה אותו לעותק המקומי.

אם מאפיינים מסוימים במניפסט השתנו (ראו רשימה למטה), המניפסט החדש ממתין בתור ב-Chrome, ואחרי שכל החלונות של ה-PWA נסגרו, המכשיר מחובר ל-Wi-Fi ומחובר ל-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 ולוחצים על הלחצן Update (עדכון) של ה-PWA. הסטטוס של 'סטטוס העדכון' אמור להשתנות ל'בהמתנה'.
4. מפעילים את ה-PWA ומוודאים שהיא נטענה כמו שצריך.
5. משתמשים במנהל המשימות של Android כדי לסגור את ה-PWA, ואז משתמשים בחלונית האפליקציה בהגדרות של Android כדי לאלץ את העצירה של ה-PWA.

ה-PWA בדרך כלל מתעדכן תוך כמה דקות, אחרי שהעדכון מסתיים, הסטטוס של 'סטטוס העדכון' אמור להשתנות ל'בוצע בהצלחה'.

קובצי עזר

• UpdateReason 'טיפוסים בני מנייה (enum)' ל-Chrome ב-Android