איך 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 זהירות: כדי לשנות את start_url צריך להגדיר את קובץ המניפסט id. מידע נוסף
  • 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.
  2. משתמשים במנהל המשימות של Android כדי לסגור את ה-PWA, ואז משתמשים בחלונית האפליקציות בהגדרות Android כדי להפסיק את ה-PWA באופן ידני.
  3. ב-Chrome, פותחים את about://webapks ולוחצים על לחצן העדכון של ה-PWA. הסטטוס 'עדכון סטטוס' אמור להשתנות ל'בהמתנה'.
  4. מפעילים את ה-PWA ומוודאים שהוא נטען בצורה תקינה.
  5. משתמשים במנהל המשימות של Android כדי לסגור את ה-PWA, ואז משתמשים בחלונית האפליקציות בהגדרות Android כדי להפסיק את ה-PWA באופן ידני.

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

קובצי עזר