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元素 

Content script是在一个特殊环境中运行的，这个环境成为isolated world（隔离环境）。它们可以访问所注入页面的DOM,但是不能访问里面的任何javascript变量和函数。 对每个content script来说，就像除了它自己之外再没有其它脚本在运行。 反过来也是成立的： 页面里的javascript也不能访问content script中的任何变量和函数。

 

为页面元素添加插件内图片的例子 
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