快速入门 - 配置

  • 作者:KK

  • 发表日期:2016.02.20


先定义配置文件

配置文件名固定叫manifest.json,里面是以JSON格式编写配置的。

有个manifest_version的根字段要声明配置版本。现在最新的版本是2,现在我们尝试开发插件就写manifest_version : 2

其中编码规范有以下2点:

  1. 所有键名要用双引号,键值如果是字符串都要用双引号,不使用单引号,如果键值是数字则不管你,反正用上了字符串就得双引号。

  2. 数组的最后一个元素不能加逗号,会导致配置语法报错。

下面贴出这个manifest_version文件的配置样本内容:

{
    "name": "插件名称,比如上架到谷歌应用商店时要显示",
    "version": "1.0.0",	//你的插件版本
    "manifest_version": 2,	//配置版本号,你就跟着写2就是了
    "description": "插件介绍",
    "browser_action": {
        "default_icon": "ico.png",	//插件图标文件名,需要在配置文件相同目录下放这个文件让配置解析器去读取得到
        "default_title": "插件图标标题", //这个图标目前是嵌在浏览器地址栏右边区域的,鼠标划过会显示这个标题
        "default_popup": "ui.html"	//点击插件图标后默认弹出的插件界面,将会读取同目录下这个文件作为界面
    },
	
	//插件权限配置
    "permissions": [
        "http://xxx.com/xxx.html",	//这个插件在哪些网址下能生效,不匹配的网址不会出现插件图标
        "*://*/*",	//要在全部网址下生效,不能直接写一个 * 号,而是要有 协议头 域名 pathinfo 三个部分的描述,每个部分全匹配才写*号
        "http://xxx.com/shop/*.html",	//可以为部分片段设置通配符
        "tabs"	//这个字符串表示插件可以操作网页选项卡,比如新建/关闭/切换当前选项卡
    ]
}