开发你的第一个Firefox插件

开发你的第一个Firefox插件

而JavaScript可以用来定义程序的行为。按照惯例，我们给出一段“你好世界”程序。

alert("Hello World!");

CSS可以用于自定义样式，而XPCOM可以用于调用Firefox提供的接口。另外，现在有一些JavaScript Library，可以直接使用而降低代码难度。

几个重要的文件

一个Mozilla插件大致由以下文件组成：

.│chrome.manifest│install.rdf│├─defaults│└─preferences│pref.js│└─chrome│├─content│├─overlay││ff_overlay.xul│││└─tools│├─skin│└─locale

最重要的两个文件是chrome.manifest和install.rdf。看字面意思，第一个是&ldquote;Chrome&rdquote;的声明，而第二个则是与安装有关的文件。
chrome是用来形容XUL应用中的所有GUI结构性元素的名词。例如，Firefox浏览器中除了网页内容之外的所有内容都是chrome。

chrome.manifest

下面是一个示例文件：

content imgview chrome/content/overlay chrome://browser/content/browser.xul chrome://imgview/content/overlay/ff_overlay.xul

可以按照需要进行修改。特别注意的是，overlay行中第三个元素将被附加在第二个元素上，第一个关键词是overlay。

install.rdf

本文件较简单。请参考下面给出的文件进行修改。

<RDF:RDF xmlns:em="http://www.mozilla.org/2004/em-rdf#"         xmlns:NC="http://home.netscape.com/NC-rdf#"         xmlns:RDF="http://www.w3.org/1999/02/22-rdf-syntax-ns#">  <RDF:Description RDF:about="urn:mozilla:install-manifest"                   em:id="imgview@osqdu.org.cn"                   em:name="OSQDU Image Viewer"                   em:iconURL=""                   em:version="0.0.0.1"                   em:type="2"                   em:creator="OSQDU::Alex"                   em:developer="OSQDU::Alex"                   em:description=""                   em:homepageURL="http://blog.osqdu.org/code-review-of-osqduimg_xx.shtml">     <!-- firefox -->    <em:targetApplication RDF:resource="rdf:#$eAzAq3"/>  </RDF:Description>  <RDF:Description RDF:about="rdf:#$eAzAq3"                   em:id="{ec8030f7-c20a-464f-9b0e-13905321042f}"                   em:minVersion="3.1a1pre"                   em:maxVersion="3.6.*" /></RDF:RDF>

?

代理文件

在开发应用时，可以使用代理文件代替build好的插件。这类似UNIX中的软链接。
打开Profile目录内的应用ID目录(例如 $MOZ_PROFILE/extensions/{ec8030f7-c20a-464f-9b0e-13905321042f}/)。
如果不愿使用GUID(Global Unique Identification Number)，也可以使用 “name@domain” 的方式命名，例如
imgview@osqdu.org。

开始我们的开发之旅创建项目

也许大家都已经习惯了使用集成开发环境来开发应用，但使用IDE并不是好主意，这里，我推荐使用Vi IMproved
作为主要的编辑器，原因不再赘述，如果不会使用vim，则可以使用Emacs—两个总是要会一个的，其他
推荐的编辑器有Notepad ++，为使用Windows而不想学习高级编辑器的程序员准备。

在Mozilla网站上，我们可以通过简单的通过Add-on Builder插件
生成一个新的插件。下载zip文件，使用你喜爱的存档管理器或unzip实用程序解压缩，修改install.rdf
以及chrome.manifest.

代码的编写

这一部分其实我并不想完成，因为代码归根结底还是程序员自己写的，而不是看Tutorial得到的。但是考虑到
有些同学是第一次接触Mozilla开发，对XUL, JavaScript并不熟悉，因此我们以Firefox应用挑战赛
的例程作为例程来讲解怎样开发一个真正的插件。请下载本例程。关于应用挑战赛，
请
点击这个链接(2010Firefox火狐浏览器应用挑战赛揭幕！——参加大赛，赢取笔记本电脑和就业机会，抱着本本上班去！)
了解详细情况。

