标题: 基于Mozilla平台的扩展开发（续）----XPCOM组件篇
- Phinecos(洞庭散人) 2008-04-25 22:19 阅读:2401
- 评论:14 查看评论 | 添加评论

源代码下载：HelloWorld示例.rar


在《浅谈基于Mozilla ThunderBird的扩展开发》这篇入门文章中简单介绍了基于Mozllia平台进行扩展开发的基础知识，但仍然欠缺最为重要的一种武器---没错，XPCOM!这篇文章就是为它准备的。

XPCOM是什么？

      这个问题不多做解释了，相信XPCOM对于了解COM技术的人来说很快就可以上手开发了，下列是Mozilla官方给出的一些XPCOM知识的入门资源：

个人尤其推荐IBM developerworks上那5篇文章。

       使用已有的XPCOM

              XPCOM的使用十分简单，Mozilla平台已经为我们提供了许多功能强大的XPCOM组件了，如果你需要某方面功能的组件，请先看看Mozilla平台下是不是已经有对应的了，别再“自己造轮子了“。

           关于这方面也不打算再多说了，有兴趣的朋友可以阅读IBM developerworks下面这篇文章，《实战 Firefox 扩展开发》，相信通过这样一个图片批量下载工具的开发，就会对于Mozilla平台下已有的XPCOM组件的使用有所了解的。


     So,what's next? 

    没错，自己如何开发XPCOM组件并在扩展中使用。网上对于这方面的资料不是很多，而且没有特别完整的示例，这就是我写这篇文章的目的所在，通过一个简单的XPCOM组件的开发全过程，展示XPCOM组件的内部细节。

       项目目标：

组件要实现的功能非常简单，就只提供一个做加法的接口供客户调用。

 long Add(in long a, in long b);

然后在扩展中调用这个加法接口。

 

准备工作

 

0，按照《浅谈基于Mozilla ThunderBird的扩展开发》这篇文章建立起开发扩展的基本环境。  

1、下载Gecko SDK

http://ftp.mozilla.org/pub/mozilla.org/mozilla/releases/mozilla1.8b1/gecko-sdk-i586-pc-msvc-1.8b1.zip ，我们需要使用它来对IDL定义进行解释。

2、创建GUID

使用微软的的guidgen 生成GUID，例如b7b04070-45fc -4635- b219-7a172f806bee

4，从C:\mozilla-build\moztools-180compat\bin下拷贝libIDL-0.6.dll，glib-1.2.dll到\gecko-sdk-i586-pc-msvc-1.8b1\gecko-sdk\bin下，否则运行xpidl会报错.

开发XPCOM组件

1，创建接口文件定义

[图片]#include "nsISupports.idl"
[图片][scriptable, uuid(b7b04070-45fc -4635- b219-7a172f806bee)]
[图片]interface IMyComponent : nsISupports
[图片][图片][图片]{
[图片]  long Add(in long a, in long b);
[图片]};
[图片]

2、使用Gecko SDK 的xpidl.exe
      进入xpidl所在目录，在CMD中输入命令

[图片]xpidl -m header -I ..\idl  IMyComponent.idl（这里应该是IDL定义文件的实际路径）
[图片]xpidl -m typelib -I ..\idl  IMyComponent.idl
[图片]

如果上面执行有问题的话，可以将

[图片]\gecko-sdk-i586-pc-msvc-1.8b1\gecko-sdk\bin;\gecko-sdk-i586-pc-msvc-1.8b1\gecko-sdk\idl;\gecko-sdk-i586-pc-msvc-1.8b1\gecko-sdk\include;

加入到环境变量的PATH里面去。     

如果上述命令执行通过，在\gecko-sdk-i586-pc-msvc-1.8b1\gecko-sdk\bin就会得到IMyComponent.h，IMyComponent.xpt 这2个文件。

2、创建新文件

根据IMyComponent.h创建文件MyComponent.h，MyComponent.cpp，MyComponentModule.cpp。

[图片][图片]/**//* MyComponent.h*/
[图片]
[图片]#pragma once
[图片]
[图片]#ifndef _MY_COMPONENT_H_
[图片]#define _MY_COMPONENT_H_
[图片]
[图片]#include "IMyComponent.h"
[图片]#define MY_COMPONENT_CONTRACTID "@mydomain.com/XPCOMSample/MyComponent;1"
[图片]#define MY_COMPONENT_CLASSNAME "A Simple XPCOM Sample"
[图片]#define MY_COMPONENT_CID  {0xb7b04070, 0x45fc, 0x4635,{ 0xb2, 0x19, 0x7a, 0x17, 0x2f, 0x80, 0x6b, 0xee } }
[图片]
[图片]
[图片]class MyComponent:public IMyComponent
[图片][图片][图片]{
[图片]public:
[图片]    NS_DECL_ISUPPORTS
[图片]    NS_DECL_IMYCOMPONENT
[图片]    MyComponent(void);
[图片]    ~MyComponent(void);
[图片]};
[图片]#endif
[图片]

[图片]
[图片][图片]/**//* MyComponent.cpp*/
[图片]#include "StdAfx.h"
[图片]#include "MyComponent.h"
[图片]
[图片]NS_IMPL_ISUPPORTS1(MyComponent, IMyComponent)
[图片]
[图片]MyComponent::MyComponent(void)
[图片][图片][图片]{
[图片]}
[图片]
[图片]MyComponent::~MyComponent(void)
[图片][图片][图片]{
[图片]}
[图片]
[图片]NS_IMETHODIMP MyComponent::Add(PRInt32 a, PRInt32 b, PRInt32 *_retval)
[图片][图片][图片]{
[图片]    *_retval = a + b;
[图片]    return NS_OK;
[图片]}
[图片]


