如何编写 Cloud9 JavaScript IDE 的功能扩展

上周末我们在JSConf.eu发布了Cloud9 IDE，同时发布了对应的GitHub项目。在4天时间里该项目得到340个人的关注和将近50个fork。Cloud9的口号是由"由Javascripters 为Javascripters创建的IED"，这口号有点递归，它意味着你可以hack这个ide使它变得更强大。Cloud9项目开始之初就尤其注意考虑这点了；Cloud9中的每一个功能点都是一个扩展(extension)。在IED启动的时候我们用优秀的 requireJS 库加载所有的扩展。前端UI使用 ajax.org platform (apf)，apf 使我们轻松地模块化Cloud9的用户界面。下面开始详细介绍怎样为Cloud9编写扩展。

一个扩展的生命周期是从它作为requireJS的模块开始的。我将简述requireJS的基本语法，想深入了解requireJS请参考这个文档。一个扩展会依赖其他的扩展和一些核心模块。我们将编写一个给编辑器中选定的JSON代码进行格式化的扩展。该扩展依赖核心模块：core/ide, core/ext, core/util 和编辑器管理扩展：ext/editors/editors.让我们称该扩展为formatjson，然后将其置于ext文件夹下。

require.def("ext/formatjson/formatjson",
    ["core/ide",
    "core/ext",
    "core/util",
    "ext/editors/editors",
    "text!ext/formatjson/formatjson.xml"],
    function(ide, ext, util, editors, markup) {

return ext.register("ext/formatjson/formatjson", {
        //Object definition
});

    }
);

require.def 第一个参数标识扩展的名字，第二参数中 ide，ext ，util和 editors 代表传入该扩展依赖的对象引用，formatjson扩展的第五个依赖是加载为一个文本的xml文件。 ‘text!’ 语法告诉 requireJS 不要将参数引入的文件解析为 javascript，仅将其中的内容作为文本返回即可。所有依赖加载完毕后将调用第三个参数代表的回调函数，在回调函数中将我们的扩展注册到扩展管理器中，让我们看看扩展文件的结构。

{
    name   : "JSON Formatter",
    dev    : "Your Name Here",
    alone  : true,
    type   : ext.GENERAL,
    markup : markup,

    hook    : function(){},
    init    : function(){},
    enable  : function(){},
    disable : function(){},
    destroy : function(){}
}

属性和方法详解:

属性

方法