点击这个链接(http://dl1.g-fox.cn/campus/20100618/demo.xpi)

解压缩demo.xpi，列目录，我们可以看到下面的文件：

total 224drwxr-xr-x  3 alex  staff   102B  4 23 09:13 chrome-rw-r--r--@ 1 alex  staff   231B  4 22 16:19 chrome.manifestdrwxr-xr-x  3 alex  staff   102B  4 23 09:13 defaults-rw-r--r--  1 alex  staff   102K  6 17 13:35 demo.xpi-rw-r--r--@ 1 alex  staff   923B  4 28 12:16 install.rdf

修改install.rdf以及chrome.manifest可以修改本项目的描述。下面我们将主要
以讲解chrome/content内的代码。

main.xul是在chrome.manifest里定义的overlay，打开，我们可以看到
这是一个标准的XML文档，但命名空间是特殊定义的，元素均是window的child。其中，包含了一些
script，这些script就是用于控制程序逻辑的了，例如tools/dom.js控制DOM相关的程序。

XUL的元素有很多，但是个人认为并不需要完全记忆。只要记住一些基本的元素，例如window
, popup, vbox, hbox等即可。XUL的样式可以通过CSS来订制，这也是
有些Firefox插件可以做的非常漂亮的技术基础。目前，Firefox支持CSS3以及HTML 5，可以在此基础上开发
大量美轮美奂的插件。

有些时候，需要在XUL内插入HTML，这时，只需用<html:{HTMLTAG}>即可。但是要记住的是这是XML，
标签一定要闭合，否则会在parse时出错，导致浏览器无法正常使用，特别是在overlay到浏览器时。当然，最要命的
是chrome.manifest出现问题。曾经在我开发Firefox插件时，有一天浏览器总是崩溃，只要在终端
里输入firefox -P，选择我的开发profile之后，浏览器就立即segfault。百思不得其解，最终重
新编译Firefox (在Linux下)，上了gdb，慢慢调试，才发现是chrome.manifest让浏览器疯掉了。

有一个非常好用的工具，XUL
Periodic Table。这个工具可以用于查询各种各样的布局，直接拿过来copy and paste即可。

下面讲解怎开发程序逻辑。首先要介绍的是dump("String")函数。本函数非常有用，随时可以在
终端里dump出一行信息，用于监视程序的运行。

JavaScript很简单，语法松散，当然后果就是有时候行为有点怪异。这里举几个简单的例子，告诉大家如何调用
Mozilla提供的接口。截图可能是非常常用的功能，而HTML 5里的canvas元素正好可以做这件事情。

function CaptureEntirePage() {  var doc = getBrowser().selectedBrowser.contentDocument;  var win = window.top.getBrowser().selectedBrowser.contentWindow;  var left = 0;  var top = 0;  var width = doc.documentElement.scrollWidth;  var height = doc.documentElement.scrollHeight;  var fName = "shot.png";  var canvas = document.createElementNS("http://www.w3.org/1999/xhtml", "html:canvas");  canvas.style.width = String(width) + "px";  canvas.style.height = String(height) + "px";  canvas.width = width;  canvas.height = height;  var ctx = canvas.getContext("2d");  ctx.clearRect(left, top, width, height);  ctx.save();  ctx.drawWindow(win, left, top, width, height, "rgb(255,255,255)");  ctx.restore();  var file =  SaveTemp(canvas, fName, 'S');  return canvas;}

上面的程序是我曾经开发过的一个插件的一部分。由于上段程序调用的函数都很简单，这里不再讲述如何使用。函数的
使用方法可以去MDC(Mozilla Developer Center)查询。MDC/Code snippets
里有很多现成的非常常用的代码用来参考，有一些CPAN的意思，当然不如CPAN大且全。

下面简单提一下文件操作，以此为例讲解如何使用XPCOM函数。

var file = Components.classes["@mozilla.org/file/directory_service;1"].                     getService(Components.interfaces.nsIProperties).                     get("ProfD", Components.interfaces.nsIFile);  

这里，file是一个nsIFile类型的变量。ProfD是Profile目录，其他常用
的目录还有Home，操作系统的家目录，例如/home/alex或者/Users/alex。TempD是
操作系统的临时目录，例如/tmp或/var/tmp。

下面介绍如何取一个nsIFile类型变量的路径。

var filePath = file.path;

其实就是这么简单。可以用file.create的方法添加目录，然后用下面的代码确认：

file.append("NewDirectort");if( !file.exists() || !file.isDirectory() ) {   file.create(Components.interfaces.nsIFile.DIRECTORY_TYPE, 0777);}

上面就添加了一个权限是777(drwxrwxrwx)的目录。777这个选项似乎对于Windows这类没有安全
特性的操作系统无效。

关于nsIFile的更多信息可以在MDC上查询，这里采用文件操作仅为了讲解较有代表性的函数，带领大家入门。

如何查找更多的信息

有一本书叫做Creating Applications with Mozilla，但这似乎是Netscape时代的书，
参考价值不大，建议大家不要购买。这里
可以合法的在网上阅读。

我推荐的学习方法是在写代码的过程中进行学习，这样才会有最好的学习效果。只看书，看资料而不写代码是
学不好写程序的。但是，资料仍然是必备的。下面推荐一些互联网资源，希望能帮助到大家。

MDN / Developing add-ons MDN / XUL School Tutorial XUL MDC foxbeans for Netbeans