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

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

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

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

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

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

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

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

אילו מאפיינים יפעילו עדכון?

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

כדי לתזמן עדכון למניפסט באופן ידני, מבטלים את הטיימר ואת המניפסט המקומי:

  1. מחברים את המכשיר ל-Wi-Fi ומוודאים שהוא מחובר ל-Wi-Fi.
  2. משתמשים במנהל המשימות של Android כדי לסגור את ה-PWA, ואז משתמשים בחלונית האפליקציה בהגדרות של Android כדי לסגור ידנית את ה-PWA.
  3. פותחים את about://webapks ב-Chrome ולוחצים על הלחצן Update (עדכון) של ה-PWA. סטטוס העדכון אמור להשתנות ל"בהמתנה".
  4. מפעילים את ה-PWA ומוודאים שהיא נטענת כראוי.
  5. משתמשים במנהל המשימות של Android כדי לסגור את ה-PWA, ואז משתמשים בחלונית האפליקציה בהגדרות של Android כדי לסגור ידנית את ה-PWA.

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

קובצי עזר