一、基本概念
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) |