基于Mozilla Thunderbird的扩展开发(七)---工欲善其事,必先利其器-阿里云开发者社区

开发者社区> 开发与运维> 正文

基于Mozilla Thunderbird的扩展开发(七)---工欲善其事,必先利其器

简介:
20080506.bmp
Mozilla扩展系列链接:
1,浅谈基于Mozilla Thunderbird的扩展开发
2,基于Mozilla平台的扩展开发(续)----XPCOM组件篇
3,基于Mozilla Thunderbird的扩展开发(三)---如何获取邮件的完整信息
4,基于Mozilla Thunderbird的扩展开发(四)---修改源代码实现自动保存附件
5,基于Mozilla Thunderbird的扩展开发(五)---进程间通信之Socket篇(上)
6,基于Mozilla Thunderbird的扩展开发(六)---进程间通信之Socket篇(下)
7, 基于Mozilla Thunderbird的扩展开发(七)---工欲善其事,必先利其器
Mozilla最为人诟病的地方就是没有称手的开发工具,这对于我们这些被微软惯坏的开发人员来说,如果没有Visual Studio这样舒服的工具的话,谁会投入你的怀抱呢?本文就希望从三个方面介绍下我所了解到的Mozilla 平台下的开发工具及一些小技巧。
最原始的方法当然是全部手工打造,从插件的编写,到打包,这样做的好处是对Mozilla平台下插件的开发有比较深入的了解,但缺点就是每次做一些小的修改后都需要重复进行压缩,打包等一系列繁杂的工序,如果你喜欢这种方法,可以参考我这篇文章:《浅谈基于Mozilla ThunderBird的扩展开发》,也可以参考Mozilla开发中心这篇文章《Building an Extension》。
      每次修改代码后就得自己手动重新打包,发布,安装,你对这些已经感到厌烦了吗?好的,那就想办法脱离苦海吧。我们仔细分析后发现,就是一个打包的问题,因此我们就可以使用Ant来完成这些琐碎的打包工作,下面就是《浅谈基于Mozilla ThunderBird的扩展开发》中使用的build.xml文件:
<?xml version="1.0"?>
<project name="helloworld" default="createxpi">
  <delete file="helloworld.xpi"/>
  <delete file="helloworld.jar"/>
  <target name="createjar">
    <zip destfile="helloworld.jar" compress="false">
        <fileset dir="chrome">
            <include name="content/**"/>
        </fileset>
    </zip>
  </target>

  <target name="createxpi" depends="createjar">
    <zip destfile="helloworld.xpi">
      <zipfileset dir="." includes="helloworld.jar" prefix="chrome" />
      <zipfileset dir="." includes="chrome.manifest"/>
      <zipfileset dir="." includes="install.rdf" />
    </zip>
  </target>
</project>

如果你的项目结构比这个要复杂的话,请根据自己的需求更改此文件再使用Ant编译就可以了。这种方法也是我目前使用最多的方法了,因为感觉控制起来比较灵活。
      如果你喜欢集成化的开发工具,想让它为你做更多的事情的话,这里推荐一个工具:NetBean+foxbeans+foxfiles,后面两个插件是用于开发Mozilla平台插件的,下载地址为:
Foxbeans: http://plugins.netbeans.org/PluginPortal/faces/PluginDetailPage.jsp?pluginid=4209
Foxfiles: http://plugins.netbeans.org/PluginPortal/faces/PluginDetailPage.jsp?pluginid=4649
官方的入门文档:
http://wiki.netbeans.org/MozillaAddonDevelopment
不过不推荐用这个插件,试用了一下,并不是很好用。
     
      再来谈下另一个问题,在做界面时,如何快速地获知目标程序中想overlay掉的控件的id以及它的属性呢?这在做插件开发时是一个比较重要的方面,因为你的插件的界面就是附着在目标程序(firefox,thunderbird或sunbird)上的。那么官方推荐的工具就够用了,这个插件就是DOM Inspector,它可以用来定位你所需要的控件。
      Venkman是官方推荐的调试工具,但个人感觉还是不大好用。
