גרסת המניפסט

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

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

גירסה נוכחית

נכון לעכשיו, מפתחים צריכים לציין 'manifest_version': 2:

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

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

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

אוגוסט 2012

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

מרץ 2013

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

אפריל 2013

• גרסת הבטא של Chrome 27 תפסיק לארוז תוספים מגרסה 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.