字段摘要
以下字段为manifest.json的字段,其中name 和 version 是必须的
{
// Required
"name": "My Extension",
"version": "versionString",
// Recommended
"description": "A plain text description",
"icons": { ... },
"default_locale": "en",
// Pick one (or none)
"browser_action": {...},
"page_action": {...},
"theme": {...},
// Add any of these that you need
"background_page": "aFile.html",
"chrome_url_overrides": {...},
"content_scripts": [...],
"key": "publicKey",
"minimum_chrome_version": "versionString",
"options_page": "aFile.html",
"permissions": [...],
"plugins": [...],
"update_url": "http://path/to/updateInfo.xml"
"incognito": "split or spanning",
}
description
描述,普通文本字符串 (非HTML和其他格式,不能超过132个字符),用以描述该extension程序. 描述应同时适用于浏览器的用户界面和管理延伸扩展.
icons
Extension程序的图标,可以有一个或多个. 至少提供两个大小的图标— 48x48 and 128x128. 48x48 的图标用在extensions的管理界面(chrome://extensions). 128x128 的图标用在安装extension程序的时候. 还可以指定一个16x16 的图标当作 extension 的页面图标. 也可以显示在实验信息栏上。
图标一般为PNG格式, 因为最好的透明度的支持,不过WebKit支持任何格式,包括BMP,GIF,ICO等,和JPEG。下面是一个指定的图标的例子:
"icons": { "16": "icon16.png",
"48": "icon48.png",
"128": "icon128.png" },
注意: 以上写的图标不是固定的。随浏览器的环境的改变而变。如:安装时弹出的对话框变小。
default_locale
默认的语言环境
key
在开发程序加载完后,key值可用在控制唯一ID。
minimum_chrome_version
同version
name
一个简短的,纯文本字符串(不超过45个字符),程序的标识。该名称用在安装对话框中,Extension的管理界面
permissions
值为一个数组。每个权限可以是一个已知的字符串列表(如“标签”)或一个匹配模式,可以访问一个或多个主机。
以下是manifest 文件权限部分的例子:
"permissions": [
"tabs",
"bookmarks",
"http://www.blogger.com/",
"http://*.google.com/",
"unlimitedStorage"
],
以下为可能用到的权限清单:
权限 | 描述 |
match pattern | 指定一台主机的权限。如果需要交互运行网页上的代码。该属性是必须的,很多扩展功能,如跨域请求XMLHttpRequests,注入的内容脚本编程,以及CoookiesAPI需要主机的权限。 |
"bookmarks" | |
"chrome://favicon/" | |
<img src="chrome://favicon/http://www.google.com/"> | |
"contextMenus" | |
"cookies" | |
"experimental" | |
"geolocation" | |
"history" | |
"idle" | |
"notifications" | 允许extension 程序使用HTML5 notification API ,不需要访问权限方法 (比如checkPermission()). 详见Desktop Notifications. |
"tabs" | 详见 chrome.tabs or chrome.windows 模块. |
"unlimitedStorage" | 提供一个用于存储HTML5的客户端的数据,如数据库和本地存储的文件,不设限额。如果没有这个权限,扩展限制为5MB本地存储空间。 |
version
一至四个以点分隔的整数标识版本。一些应用于整数的规则:他们必须在0和65535之间,包括非零整数。例如,99999和032都是无效的。
下面是有效版本的一些例子:
•“版本”:“1”
•“版本”:“1.0”
•“版本”:“2.10.2”
•“版本”:“3.1.2.4567”
自动更新系统版本比较,以确定是否已安装扩展需要更新。如果发布扩展已安装的扩展较新版本的字符串,然后扩展名自动更新。
比较开始从最左边的整数。如果这些整数是平等的,右边的整数进行比较,依此类推。例如,1.2.0是一个比1.1.9.9999更新的版本。
一个缺少整数等于零。例如,1.1.9.9999版本比是1.1更新的版本。详见 Autoupdating.