So Tired !_! 逆水行舟, 不进则退!

21May/10

mozilla firefox 插件开发 快速入门

Posted by Nick Xu

如果想讓你的 binary 軟体元件在瀏覽器上能夠執行, 你需要實做一些規定的介面. 這樣的程式就能像 Flash 一樣, 嵌入在網頁中, 讓使用者使用. 然而不同的瀏覽器要實做的介面是不一樣的.

若你希望在 IE 上要能執行, 則你的元件必須實做 ActiveX 的介面

若你希望在 Firefox 或 Opera 甚至是 Google 的 Chrome 瀏覽器上也能執行你的程式,  那麼你的元件必須實做 NPAPI 介面.

這一切都要怪微軟是屬於封閉架構, 這使得一些跨平台的軟体開發組織, 不願意實做 ActiveX. 所以如果你要讓 firefox 或新的 Goolge 瀏覽器 Chrome 上面寫 plugin, 你能用的技術是 NPAPI.

這份文件內容包含

       1. 如何選擇正確的方式, 撰寫 scriptable plugins

       2. 如何下載正確的 NPAPI 範例

       3. 如何在 Visual Studio .Net IDE 下, 編譯範例

       4. 如何測試你的 plugin

------------------------------------------------------------------

選擇正確的方式, 撰寫 scriptable plugins

我想你應該知道 Plugins 與 Extensions  是不一樣的, 你想知道 Firefox Plugin 的最新發展, 應該到

http://developer.mozilla.org/en/Plugins

你可以用 plugin 多媒體應用程式, 例如監控系統, 人物自動追蹤 等應用,  全部都可以利用 NPAPI 這個介面讓你的應用程式網頁化.

官方網頁裡面詳細的告訴你,  NPAPI plugins 可以利用 java script 進行操控, 而舊的技術 XPCOMLiveConnect 已經不適合用來開發 NPAPI plugins 了.

要讓 plugins 能被 script 操控, 你應該使用 npruntime

網址: http://developer.mozilla.org/en/Gecko_Plugin_API_Reference/Scripting_plugins

 

有圖有真相

寫程式也是一樣, 與其看一堆文件, 先給我一個能執行的範例. 再談後面的優秀架構與API 文件.

所以呢 ...

有程式還要能 work 才有真相! 你看看, 菜不就端上來了嗎 ....

我知道你在想什麼, 下面的範例支援 Firefox 3.0.

如何寫程式?

Step 1: 下載 Gecko_SDK: xurlrunner

網址: http://developer.mozilla.org/en/Gecko_SDK
* 我下載的是 Gecko 1.9 (Firefox 3.0) 版本

Step 2: 下載範例程式

網址:  http://mxr.mozilla.org/seamonkey/source/modules/plugin/samples/

點選 npruntime 範例

每個檔案都有 Raw file 可以讓你下載, 把所有的檔案下載回去吧!

snap003

注意: 你會在 Samples and Test Cases 發現, 範例程式有兩個載點, 其中第二個mozilla/modules/plugin/tools/sdk/samples 裡面, scriptable 使用的是舊的技術 XPCOM, 請不要使用.  否則你編出來的 dll 在 Firefox 3.0 會無法執行.

Step 3: 建立一個簡單 Visual Studio 專案, 把剛剛抓到的程式放進去.

mozilla 官方網頁有教學: 你可以去看一下 (link)

下面是我寫的簡單修正中文版 (別擔心, 這些流程都很簡單)

----------------------------------------

1. 建立新的專案: project 名稱設定為 nprt

VC 的操作:  New Project -> Vistual C++ -> Win32 Project 
  

2. Application Settings 選 DLL 並且設定為 Empty project

3. 把範例程式加入專案中
  (a) 把從 http://mxr.mozilla.org/seamonkey/source/modules/plugin/samples/
      下載回來的所有檔案 copy 到 nprt/nprt 目錄中
  (b) 加入 nprt 專案中

4. 解開 xulrunner-sdk:  放在 C:xulrunner-sdk
網址:

http://developer.mozilla.org/en/docs/Gecko_SDK
  

5. 設定 Include Path

     VC 的操作: C/C++ -> Additional Include Directories
    "C:xulrunner-sdkinclude";"C:xulrunner-sdkincludeplugin";"C:xulrunner-sdkincludenspr";"C:xulrunner-sdkincludejava"

6. 直接設定下面的定義
     VC 的操作: C/C++ -> Preprocessor -> Preprocessor Definitions
   WIN32;_WINDOWS;XP_WIN32;MOZILLA_STRICT_API;XPCOM_GLUE;XP_WIN;_X86_;NPSIMPLE_EXPORTS
   _DEBUG
   

7. 關掉 precompiled 選項 (如果你剛剛選的是 Empty Project, 則 precompiled 選項應該已經關閉)
  VC 的操作: C/C++ -> Precompiled Headers -> Create/Use Precompiled Header: 設定為 Not Using Precompiled Headers

8. 設定 Module Definition File: nprt.def
  VC 的操作: Linker -> Input -> Module Definition File:

