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