מדריך להמרת תוספים של Manifest V2 לתוספים של Manifest V3.
בקטע הזה מוסבר איך לשדרג תוסף מ-Manifest V2 ל-Manifest V3, הגרסה החדשה ביותר של פלטפורמת התוספים ל-Chrome. העבודה שקשורה להעברה מחולקת באופן כללי לקטגוריות הבאות. כדי לעזור לך לעקוב אחרי העבודה, צירפנו רשימת משימות עם סיכום של תוכן המסמכים האלה. אתם יכולים לגשת לתוכן באמצעות רשימת המשימות, או לעיין בתוכן. שני המסלולים מסתיימים בתוסף משודרג.
- עדכון המניפסט –
manifest.jsonצריך להיות ספציפי ל-V3. בקטע הזה מתוארים שינויים שאפשר לבצע בנפרד. שינויים במניפסט שקשורים לקוד מתוארים עם שינויי הקוד שהם תומכים בהם. - מעבר ל-service worker – service worker מחליף את הרקע של התוסף או את דף האירועים כדי להבטיח שקוד הרקע לא יפעל בשרשור הראשי, שבו הוא עלול לפגוע בביצועים. השינוי הזה מחייב גם להעביר את ה-DOM, את החלון וקריאות מסוימות ל-API של התוסף למסמכים מחוץ למסך.
- עדכון קריאות ל-API – צריך להחליף חלק מהקריאות ל-API באקווילנטיות מודרניות יותר.
- החלפת מאזינים לחסימת בקשות לאחזור מהרשת – חסימה או שינוי של בקשות לאחזור מהרשת ב-Manifest V2 עלולים לפגוע באופן משמעותי בביצועים ולדרוש גישה מוגזמת לנתונים רגישים של משתמשים. Declarative Net Request API מאפשר לתוספים לחסום או לשנות תוכן אינטרנט עם פחות הרשאות ובלי לפגוע בביצועים.
- שיפור האבטחה של התוספים – Manifest V3 משפר את האבטחה של התוספים בכמה דרכים. בנוסף למדיניות משופרת לאבטחת תוכן, הוסרה התמיכה בקוד שמתארח מרחוק ובהרצה של מחרוזות שרירותיות.
- פרסום התוסף – בחלק הזה מוסבר איך להפיץ את התוסף של Manifest V3 בשלבים, כדי לוודא שהוא פועל כמצופה. לשם כך, צריך לבדוק אותו קודם עם קהל מוגבל.
יש לנו גם כלי להמרת מניפסט של תוסף. הוא לא עושה הכול בשבילכם, אבל הוא יעזור לכם להתחיל. בקובץ ה-README של הכלי מפורט מה הכלי משנה.
שמירה של קבוצת התכונות הנוכחית
כדי לצמצם את הסיכוי לבעיות או באגים לא צפויים, מומלץ לא להוסיף פונקציות חדשות במהלך ההעברה. לדוגמה, אם מוסיפים תכונה שדורשת הרשאות חדשות, יכול להיות שתוצג אזהרה לגבי הרשאות, וההרחבה תושבת עד שהמשתמש יאשר את ההרשאות החדשות. במאמר שיטות מומלצות בנושא אזהרות לגבי הרשאות מוסבר על דרכים נוספות להוספת הרשאות בלי להציג אזהרה.
Manifest V3 נתמך בדרך כלל ב-Chrome 88 ואילך. כשמעדכנים קריאות API, יכול להיות שתכונות החלפה לא יופיעו ב-Chrome עד אחרי גרסה 88. במאמרי העזרה של ה-API מופיעים פרטי תמיכה לגבי חברים ספציפיים ב-API. אם תגלו שאתם צריכים אחת מהתכונות האלה, תוכלו לציין גרסת Chrome מינימלית בקובץ המניפסט.
תכונות חדשות בפלטפורמת התוספים
מאז ההשקה של Manifest V3, המשכנו להוסיף תכונות חדשות, שרבות מהן ניתנות לשימוש גם ב-Manifest V2 וגם ב-Manifest V3. לא חובה להשתמש בהן כשמבצעים המרה, אבל כשהן מחליפות תכונות ישנות יותר, מומלץ להשתמש בהן במקום בתכונות שהן מחליפות, וצריך לצפות לכך שהתכונות שהוחלפו יוצאו משימוש בסופו של דבר ויוסרו.