9. 把 plugin.cpp 的 DrawText 改成 DrawTextA

10. 修改  plugin.cpp 裡面的 Invoke method 改成下面這樣,

否則當 firefox 呼叫你的 plugin 時, 會 當掉.

------------------------------------------------------------------

bool ScriptablePluginObject::Invoke(NPIdentifier name, const NPVariant *args,
                               uint32_t argCount, NPVariant *result) {
  if (name == sFoo_id) {
    printf ("foo called!n");
    MessageBox(NULL,L"foo 被呼叫 ",L"Java Script 呼叫範例",MB_OK);
    
    return PR_TRUE;
  }

  return PR_FALSE;
}

------------------------------------------------------------------

11. 修改 npp_gate.cpp , 把 _GetJavaClass  拿掉

------------------------------------------------------------------

/*  加入註解 (感謝網友 Chui-Wen Chiu 提醒)

jref NPP_GetJavaClass (void)
{
return NULL;
}

*/

------------------------------------------------------------------

編譯應該會通過, 產生 nprt.dll

----------------------------------------

測試:

     Step 1: 把 nprt.dll 放到 firefox 的 plugins 目錄底下

     Step 2: 開啟 firefox 在網址輸入

                    about:plugins

                   看看你的 plugins 是否在裡面.

                   長相應該是這樣.

snap003

      Step 3: 執行 測試 test.html

       注意 1: 你下載的 test.html 已經嚴重過期了. 所以我的作法是自己寫一個

       test2.html

文章的例子针对的是Firefox 3.0(貌似用的XULRunner 1.9.0),我电脑上装的Firefox版本为3.5.5,开发用的XULRunner版本为1.9.1.4,发现代码有一些问题,如下所示:

1、npupp.h被npfunctions.h取代了,所以要将npupp.h替换成npfunctions.h。
2、 编译是会提示int16,int32未被定义。首先包含nptypes.h头文件,打开该头文件,发现其中使用了typedef重定义几个简单类型,比如 int16_t,int32_t等。将源代码中所有的int16,int32都替换成int16_t,int32_t。
3、NP_TRUE/NP_FALSE未被定义,直接将其替换成true/false便可。
       修改源代码时不要出现中文,否则编译器会死掉。做到这几点之后编译工程就可以正常生产DLL文件,将nprt.dll拷贝到Firefox安装目录的plugins子目录下,在Firefox的地址栏输入"about:plugins"就可以看到插件了。
       文章中提到Mozilla官方提供的测试页面严重过期,我测试了下还基本正常吧,只不过我下不到作者提供的测试页面,也不知道作者改成什么样子了。测试页 面的代码偏多,它使用embed来嵌入相应类型的东东来调用插件,不知道为什么Firefox依旧显示缺失插件,插件中生成的窗口并没有正确地显示出来, 不过别的部分都是正常的,可以调用foo函数,查看bar属性。
       这个nprt.dll使用nprt.def只向外暴露三个接口,分别是NP_GetEntryPoints、NP_Initialize和 NP_Shutdown,这应该是所有NPAPI插件的规范吧,我是用dumpbin看了看淘宝的Chrome NPAPI插件中npwangwang.dll导出的接口,发现也只有这三个。dll中实现了许多NPP函数,大量的NPN函数都是直接调用NPP函数。 我在代码中加入了许多MessageBox语句以跟踪程序的运行,发现有点头晕。首先NPP_NEW函数会被调用,然后它会生成一个CPlugin对象, 而CPlugin构造函数中又会生成ScriptablePluginObject对象,当关闭测试页面时,相应的对象会被析构,不过有时候有点乱。在脚 本中调用foo函数,会触发ScriptablePluginObject::invoke函数运行,invoke函数内部根据名字实现foo对应的操 作。
bool
ScriptablePluginObject::HasMethod(NPIdentifier name)
{
  return name == sFoo_id;
}
 
bool
ScriptablePluginObject::HasProperty(NPIdentifier name)
{
  return (name == sBar_id ||
          name == sPluginType_id);
}
       这两个函数返回对应的拥有的方法和属性。每次调用方法访问属性时都会调用这两个方法判断相应的方法和属性是否存在。下面给出一个最简单的测试页面,点一个按钮可以调用foo方法,点第二个按钮可以获取bar属性。
<HTML>
<HEAD>
<TITLE>Scriptable Plug-in Test</TITLE>
</HEAD>
<BODY id="bodyId">
 
<object id="pluginobj" type="application/mozilla-npruntime-scriptable-plugin"></object>
 
<br>
<form name="formname">
<input type=button value="Call pluginobj.foo()" onclick='alert(pluginobj.foo())'>
<input type=button value="Get pluginobj.bar" onclick='alert(pluginobj.bar)'>
</form>
 
</BODY>
</HTML>
       呵呵,现在知道怎么做NPAPI插件了,可以为Chrome写一个插件,在右上角的扩展图标栏以一个图标的方式显示电池剩余使用时间,有空的时候就尝试下吧 ^_^
   
site
site