另外几个调试的技巧是:1)可以试用”dump语句来显示调试信息,不过这需要进行一些配置工作。2)在代码中使用nsIConsoleService 将日志信息输出到JavaScript控制台中。
3)自己编译一个debug版本的firefox或thunderbird,并且在其源代码或你的C++ XPCOM组件中设置断点,进一步的信息可以参考Mozilla开发中心的文档。
      除此以外,我们也可以自己开发一个日志工具类来记录感兴趣的信息,下面是我常用的一个日志组件类:

const CI = Components.interfaces, CC = Components.classes, CR = Components.results;
tBirdBiffUtility.classID = Components.ID("{e07f8540-831f-11db-9fe1-0800200c9a66}");
tBirdBiffUtility.contractID = "@phinecos.cnblogs.com/HelloWorld/utility;1";
tBirdBiffUtility.classDescription = "Utility Service";

//日志组件
function tBirdBiffUtility()
{
  this.consoleService = CC["@mozilla.org/consoleservice;1"].getService(CI.nsIConsoleService);//控制台服务
  this.logFile = null;//日志文件对象
  this.logToFile = true;//是否开启日志功能,默认为开启,插件发布后,关闭它就是
}

tBirdBiffUtility.prototype =
{
  initialize: function()
  {//初始化
    this.getLoggingPref();
  },

  closeLogFile: function()
  {//关闭日志文件
    if(this.logFile)
    {
      this.logFile.close(null);
    }
  },

  openLogFile: function()
  {//打开日志文件
    this.closeLogFile();//关闭先前的日志文件

    if(!this.logToFile)
    {
      return;
    }

    var tmpFile = CC["@mozilla.org/file/directory_service;1"]
        .getService(CI.nsIProperties).get("TmpD", CI.nsILocalFile);
    //构造日志文件名称
    var filename = "HelloWorld";
    if(this.isFirefox())
    {
      filename += "-firefox.log";
    }

    if(this.isSunbird())
    {
      filename += "-sunbird.log";
    }

    if(this.isThunderbird())
    {
      filename += "-thunderbird.log";
    }

    tmpFile.append(filename);
    //创建不重名的日志文件
    tmpFile.createUnique(CI.nsIFile.NORMAL_FILE_TYPE, 0664);

    this.logFile = CC["@mozilla.org/network/file-output-stream;1"]
        .createInstance(CI.nsIFileOutputStream);

    // write, create, truncate
    this.logFile.init(tmpFile, 0x02 | 0x08 | 0x20, 0664, this.logFile.DEFAULT_REPLACEMENT_CHARACTER);
  },

  isFirefox: function()
  {
    if(this.getApplicationId() == "{ec8030f7-c20a-464f-9b0e-13a3a9e97384}")
    {
      return true;
    }
    else
    {
      return false;
    }
  },

  isSunbird: function()
  {
    if(this.getApplicationId() == "{718e30fb-e89b-41dd-9da7-e25a45638b28}")
    {
      return true;
    }
    else
    {
      return false;
    }
  },

  isThunderbird: function()
  {
    if(this.getApplicationId() == "{3550f703-e582-4d05-9a08-453d09bdfdc6}")
    {
      return true;
    }
    else
    {
      return false;
    }
  },

  getLoggingPref: function()
  {
    // look for and use a preference if given
    if (this.logToFile == true)
    {//开启了日志功能
        this.openLogFile();
          this.logToConsole("tBirdBiffUtility.getLoggingPref", "thunderbirdbiff.logToFile preference setting is " + this.logToFile);
    }
    else
    {//没有开启日志功能
      this.logToConsole("tBirdBiffUtility.logToFile", "No thunderbirdbiff.logToFile preference setting found, using FALSE default");
      this.logToFile = false;
    }
  },

  logError: function(source, message)
  {//记录错误信息
    var callingFunction = source;
    var error = CC["@mozilla.org/scripterror;1"].createInstance(CI.nsIScriptError);
    error.init(callingFunction + "(): " + message, null, null, null, null, CI.nsIScriptError.errorFlag, null);
    this.consoleService.logMessage(error);
    this.log(source, "ERROR-" + message);
    this.callingFunction = null;
    this.error = null;
  },

  writeToLogFile: function(msg)
  {//写入日志文件
    if(this.logToFile)
    {
      this.logFile.write(msg + "\n", msg.length + 1);
    }
  },

  log: function(source, message)
  {//日志功能
    var msg =  source + "():\n\   " + message;

    try
    {
      this.writeToLogFile(msg);
    }
    catch(e)
    {
      var errorMsg = "Error trying to write logfile: " + e + " -- Opening a new file\n";
      this.logToConsole(errorMsg);
      this.openLogFile();
      if(this.logFile)
      {
        this.writeToLogFile(errorMsg);
        this.writeToLogFile(msg);
      }

      errorMsg = null;
    }

    msg = null;
  },

  logToConsole: function(source, message)
  {//写日志到控制台
    var msg = this.getAddonName() + "." + source + "():\n\   " + message;
    this.consoleService.logStringMessage(msg);
    this.log(source, message);
    msg = null;
  },

  getApplicationInfo: function()
  {//获取目标程序信息
    return CC["@mozilla.org/xre/app-info;1"].getService(CI.nsIXULAppInfo);
  },

  getApplicationId: function()
  {//获取目标程序id
    if(!this.id)
    {
      this.id = this.getApplicationInfo().ID;
    }

    return this.id;
  },

  onObserve: function(subject, topic, data)
    {
    },

  // nsISupports
    QueryInterface: function(aIID)
    {
    if( aIID.equals(CI.nsISupports) ||
      aIID.equals(CI.nsIClassInfo) ||
      aIID.equals(CI.nsIObserver))
        {
            return this;
        }

        throw CR.NS_ERROR_NO_INTERFACE;
    },

  // nsIClassInfo
    getInterfaces: function(aCount)
    {
        var ifaces = new Array();
    ifaces.push(CI.nsISupports);
    ifaces.push(CI.nsIClassInfo);
    ifaces.push(CI.nsIObserver);
        aCount.value = ifaces.length;
        return ifaces;
    },

  // nsIClassInfo
    getHelperForLanguage: function(aLanguage) { return null; },
  get contractID() { return tBirdBiffUtility.contractID; },
  get classID() { return tBirdBiffUtility.classID; },
  get classDescription() { return tBirdBiffUtility.classDescription; },
  get implementationLanguage() { return CI.nsIProgrammingLanguage.JAVASCRIPT; },
  get flags() { return CI.nsIClassInfo.SINGLETON; },

  // nsIObserver
    observe: function(aSubject, aTopic, aData)
    {
        switch(aTopic)
        {
            case "xpcom-startup":
      {
        // this is run very early, right after XPCOM is initialized, but before
                // user profile information is applied. Register ourselves as an observer
                // for 'profile-after-change' and 'quit-application'
                //
        var obsSvc = CC["@mozilla.org/observer-service;1"].getService(CI.nsIObserverService);
                obsSvc.addObserver(this, "profile-after-change", false);
                obsSvc.addObserver(this, "quit-application", false);
                break;
      }

      case "profile-after-change":
      {
                // This happens after profile has been loaded and user preferences have been read.
                // startup code here
        this.initialize();
        break;
      }

            case "quit-application":
      {
        var obsSvc = CC["@mozilla.org/observer-service;1"].getService(CI.nsIObserverService);
                obsSvc.removeObserver(this, "profile-after-change");
                obsSvc.removeObserver(this, "quit-application");
        break;
      }

            default:
      {
                this.onObserve(aSubject, aTopic, aData);
      }
        }
  },

    get wrappedJSObject() { return this; }
}

