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

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

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

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

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

קובצי עזר