最近需要开发一个浏览器的插件。浏览器的插件在 Windows 下面被分为了两类，一类是利用 IE 内核的，其插件是 ActiveX 的模式；另一类是遵循 NPAPI 的模式。ActiveX 的可以选择在 VC++ 中利用 ATL 来编写，NPAPI 的模式以 Firefox 为例，也可以通过 VC++ 来开发。

1. 获取 NPAPI SDK

NPAPI 的 SDK 有两种方式获取：

2. 创建工程

  • 在 Visual Studio 中创建一个动态链接库 Dll 工程。
  • 添加 SDK 中的头文件和 np_entry.cpp、npn_gate.cpp 和 npp_gate.cpp 三个文件
  • 添加预编译宏 X86

3. 配置 Dll 导出函数

添加一个 def 定义文件，用来确保 Dll 导出函数正确，内容如下：

LIBRARY "npdemo"
EXPORTS
    NP_GetEntryPoints   @1
    NP_Initialize       @2
    NP_Shutdown     @3

4. 配置 VERSION 资源

添加一个 rc 资源文件，并添加一条 VERSION 资源，修改 StringFileInfo 块

  • 将其中的子 BLOCK 设置成 040904e4
  • 添加一条 VALUE "MIMEType", "application/demo-plugin"，NPAPI 是利用 MIMEType 来查找插件的，所以这里的 demo-plugin 其实就是插件的标识。当然，如果写成常用的类型，则表示这个插件可以支持打开这种类型的资源

5. 插件实现代码

向工程添加一个 C++ 类，例如 Plugin。代码如下：

// Plugin.h
#include "pluginbase.h"
class CPlugin : public nsPluginInstanceBase
{
public:
    CPlugin(NPP pNPInstance);
    ~CPlugin();
    NPBool init(NPWindow* pNPWindow) {
        m_bInitialized = TRUE;
        return TRUE;
    }
    void shut() {
        m_bInitialized = FALSE;
    }
    NPBool isInitialized() {
        return m_bInitialized;
    }
private:
    NPP m_pNPInstance;
    NPBool m_bInitialized;
};

// Plugin.cpp
#include "plugin.h"
////// functions /////////
NPError NS_PluginInitialize()
{
    return NPERR_NO_ERROR;
}
void NS_PluginShutdown()
{
}
nsPluginInstanceBase * NS_NewPluginInstance(nsPluginCreateData *aCreateDataStruct)
{
    if(!aCreateDataStruct)
        return NULL;
    CPlugin * plugin = new CPlugin(aCreateDataStruct->instance);
        return plugin;
}
void NS_DestroyPluginInstance(nsPluginInstanceBase * aPlugin)
{
    if(aPlugin)
        delete (CPlugin *)aPlugin;
}
////// CPlugin /////////
CPlugin::CPlugin(NPP pNPInstance)
: nsPluginInstanceBase(),
  m_pNPInstance(pNPInstance),
  m_bInitialized(FALSE)
{
}
CPlugin::~CPlugin()
{
}

6. 安装插件

Firefox 插件通过注册表安装，在注册表 HKEY_CURRENT_USER\SOFTWARE\MozillaPlugins 下面，新建子项 @mozilla.com.cn/demo，并新建字符串数据 Path 设值 Dll 完整路径。

7. 测试插件

可以编写一个 html 测试页面来测试插件：

<HTML>
    <HEAD></HEAD>
    <BODY>
        <embed type="application/demo-plugin">
    </BODY>
</HTML>

PS. 在 Firefox 中利用 about:plugins 可以查看插件的状况。