Chrome 插件开发

写在开头: 相当有意思的UI界面,编码实现,浏览速度.对于一天浏览器使用超过10个小时的人来说,能够定制自己的浏览器,是相当的具有诱惑力.

Getting Started
1:目前不支持标准发布版本的Chrome插件扩展,不过也有消息马上就开发了,对于我们这个不是问题.4.0使用中
2:创建一个所必要的文件夹,名字任意,用于存放所需文件,开发后,可以通过Chrome打包提交
3:manifest.json文件,存放描述信息,也可以理解为插件运行的总入口,使用JSON的格式进行定义
{
  "name": "My First Extension", //程序名称
  "version": "1.0", //版本
  "description": "The first extension that I made.",//描述
  "browser_action": {//对浏览器的操作
    "default_icon": "icon.png"//图标
  },
  "permissions": [ //权限,用于定义所需的网络资源
    "http://api.flickr.com/"
  ]
}
4:可以在browser_action中对功能进行添加
"popup": "popup.html"//指定点击按钮后触发的行为,

5:弹出的html扩展名文件,进行编写弹出窗编写,允许使用Js and css,使用的时候注意HTML必须包含在文件夹内
尤其指出,其中可以使用HTML5标准的元素
插件包含的文件
1:manifest 文件,2:任意个HTML文件,3:JavaScript文件,4:图片Image文件
打包后会被压缩成特殊格式的zip文件,扩展名为.crx

background page :用于保存插件的主要逻辑,
插件的逻辑分为: page action,browser action两种,,background.html文件的js同时控制两种action

action,可以理解为动作,也就是浏览器表现出来的行为,如弹出窗一样
browser_action 包括 a tooltip, a badge, and a popup.

可以在Manifest文件中注册所需的browser action,其中default_icon为必须的,其他均为可选(or)

UI部分
Icon:大多图片格式都可以,推荐使用19像素的正方形图片,设置的方式分为两种,manifest文件内的default_icon,或者调用setIcon()方法
Tooltip:设置manifest的default_title属性,或调用setTitle()方法
Badge:用于在图标下显示的字符,字数限制在4个字符一下,可以通过setBadgeText() and setBadgeBackgroundColor()设置内容和背景色
Popup:点击后弹出的窗口.定义在manifest文件中,browser_action的popup属性

chrome.browserAction的常用方法,其中参数使用json对象,具体查看对应的API查询key

setBadgeBackgroundColor: 设置Badge背景色
chrome.browserAction.setBadgeBackgroundColor(object details);

setBadgeText:Badge内容
chrome.browserAction.setBadgeText(object details)

setIcon:设置图标
chrome.browserAction.setIcon(object details)

shetTitle:设置Tooltip
chrome.browserAction.setTitle(object details)

browserAction的事件
chrome.browserAction.onClicked.addListener(function(Tab tab) {...}); //将会在点击图标后触发
//这里的参数,比Js多了一种类型

2:为插件提供对应的options选项页面,在manifest文件中添加对应的options_page:选项,使用HTML
"options_page": "options.html",

所需的HTML可以为一个完整格式的HTML文档,包含所需的html元素

Override界面: 用于替换新tab界面,区别于默认的界面,在manifest文件中进行注册
"chrome_url_overrides": {
    "newtab": "newtab.html"
  },

Page Actions: 用于出现在指定页面中的图标
"page_action": {
    "default_icon": "icons/foo.png", // required
    "default_title": "Do action",    // optional; shown in tooltip
    "popup": "popup.html"            // optional
  },
区别Browser action,page action并不包含badges,但是可以控制page action是否显示,通过调用 show() and hide() methods

同样对browser的建议也适用与page action;

一些常见Page action的方法
hide; 
chrome.pageAction.hide(integer tabId)
setIcon
chrome.pageAction.setIcon(object details)
setTitle
chrome.pageAction.setTitle(object details)
show
chrome.pageAction.show(integer tabId)
事件,类似browser action的事件
onClicked
chrome.pageAction.onClicked.addListener(function(tab) {...});

