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

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

קובצי עזר