[图片][图片]/**//* MyComponentModule.cpp*/
[图片]#include "StdAfx.h"
[图片]#include "nsIGenericFactory.h"
[图片]#include "MyComponent.h"
[图片]
[图片]NS_GENERIC_FACTORY_CONSTRUCTOR(MyComponent)
[图片]
[图片]static nsModuleComponentInfo components[] =
[图片][图片][图片]{
[图片][图片]    [图片]{
[图片]        MY_COMPONENT_CLASSNAME, 
[图片]        MY_COMPONENT_CID,
[图片]        MY_COMPONENT_CONTRACTID,
[图片]        MyComponentConstructor,
[图片]    }
[图片]};
[图片]
[图片]NS_IMPL_NSGETMODULE("MyComponentsModule", components) 
[图片]

编译XPCOM组件

1、创建工程

使用VC2005，创建新的DLL工程，将IMyComponent.h， MyComponent.h，MyComponent.cpp，MyComponentModule.cpp添加到工程中。

 

2、工程配置

[图片]1）c/c++ GeneralAdditional Include Directories 中设置为\gecko-sdk-i586-pc-msvc-1.8b1\gecko-sdk\include
[图片]2) c/c++Preprocessor Preprocessor Definitions中加入MYCOMPONENT_EXPORTS,XPCOM_GLUE
[图片]3）c/c++Code GenerationRuntime Library中设置为Multi-threaded DLL (/MD)
[图片],这里非常重要，否则编译会报错的！！。
[图片]4）LinkerAdditional Liberary Directoryse设置为\gecko-sdk-i586-pc-msvc-1.8b1\gecko-sdk\lib
[图片]5）Linker Additional Depenendies加入nspr4.lib plds4.lib plc4.lib xpcomglue.lib
[图片]

3、编译生成MyComponent.dll。

在扩展中使用XPCOM组件

 

对《浅谈基于Mozilla ThunderBird的扩展开发》中的helloworld项目进行修改，加入一个文件夹components和一个安装文件install.js。
[图片]

   关于这两个东西具体的含义这里就不多做介绍了，简单点说,intall.js就是把XPCOM组件注册到Mozilla平台中去，就类似于Windows的注册表一样，从而可以使用组件。

1）Install.js的内容：

[图片]// Install script for helloworld
[图片]
[图片]var err;
[图片]const APP_VERSION="0.0.0.1";//版本号
[图片]
[图片]//初始化安装
[图片]err = initInstall("helloworld"+APP_VERSION,  // name for install UI
[图片]                  "/helloworld",               // registered name
[图片]                  APP_VERSION);              // package version
[图片]if(err!=0)
[图片][图片][图片]{//安装出错，取消安装
[图片]    cancelInstall(err);
[图片]}
[图片]
[图片]//标准目录
[图片]var fProgram = getFolder("Program");//程序根目录 
[图片]var fChrome     = getFolder("Chrome");//chrome目录
[图片]var fComponents = getFolder("Components");//components目录
[图片]
[图片]// workaround for Mozilla 1.8a3 and newer, failing to register enigmime correctly
[图片]var delComps = [ "compreg.dat" ]; // Components registry
[图片]for (var j=0; j<delComps.length; j++)
[图片][图片][图片]{
[图片]     var delFile = getFolder(fComponents, delComps[j]);
[图片]     if (File.exists(delFile))
[图片]        File.remove(delFile);
[图片]}
[图片]
[图片]err = getLastError();
[图片]if (err == DOES_NOT_EXIST)
[图片][图片][图片]{
[图片]    // error code: file does not exist
[图片]    resetError();
[图片]}
[图片]else if (err != SUCCESS) 
[图片][图片][图片]{
[图片]    cancelInstall(err);
[图片]}
[图片]
[图片]// addDirectory: blank, archive_dir, install_dir, install_subdir
[图片]addDirectory("", "components",    fComponents, "");
[图片]addDirectory("", "chrome",        fChrome,     "");
[图片]
[图片]
[图片]err = getLastError();
[图片]if (err == ACCESS_DENIED)
[图片][图片][图片]{
[图片]    alert("Unable to write to components directory "+fComponents+".\n You will need to restart the browser with administrator/root privileges to install this software. After installing as root (or administrator), you will need to restart the browser one more time, as a privileged user, to register the installed software.\n After the second restart, you can go back to running the browser without privileges!");
[图片]    cancelInstall(ACCESS_DENIED);
[图片]
[图片]} 
[图片]else if (err != SUCCESS)
[图片][图片][图片]{
[图片]    cancelInstall(err);
[图片]
[图片]} 
[图片]else 
[图片][图片][图片]{
[图片]    // Register chrome
[图片]    registerChrome(PACKAGE | DELAYED_CHROME, getFolder("Chrome","helloworld.jar"), "content/helloworld/");
[图片]    err = getLastError();
[图片]    if (err != SUCCESS)
[图片][图片]    [图片]{
[图片]      cancelInstall(err);
[图片]    }
[图片]    else
[图片][图片]    [图片]{
[图片]      performInstall();
[图片]    }
[图片]}
[图片]

2）在Componts文件夹中加入MyComponent.dll和IMyComponent.xpt


3）修改overlay.js如下：

[图片]// This is the main function
[图片]const ENIG_C = Components;
[图片]const ENIG_ENIGMAIL_CONTRACTID = "@mydomain.com/XPCOMSample/MyComponent;1"
[图片]var gEnigmailSvc = null;
[图片]
[图片]function helloWorld()
[图片][图片][图片]{
[图片]    try
[图片][图片]    [图片]{
[图片]        alert("准备创建组件");
查看评论 | 添加评论
返回顶部 | 返回首页