Themes皮肤
也是打包成标准的扩展组件,但是并不包含对应的JS和HTML代码,只用主要的manifest.json文件进行设置
{
  "version": "2.6",
  "name": "camo theme",
  "theme": {
    "images" : {
      "theme_frame" : "images/theme_frame_camo.png",
      "theme_frame_overlay" : "images/theme_frame_stripe.png",
      "theme_toolbar" : "images/theme_toolbar_camo.png",
      "theme_ntp_background" : "images/theme_ntp_background_norepeat.png",
      "theme_ntp_attribution" : "images/attribution.png"
    },
    "colors" : {
      "frame" : [71, 105, 91],
      "toolbar" : [207, 221, 192],
      "ntp_text" : [20, 40, 0],
      "ntp_link" : [36, 70, 0],
      "ntp_section" : [207, 221, 192],
      "button_background" : [255, 255, 255]
    },
    "tints" : {
      "buttons" : [0.33, 0.5, 0.47]
    },
    "properties" : {
      "ntp_background_alignment" : "bottom"
    }
  }
}

默认皮肤,可以通过下面的链接进行查看
http://src.chromium.org/viewvc/chrome/trunk/src/chrome/browser/browser_theme_provider.cc

其中tints中,使用 Hue-Saturation-Lightness  灰度 饱和 亮度进行设置,值都是在0-1之间

浏览器交互: Browser Interaction
Bookmarks,Events,Tabs,Windows等

Bookmarks,收藏夹,可以创建,组织和管理收藏夹
设置权限: manifest文件中
"permissions": [
    "bookmarks"
  ],
收藏夹使用tree的形式保存对象,其中主要使用 BookmarkTreeNode对象进行访问,常用的属性有:index, title, and url.

注:树结构本身比较繁琐一些,可以使用下面方法参考进行访问
    function btnclick(){
    chrome.bookmarks.getTree(function(ass){
    console.log(ass[0].children[0]);
          for(obj in ass[0].children[0].children){
          console.log(ass[0].children[0].children[obj].title);
          }
    })
    }
建议先查看debug方法(ps:比较繁琐,但是配合console.log比较方便查看对象结构)

其中的id使用的也是自增,由0开始
常见的方法 
create , get getChildren getTree move remove removeTree search update
常见的事件

常见的事件
onChanged onChildrenReordered onCreated onMoved onRemoved

使用的例子:
chrome.bookmarks.onMoved.addListener(...)
chrome.bookmarks.getTree(...) //具体请查看API

Event事件的使用例子
chrome.tabs.onCreated.addListener(function(tab) {
  appendToLog('tabs.onCreated --'
              + ' window: ' + tab.windowId
              + ' tab: '    + tab.id
              + ' index: '  + tab.index
              + ' url: '    + tab.url);
});
注意加载对应的permissions权限 tabs
事件的全部操作方法:
void addListener(function callback(...))
void removeListener(function callback(...))
bool hasListener(function callback(...))

Tabs  用于控制每个标签 , 调用时为chrome.tabs
常见的方法:
captureVisibleTab connect create detectLanguage executeScript get getAllInWindow getSelected insertCSS move remove sendRequest update

常见的事件:
onAttached onCreated onDetached onMoved onRemoved onSelectionChanged onUpdated

Windows  Chrome中的多窗口

方法调用中可选的windowId参数,默认为当前窗口

调用对象: chrome.windows

常见的方法: create get getAll getCurrent getLastFocused remove update
常见的事件:onCreated onFocusChanged onRemoved

Background Pages, 注册在manifest文件中,用于保存长时间运行的脚本,运行在插件所在的进程中,多用于类似守护线程一样的作用,用于状态的更新
获取页面的方式:
var views = chrome.extension.getViews(); //获取到的数组,通过循环或者索引得到指定的view也就是js的windows对象,不过这里只局限配置在manifest中的html元素
"background_page": "background.html",

Content Scripts 用于对指定页面的内容进行脚本调用
同样 需要在manifest文件中进行注册
  "content_scripts": [
    {
      "matches": ["http://www.google.com/*"],
      "css": ["mystyles.css"],
      "js": ["jquery.js", "myscript.js"]
    }
  ],
 
常见的属性:
matches, 字符串数组,根据制定的匹配模式进行对指定URL页面的注入
js:指定的脚本文件将会被注入到符合的页面中去 可选
css:需要被嵌入的css,可选
run_at:用于设置何时进行注入,默认为document_idle,还有其他的:document_start,document_end,
all_frames:boolean 默认为false

使用的方式可以参考官方文档,不过注意并不能简单的替换同名function来达到注入替换事件的效果,不过可以直接使用document.getElementById获取指定的dom组件,并进行修改.
作用域的问题上: 对于原有的变量并不能访问到,如果需要进行替换,需要进行完整的事件,变量进行重新声明替换
比较特殊的作用域:对于注入的代码,将会有一个封闭的作用域,并不会与原有的进行冲突,当却可以修改页面的DOM元素

