今天看到淘宝UED团队发布了一个Chrome扩展,用于支持在Chrome浏览器点击"和我联系"按钮会弹出旺旺的聊天窗口。我把这个扩展下载了下来,发现里面使用了插件,不理解这个"npwangwang.dll"对应的代码就不能理解这个扩展,Google官方文档中没有怎么讲插件的开发,也找不到什么好的实例。如果淘宝将这个扩展的源代码公开就好啦,刚好一直想研究下Mozilla NPAPI的使用,毕竟Javascript的接口很有限。Chrome OS的右上角要显示很多系统信息,比如电池的电量,这通过浏览器扩展没法完成,我想要直接调用系统接口就应该通过插件来完成。花了点时间先研究了下ActiveX组件的编写,以及在Javascript如何使用ActiveX组件,非IE浏览器都不支持ActiveX,所以只能在IE类浏览器来运行该实例了。我大致看过潘爱民的《COM原理和应用》,学到一些些皮毛,然后对CORBA也有一些皮毛的认识,虽然很晕,但是这些皮毛知识对于我尝试这个例子还是有一些帮助的。
在学习的过程中,我发现下面两篇文章很有指导意义,代码基本是从第一篇文章拷贝而来。
1、http://www.diybl.com/course/3_program/c++/cppsl/2008827/138079.html
2、http://www.chenjiliang.com/Article/View.aspx?ArticleID=3387
第一篇文章先写了一个DLL,这个DLL实现了求两个数之和的函数。接着实现了一个简单的ATL对象,通过该ATL对象调用DLL中实现的函数,最后在Javascript中调用该ATL对象相应的方法以求两个数之和。
我想着扩展一下这个例子,在DLL中实现了一个函数以获取笔记本电脑电池电量的剩余时间,关于电池的信息,Windows提供了一个很方便的API-GetSystemPowerStatus供开发者使用,该API返回一个结构体如下:
typedef struct _SYSTEM_POWER_STATUS {
BYTE ACLineStatus;
BYTE BatteryFlag;
BYTE BatteryLifePercent;
BYTE Reserved1;
DWORD BatteryLifeTime;
DWORD BatteryFullLifeTime;
} SYSTEM_POWER_STATUS, *LPSYSTEM_POWER_STATUS;
通过MSDN可以查到结构体各字段的意义,这个例子中只用到了第五个字段用以获取电池的可持续时间(以秒为单位,当笔记本电脑直接接着交流电时会返回-1),当然也可以一次性返回整个结构体,不过这需要定义比较复杂的IDL类型,我想着返回简单int型比较简单,所以也就返回这一个值了。
首先新建一个DLL工程,就取名为CalcImpl工程,然后新建一个dll.h和dll.cpp文件,在dll.h写入以下代码:
#ifndef _DLL_H_
#define _DLL_H_
#if defined DLL_EXPORT
#define DECLDIR _declspec(dllexport)
#else
#define DECLDIR _declspec(dllimport)
#endif
extern "C"
{
DECLDIR int Add(int a, int b);
DECLDIR int ShowBatteryLifeTime(void);
}
#endif
在dll.cpp写入以下代码:
#include <windows.h>
#define DLL_EXPORT
#include "dll.h"
extern "C"
{
DECLDIR int Add(int a, int b)
{
return (a + b);
}
DECLDIR int ShowBatteryLifeTime(void)
{
SYSTEM_POWER_STATUS SystemPowerStatus;
GetSystemPowerStatus(&SystemPowerStatus);
int BatteryLifeTime = SystemPowerStatus.BatteryLifeTime;
return BatteryLifeTime;
}
}
Build会生成CalcImpl.lib和CalcImpl.dll文件。接着新建一个ATL Project,取名为CalcCtrl,完成之后会自动生成很多文件。接着为工程添加一个类,在对话框中选择"ATL Simple Object",在接下来的对话框中输入"MyTest",在Options中勾上"Support"多选框中的"Connection points"和"IObjectWithSite(IE object support)",点finish之后工程会生成MyTest对象,自动生成MyTest.h和MyTest.cpp等文件。然后选择类视图,右击"IMyTest"项,然后选择"Add"->"Add Method",在弹出的对话框中的"Method name"处填入"GetBatteryLifeTime",这个方法是最后供Javascript使用的。我发现这儿有一个奇怪的事情,在为方法名选择参数时,out和retval多选框始终都是灰色的,而in确实可以选上的。因为根据用户的选择会生成相关的代码,此处如果不能设置好返回类型,那么就必须手动修改一些文件了。CalcCtrl.idl文件中有接口的定义,接口的实现则放在MyTest.cpp中。编译CalcCtrl.idl文件居然不会对MyTest.h和MyTest.cpp做相应的修改,有点不方便。"GetBatteryLifeTime"只有一个int型的返回值,手动修改CalcCtrl.idl中该接口的声明如下:
GetBatteryLifeTime([out, retval]INT* out);
对MyTest.h和MyTest.cpp也做相应的处理,因为两个文件中都是C++的代码,所以去掉[out, retval]便可。在MyTest.h头文件中添加以下两句:
#include "../CalcImpl/dll.h" //用于包含相关函数声明
#pragma comment(lib, "CalcImpl.lib") //隐式使用CalcImpl.dll所需要的
第一篇文章中直接通过LoadLibrary/GetProcAddress/FreeLibrary来使用CalcImpl.dll中的函数,这样太麻烦了,即要声明函数指针类型,又要注意释放句柄,不如通过隐式调用来使用CalcImpl.dll中的函数。在MyTest.cpp文件的CMyTest::GetBatteryLifeTime函数写入以下代码:
STDMETHODIMP CMyTest::GetBatteryLifeTime(INT* out)
{
//只是简单地调用CalcImpl.dll中的函数
*out = ShowBatteryLifeTime();
return S_OK;
}
build CalcCtrl工程将生成CalcCtrl.dll,不过会有如下的错误提示:
Project : error PRJ0050: Failed to register output. Please try enabling Per-user Redirection or register the component from a command prompt with elevated permissions.
VS似乎在尝试注册该组件,权限不够所以失败了,在一个普通的命令窗口使用regsvr32注册组件也会失败,如果使用管理员身份打开命令窗口就能成功注册该组件了。上面这个错误没有什么影响,因为注册是要交给浏览器自动完成的,这儿生成CalcCtrl.dll就好了。
当网页中嵌入ActiveX对象时,浏览器会判断该对象是否已经存在,如果不存在将提示下载相关的资源,下载完成之后如何处置,这就需要一个inf文件来说明了。因此创建一个setup.inf文件,写入以下内容:
[version]
; version signature (same for both NT and Win95) do not remove
signature="$CHICAGO$"
AdvancedINF=2.0
[Add.Code]
CalcCtrl.dll=CalcCtrl.dll
CalcImpl.dll=CalcImpl.dll
setup.inf=setup.inf
[install.files]
CalcCtrl.dll=CalcCtrl.dll
CalcImpl.dll=CalcImpl.dll
setup.inf=setup.inf
[CalcCtrl.dll]
clsid={A83904E6-3288-431C-8213-8874E228990E}
file-win32-x86=thiscab
FileVersion=1,0,0,1
DestDir=11
RegisterServer=yes
[CalcImpl.dll]
file-win32-x86=thiscab
DestDir=11
FileVersion=1,0,0,1
RegisterServer=yes
[setup.inf]
file=thiscab
[RegisterFiles]
%11%\CalcCtrl.dll
; end of INF file
"DestDir=11"表示将DLL下载到系统目录下(WINDOWS/SYSTEM32)。CalcImpl.dll、CalcCtrl.dll和setup.inf三件东西都准备好了之后就要开始打包了。打开一个cmd窗口,输入"iexpress",根据向导一步步做,最后生成一个calc.CAB文件。接着写一个测试网页,内容如下:
<HTML>
<HEAD>
<TITLE>Test ActiveX</TITLE>
<OBJECT ID="CalcCtrl" NAME="CalcCtrl"
CODEBASE="calc.CAB#version=1,0,0,1"
CLASSID="clsid:A83904E6-3288-431C-8213-8874E228990E">
</OBJECT>
<script language="javascript">
function doTest()
{
var leftTime = CalcCtrl.GetBatteryLifeTime();
if(leftTime == -1)
{
alert("unknown");
}
else
{
var hours;
//Javascript的'/'运算符并不会取整
hours = leftTime / 3600;
alert(hours + "hours");
}
}
</script>
</HEAD>
<BODY>
<input type="button" value="Get left time" id="btnOK" onclick="doTest();"></input>
</BODY>
</HTML>
上面用到的clsid可以在工程中的MyTest.rgs文件找到,这个文件中包含一些要写入注册表的信息,setup.inf中的那个clsid随便填似乎都可以,这个页面中的clsid就必须填正确了。使用IE浏览器打开该页面之后,会提示有不安全的内容,点击"允许阻止的内容"之后,会接连弹出两个对话框(这里是在单机环境进行测试的,在真实的网路环境下,可以还要配置下IE浏览器,让其运行未验证的ActiveX对象或者添加信任域),然后就可以在"WINDOWS/SYSTEM32"目录下发现CalcImpl.dll,CalcCtrl.dll这两个文件了。当笔记本接着交流电时,弹出的对话框将将提示"unknown",只有拔掉电源,不断刷新页面,过一会儿将显示电池的剩余使用时间。
每次使用时都会弹出如下的对话框,很烦人。
可以参看第二篇文章,将类MyTest从IObjectSafetyImpl派生可以解决这个问题。我还发现另外一个问题,如果使用下面的代码调用ActiveX对象:
MyTest = new ActiveXObject( "CalcCtrl.MyTest");
var sum = MyTest.GetBatteryLifeTime();
浏览器并不会自动下载calc.CAB文件,所以页面运行将出错。但是如果组件已经被安装了,使用这种方法却又能正常工作。