// ====================================================================================
// constructors for objects we want to XPCOMify
//
var gXpComObjects = [tBirdBiffUtility];
var gCatObserverName = tBirdBiffUtility.classDescription; // can be anything
var gCatContractID = tBirdBiffUtility.contractID;

// **********
// generic registration code below. Useful URL: http://www.mozilla.org/projects/xpcom/book/cxc/html/weblock.html
// **********
function NSGetModule(compMgr, fileSpec)
{
    gModule._catObserverName = gCatObserverName;
    gModule._catContractId = gCatContractID;

    for (var i in gXpComObjects)
        gModule._xpComObjects[i] = new FactoryHolder(gXpComObjects[i]);

    return gModule;
}

function FactoryHolder(aObj)
{
    this.classID = aObj.classID;
    this.contractID = aObj.contractID;
    this.className  = aObj.classDescription;
    this.factory =
    {
        createInstance: function(aOuter, aIID)
        {
            if (aOuter)
                throw CR.NS_ERROR_NO_AGGREGATION;

            return (new this.constructor).QueryInterface(aIID);
        }
    };

    this.factory.constructor = aObj;
}

var gModule =
{
    _xpComObjects: {},
    _catObserverName: null,
    _catContractId: null,

    registerSelf: function(aComponentManager, aFileSpec, aLocation, aType)
    {
    aComponentManager.QueryInterface(CI.nsIComponentRegistrar);
        for (var key in this._xpComObjects)
        {
            var obj = this._xpComObjects[key];
            aComponentManager.registerFactoryLocation(obj.classID, obj.className,
            obj.contractID, aFileSpec, aLocation, aType);
        }

    var catman = CC["@mozilla.org/categorymanager;1"].getService(CI.nsICategoryManager);
        catman.addCategoryEntry("xpcom-startup", this._catObserverName, this._catContractId, true, true);
        catman.addCategoryEntry("xpcom-shutdown", this._catObserverName, this._catContractId, true, true);
    },

    unregisterSelf: function(aCompMgr, aFileSpec, aLocation)
    {
    var catman = CC["@mozilla.org/categorymanager;1"].getService(CI.nsICategoryManager);
        catman.deleteCategoryEntry("xpcom-startup", this._catObserverName, true);
        catman.deleteCategoryEntry("xpcom-shutdown", this._catObserverName, true);

    aComponentManager.QueryInterface(CI.nsIComponentRegistrar);
        for (var key in this._xpComObjects)
        {
            var obj = this._xpComObjects[key];
            aComponentManager.unregisterFactoryLocation(obj.classID, aFileSpec);
        }
    },

    getClassObject: function(aComponentManager, aCID, aIID)
    {
    if (!aIID.equals(CI.nsIFactory))
            throw CR.NS_ERROR_NOT_IMPLEMENTED;

        for (var key in this._xpComObjects)
        {
            if (aCID.equals(this._xpComObjects[key].classID))
                return this._xpComObjects[key].factory;
        }

        throw CR.NS_ERROR_NO_INTERFACE;
    },

  canUnload: function(aComponentManager)
  {
    return true;
  }
}



本文转自Phinecos(洞庭散人)博客园博客,原文链接:http://www.cnblogs.com/phinecos/archive/2008/05/21/1204341.html,如需转载请自行联系原作者

版权声明:本文内容由阿里云实名注册用户自发贡献,版权归原作者所有,阿里云开发者社区不拥有其著作权,亦不承担相应法律责任。具体规则请查看《阿里云开发者社区用户服务协议》和《阿里云开发者社区知识产权保护指引》。如果您发现本社区中有涉嫌抄袭的内容,填写侵权投诉表单进行举报,一经查实,本社区将立刻删除涉嫌侵权内容。

分享:
开发与运维
使用钉钉扫一扫加入圈子
+ 订阅

集结各类场景实战经验,助你开发运维畅行无忧

其他文章