为页面元素添加插件内图片的例子
var imgURL = chrome.extension.getURL("images/myimage.png");
document.getElementById("someImage").src = imgURL;

Cross-Origin XMLHttpRequest 跨站点的异步调用,用于使用插件访问其他网站的API
分为本地与外部数据两种方面

本地插件内数据:不需要设置权限
var xhr = new XMLHttpRequest();
xhr.onreadystatechange = handleStateChange; // Implemented elsewhere.
xhr.open("GET", chrome.extension.getURL('/config_resources/config.json'), true);
xhr.send();
注:0表示本地请求成功

外部网站,需要设置manifest文件中permissions,添加对应的网站地址,更多使用在插件内部功能上
"permissions": [
    "http://www.google.com/"
  ],
对于匹配的URL也可以使用模糊匹配
"http://*.google.com/"
"http://*/"  表示允许访问所有的网站 ,这里注意对https也要独立的编写
内置的json转换 JSON.parse(....);可以用于将制定的字符串,转换成所需的js对象

再次提示,如果需要访问其他网站,一定注意添加权限permissions

Message Passing 消息传递

Simple one-time requests:发送一个简单的json数据从一个content script发送到插件的background.html文件中,反之亦然
chrome.extension.sendRequest() 或 chrome.tabs.sendRequest() methods
可选的一个回调函数,可以用于接收返回的内容
如:定义在content script文件中
chrome.extension.sendRequest({greeting: "hello"}, function(response) {
  console.log(response.farewell);
});
在background发送使用特殊一些,需要使用getSelected获取选中的tab后,然后发送请求
chrome.tabs.getSelected(null, function(tab) {
  chrome.tabs.sendRequest(tab.id, {greeting: "hello"}, function(response) {
    console.log(response.farewell);
  });
});

接收的代码为:
chrome.extension.onRequest.addListener(
  function(request, sender, sendResponse) {
    console.log(sender.tab ?
                "from a content script:" + sender.tab.url :
                "from the extension");
    if (request.greeting == "hello")
      sendResponse({farewell: "goodbye"});
    else
      sendResponse({}); // snub them.
  });

Long-lived connections 长周期连接
能够保持连接,持续的进行数据收发
从content script 连接到background(插件)的代码
var port = chrome.extension.connect({name: "knockknock"});
port.postMessage({joke: "Knock knock"});
port.onMessage.addListener(function(msg) {
  if (msg.question == "Who's there?")
    port.postMessage({answer: "Madame"});
  else if (msg.question == "Madame who?")
    port.postMessage({answer: "Madame... Bovary");
});

如果要从background插件处发起连接,需要稍作修改,去获取指定的id
chrome.tabs.connect(tabId, {name: "knockknock"}).
设置监听连接的监听器
chrome.extension.onConnect.addListener(function(port) {
  console.assert(port.name == "knockknock");
  port.onMessage.addListener(function(msg) {
    if (msg.joke == "Knock knock")
      port.postMessage({question: "Who's there?"});
    else if (msg.answer == "Madame")
      port.postMessage({question: "Madame who?"});
    else if (msg.answer == "Madame... Bovary")
      port.postMessage({question: "I don't get it."});
  });
});

对应的监听断开方法Port.disconnect(),和对应的事件Port.onDisconnect

Cross-extension messaging 跨插件消息
主要使用chrome.extension.onRequestExternal or chrome.extension.onConnectExternal
方法的细节与上述的连接事件一致

这里还是提到一下跨站点Js攻击的问题,少使用eval转换返回的字符串,而建议使用专门的JSON.parse方法

NPAPI Plugins 用于提供Js调用本地二进制代码 ,建议最后使用,也许功能很强大.

Autoupdating和Packaging章节略过

因为Chrome开发自WebKit,所以可以调用其特有的API
V8 Js引擎也为chrome提供了JSON对象
可以在插件内部集成所需的JS插件,如jQuery

暂时结束,有空再研究...开始GWT2.0

评论

4 楼 18215361994 2016-08-01  

chrome扩展中可以获取开发者工具所有资源不？

3 楼 yuyue618 2010-12-06  

qq123zhz 写道

mainfest.json 如何支持中文？？

UTF-8就可以使用中文

2 楼 ilinxiao 2010-08-31  

期待您的更新呢！

1 楼 qq123zhz 2010-08-20  

mainfest.json 如何支持中文？？