一、基本概念
XPCOM是一个跨平台组件模型,它的全称为Cross Platform Component Object Module。XPCOM实现了一个框架(framework),这个框架中,它允许开发者打破单一整体的软件项目,而分解为多个更小的模块化碎片(pieces),这些碎片也即组件(components)。XPCOM组件开发类似于Microsoft COM组件,有COM基础者,很容易学习XPCOM。
二、搭建开发环境
XPCOM开发需要Gecko SDK ,由于Gecko SDK包含在XULRunner中,因此只要下载XULRunner SDK就可以进行开发,下面仍然以XULRunner 2.0为开发环境。
三、创建第一个XPCOM组件
1、新建ISampleComponents.idl文件,输入以下代码:
代码如下 | 复制代码 |
#include "nsISupports.idl" [scriptable, uuid(7F35DE58-C0E3-4480-9CA0-EB2A83F1B9CE)] interface ISampleComponents : nsISupports { long Sum(in long aFirst, in long aSecond); }; |
代码如下 | 复制代码 |
D:xulrunner2.0bin>xpidl -m header -I "..idl" ISampleComponents.idl D:xulrunner2.0bin>xpidl -m typelib -I "..idl" ISampleComponents.idl |
代码如下 | 复制代码 |
/*SampleComponents.h*/ #pragma once #ifndef _SAMPLE_COMPONENTS_H_ #define _SAMPLE_COMPONENTS_H_ #include "ISampleComponents.h" #define SAMPLE_COMPONENTS_CONTRACTID "@lintclr.com/ISampleComponents;1" #define SAMPLE_COMPONENTS_CID { 0x7f35de58, 0xc0e3, 0x4480, { 0x9c, 0xa0, 0xeb, 0x2a, 0x83, 0xf1, 0xb9, 0xce } }; class SampleComponents : public ISampleComponents { public: NS_DECL_ISUPPORTS NS_DECL_ISAMPLECOMPONENTS SampleComponents(); private: ~SampleComponents(); }; #endif |
其中,uuid是由是一个通过特定算法产生的二进制长度为128位的数字标识符,用于指示接口的唯一性,可以有Microsoft GUID工具产生,nsISupports此接口是最基本的一个接口,我们继承这个接口,添加一个Sum方法两个long类型参数,返回类型也为long。
2、编译ISampleComponents.idl文件
将此文件复制到XULRunner2.0bin目录中,在命令行中进入此目录,键入命令如下:
如果两行命令均无错误则会创建ISampleComponents.h和ISampleComponents.xpt两个文件。
3、使用VS2010开发组件
(1)新建一个一个win32 DLL空项目,并将第二步中的三个文件放到项目目录中,并将ISampleComponents.h添加到项目中。
(2)然后新建SampleComponents.h和SampleComponents.cpp两个文件,内容如下:
SampleComponents.cpp
(4)新建SampleComponentsModule.cpp文件,并键入如下代码:
(5)配置编译选项,编译组件
配置属性->VC++目录->附加包含目录:D:xulrunner2.0include;
配置属性->VC++目录->库目录:D:xulrunner2.0lib;
配置属性->C/C++->预处理器->预处理定义:XPCOM_GLUE
XP_WIN
XP_WIN32
XPCOM_GLUE_USE_NSPR
配置属性->链接器->输入->附加依赖项:nspr4.lib
xpcom.lib
xpcomglue_s_nomozalloc.lib
点击生成,生成组件成功。
代码如下 | 复制代码 |
/*SampleComponents.cpp*/ #include "SampleComponents.h" NS_IMPL_ISUPPORTS1(SampleComponents, ISampleComponents) SampleComponents::SampleComponents() { } SampleComponents::~SampleComponents() { } NS_IMETHODIMP SampleComponents::Sum(PRInt32 aFirst, PRInt32 aSecond, PRInt32 *_retval NS_OUTPARAM) { *_retval = aFirst + aSecond; return NS_OK; } |
代码如下 | 复制代码 |
#include "mozilla/ModuleUtils.h" #include"nsIClassInfoImpl.h" #include"SampleComponents.h" NS_GENERIC_FACTORY_CONSTRUCTOR(SampleComponents) NS_DEFINE_NAMED_CID(SAMPLE_COMPONENTS_CID); static const mozilla::Module::CIDEntry kSampleComCIDs[] = { { &kSAMPLE_COMPONENTS_CID, false, NULL, SampleComponentsConstructor }, { NULL } }; static const mozilla::Module::ContractIDEntry kSampleContracts[] = { { SAMPLE_COMPONENTS_CONTRACTID, &kSAMPLE_COMPONENTS_CID }, { NULL } }; static const mozilla::Module::CategoryEntry kSampleCategories[] = { {"my-category", "my-key", SAMPLE_COMPONENTS_CONTRACTID }, { NULL } }; static const mozilla::Module kSampleModule = { mozilla::Module::kVersion, kSampleComCIDs, kSampleContracts, kSampleCategories }; NSMODULE_DEFN(nsSampleModule) = &kSampleModule; NS_IMPL_MOZILLA192_NSGETMODULE(&kSampleModule) |