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

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

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

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

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

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

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

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

קובצי עזר