גרסת המניפסט

אזהרה: מוצגת גרסת המניפסט V2 של המאמר הזה שהוצאה משימוש. כדי למצוא את הגרסה המקבילה ל-MV3, אפשר לעיין בקטע Manifest V3 – Manifest_version. בחנות האינטרנט של Chrome אי אפשר יותר להשתמש בתוספי Manifest V2. פועלים לפי ההוראות במדריך להעברת מניפסט מגרסה V3 כדי להמיר את התוסף למניפסט מגרסה V3.

תוספים, עיצובים ואפליקציות הם פשוט חבילות של משאבים, ארוזים קובץ manifest.json שמתאר את תוכן החבילה. הפורמט של הקובץ הזה הוא יציבה באופן כללי, אבל מדי פעם יש לבצע שינויים שעלולים לגרום לכשל כדי לטפל בבעיות חשובות. המפתחים צריכים לציין את הגרסה של מפרט המניפסט לפי יעד החבילות שלהם להגדיר מפתח manifest_version במניפסטים שלהם.

גרסה נוכחית

בשלב הזה, מפתחים צריכים לציין את 'manifest_version': 2:

{
  ...,
  "manifest_version": 2,
  ...
}

גרסה 1 של המניפסט הוצאה משימוש ב-Chrome 18, והתמיכה תופסק בהדרגתיות בהתאם לפי לוח הזמנים.

לוח זמנים לתמיכה בגרסה 1 של המניפסט

אוגוסט 2012

• חנות האינטרנט תחסום את היצירה של תוספים חדשים לגרסה 1 של המניפסט.
• חנות האינטרנט תאפשר עדכונים לתוספים קיימים של גרסה 1 של המניפסט.

מרץ 2013

• חנות האינטרנט תחסום עדכונים לגרסה 1 של תוסף המניפסט ב-4 במרץ 2013.

אפריל 2013

• Chrome 27 Beta יפסיק לארוז תוספים לגרסה 1 של המניפסט (או לטעון אותם עבור פיתוח).

יוני 2013

• חנות האינטרנט תסיר את תוספי המניפסט של גרסה 1 מהקיר, מתוצאות החיפוש, בדפי קטגוריות.
• הודעות יישלחו באימייל לכל המפתחים שיש להם תוספי מניפסט בגרסה 1 שעדיין נמצאים בחנות להזכיר לו שהפרסום של התוספים האלה יבוטל, וכולל הוראות לעדכון.

ספטמבר 2013

• בחנות האינטרנט תבוטל הפרסום של כל התוספים לגרסה 1 של המניפסט.
• מפתחים עם תוספי מניפסט מגרסה 1 עדיין נמצאים באינטרנט באימייל עם הודעה אחרונה חנות.
• Chrome ימשיך לטעון ולהפעיל תוספים מותקנים של המניפסט בגרסה 1.

ינואר 2014

• Chrome יפסיק לטעון או להפעיל תוספי מניפסט מגרסה 1.

שינויים בין גרסה 1 לגרסה 2

• כברירת מחדל, מדיניות אבטחת תוכן מוגדרת כ-`script-src 'self'; object-src 'self';. הזה יש מגוון השפעות על מפתחים, כפי שמתואר בהרחבה בcontent_security_policy התיעוד.
• כברירת מחדל, המשאבים של חבילה אינם זמינים יותר לאתרים חיצוניים (בתור src של תמונה, או תג script). אם אתם רוצים שאתר יוכל לטעון משאב שכלול החבילה, צריך להוסיף אותה באופן מפורש לרשימת ההיתרים דרך המניפסט web_accessible_resources . הדבר רלוונטי במיוחד לתוספים שבונים ממשק באתר באמצעות סקריפטים של תוכן שהוחדרו.
• הנכס background_page הוחלף בנכס background שמכיל נכס scripts או page. פרטים נוספים זמינים בדפי האירועים התיעוד.

• שינויים בפעולה בדפדפן:

  • המפתח browser_actions במניפסט וה-API chrome.browserActions נעלמו. משתמשים ב במקום זאת, יש להזין browser_action ו-chrome.browserAction.
  • המאפיין icons של browser_action הוסר. עליך להשתמש במאפיין default_icon או browserAction.setIcon במקום זאת.
  • המאפיין name של browser_action הוסר. עליך להשתמש במאפיין default_title או browserAction.setTitle במקום זאת.
  • המאפיין popup של browser_action הוסר. להשתמש בdefault_popup במקום זאת או ב-browserAction.setPopup.
  • אי אפשר יותר לציין את המאפיין default_popup של browser_action כאובייקט. הוא חייב להיות מחרוזת.

• שינויים בפעולות בדף:

  • המפתח page_actions במניפסט וה-API chrome.pageActions נעלמו. משתמשים ב במקום זאת, יש להזין page_action ו-chrome.pageAction.
  • המאפיין icons של page_action הוסר. צריך להשתמש במאפיין default_icon או במקום זאת, pageAction.setIcon.
  • המאפיין name של page_action הוסר. צריך להשתמש בנכס default_title או במקום זאת, pageAction.setTitle.
  • המאפיין popup של page_action הוסר. עליך להשתמש במאפיין default_popup או pageAction.setPopup.
  • אי אפשר יותר לציין את המאפיין default_popup של page_action כאובייקט. חובה להיות מחרוזת.

• ממשק ה-API chrome.self הוסר. במקום זאת, אתם צריכים להשתמש ב-chrome.extension.

• chrome.extension.getTabContentses (!!!) ו-chrome.extension.getExtensionTabs נעלמו. כדאי להשתמש extension.getViews.

• Port.tab לא זמין. במקומו צריך להשתמש ב-runtime.Port.