上篇文章學(xué)習(xí)了npruntime的例子程序,接下來迫不及待地想實(shí)現(xiàn)自己的一個(gè)插件了。我決定使用VS 2005來做。
新建了一個(gè)名為npgnet的工程,按照npruntime例子,新建了np_entry.cpp、npn_gate.cpp、npp_gate.cpp、npgnet.def四個(gè)文件,然后新建了一個(gè)類CGnetFFPlugin,并且把例子中的關(guān)鍵代碼添加了進(jìn)來(我刪除了一些cplugin類中的函數(shù)實(shí)體代碼,因?yàn)槲覍?shí)現(xiàn)的功能和例子中的無關(guān))。編譯后,將生成的npgnet.dll放到FF的plugins目錄下,然后在地址欄鍵入about:plugins,我靠,竟然沒有我的插件!怎么回事?三個(gè)導(dǎo)出函數(shù)我都按照標(biāo)準(zhǔn)寫了啊?比較了一下文件,我的工程沒有添加.rc和resource.h,可能是這個(gè)原因。
回到VS 2005,在資源面板添加了一個(gè)VERSION資源項(xiàng),修改ProductName等資源項(xiàng)以后,和npruntime例子比較了一下,還差MIMEType。這個(gè)東東很重要,這個(gè)給我的感覺就是FF插件的身份證,F(xiàn)F就是靠這個(gè)東東來匹配和識別你的插件的。但是我不知道VS 2005中怎么添加一個(gè)VERSION的鍵值,所以我只好用EditPlus打開npgnet.rc,手動添加了MIMEType:application/mozilla-npgnet-scriptable-plugin。OK,現(xiàn)在.rc和resource.h都?xì)W了,再編譯,將生成的npgnet.dll放到FF的plugins目錄下,然后在地址欄鍵入about:plugins,我靠,竟然還是沒有我的插件!真費(fèi)解啊!
頭大……接下來我進(jìn)行了一系列的代碼比較和嘗試,失敗了N多次,這里就省略不說了。最后發(fā)現(xiàn)原因原來在這個(gè).rc上面。我的這個(gè).rc是在VS 2005中使用菜單命令添加的,默認(rèn)語言是簡體中文,而npruntime例子是英文,用文件比較工具比較了一下,codepage和部分代碼的位置都不太一樣。其實(shí)只要把npruntime的這個(gè).rc文件替換我的這個(gè),然后編譯輸出的dll,F(xiàn)F就可以識別了!究竟是什么原因呢?是我的.rc缺少了些什么東西?還是FF只能識別英文的.rc?先不打算研究那么多了,至少我的插件的關(guān)鍵點(diǎn)不在這個(gè)上面,后面我還有很多事情需要去做。只要能讓FF認(rèn)出來,那就好。
既然決定要寫插件,就要先理解插件的概念,在這個(gè)頁面上有很詳細(xì)的介紹:https://developer.mozilla.org/en/Gecko_Plugin_API_Reference/Plug-in_Basics
下面的文字是我的一些閱讀筆記和體會:
一、插件的加載過程
當(dāng)一個(gè)頁面打開時(shí),如果該頁面上有嵌入一個(gè)插件,瀏覽器將會做以下事情:
- 通過MIMEType檢查是否有匹配插件
- 加載插件代碼到內(nèi)存
- 初始化插件
- 創(chuàng)建一個(gè)新的插件實(shí)例
插件可以在一個(gè)頁面上被實(shí)例多個(gè)對象,也可以在同一時(shí)刻在不同的窗口中被實(shí)例化。當(dāng)頁面被關(guān)閉時(shí),插件的實(shí)例就會被銷毀。當(dāng)最后一個(gè)實(shí)例被刪除后,插件代碼就會從內(nèi)存中被卸載掉。
下面是插件內(nèi)的函數(shù)調(diào)用過程:
- 如果插件是首次被載入內(nèi)存,瀏覽器會調(diào)用插件的NP_Initialize方法。為了方便起見,所有的插件定義函數(shù)以“NPP”開頭,所有的瀏覽器定義函數(shù)以“NPN”開頭。
- 當(dāng)瀏覽器創(chuàng)建插件實(shí)例時(shí),會調(diào)用NPP_New方法。
- 當(dāng)插件實(shí)例被刪除時(shí)(如關(guān)閉頁面、關(guān)閉窗口),會調(diào)用NPP_Destroy方法。
- 當(dāng)最后一個(gè)實(shí)例被刪除,插件從內(nèi)存中卸載時(shí),會調(diào)用NP_Shutdown方法。
二、插件檢測
可以使用Javascript來檢測一個(gè)插件是不是已經(jīng)安裝了,下面是測試代碼:
function DetectFFPlugin()
{
var mimetype = navigator.mimeTypes["application/mozilla-npgnet-scriptable-plugin"];
if(mimetype)
{
var plugin = mimetype.enabledPlugin;
if(plugin)
{
document.writeln("Plugin had been installed and be enabled.");
}
}
else
{
document.writeln("Sorry, Plugin has NOT been installed.");
}
}
嗯,看到這里,覺得這個(gè)檢測很有用。當(dāng)檢測用戶尚未安裝時(shí),可以指導(dǎo)用戶到哪哪哪去下載安裝(轉(zhuǎn)向一個(gè)漂亮點(diǎn)兒的頁面),當(dāng)檢測已經(jīng)安裝了,就動態(tài)加載插件代碼。不錯(cuò)。:)
三、插件結(jié)構(gòu)概述
一個(gè)插件中的方法分為插件方法(Plug-in Methods)和瀏覽器方法(Browser Methods)。插件方法是你在插件中自己去執(zhí)行的那些方法,以NPP為前綴命名。瀏覽器方法是被Gecko所執(zhí)行的那些方法,以NPN為前綴命名。數(shù)據(jù)結(jié)構(gòu)(Data Structures)以NP開頭。
插件可分為有窗口和無窗口兩種,不過文章中建議使用有窗口的,說這樣會更穩(wěn)定和易于控制。另外文中提到了可以將插件作為頁面的一部分,并且可以使用HTML代碼來控制插件的顯示與否。
有兩種方式可以使一個(gè)插件不可見:
1、如果你使用embed標(biāo)簽,可以使用其hidden屬性,例如:<embed src="audiplay.aiff" type="audio/x-aiff" hidden="true">
2、如果你是用object標(biāo)簽,由于它沒有hidden屬性,你可以用CSS來完成隱藏:
object
{
visibility: visible;
}
object.hiddenObject
{
visibility: hidden !important;
width: 0px !important;
height: 0px !important;
margin: 0px !important;
padding: 0px !important;
border-style: none !important;
border-width: 0px !important;
max-width: 0px !important;
max-height: 0px !important;
}
<object data="audiplay.aiff" type="audio/x-aiff" class="hiddenObject"></object>
接下來文中介紹了object這個(gè)標(biāo)簽的使用。并且給了一個(gè)例子來說明ActiveX和插件如何融為一體來使用。
最后面的部分是對object和embed兩種標(biāo)簽的各種屬性的說明和舉例。
值得一提的是,對于object和embed兩種標(biāo)簽都可以在頁面上嵌入一個(gè)插件。如何取舍呢?文章中有這么一段話:
Though the object
element is the preferred way to invoke plug-ins, the embed
element can be used for backward compatibility with Netscape 4.x browsers, and in cases where you specifically want to prompt the user to install a plug-in, because the default plug-in is only automatically invoked when you use the embed
element.
意思是說:盡管object是推薦使用的調(diào)用插件的方式,embed也可嵌入插件(Netscape 4.x以上的瀏覽器),但如果你想在用戶沒有安裝插件時(shí),提示他進(jìn)行安裝,那么就應(yīng)該選擇用embed,因?yàn)镕F的默認(rèn)插件系統(tǒng)僅僅在你使用embed標(biāo)簽的時(shí)候,才會自動幫助你完成這種提示用戶安裝的效果。
我看過以后的感覺是,object使用起來似乎比embed要復(fù)雜,起碼針對FF這個(gè)瀏覽器是這樣,雖然他是HTML W3C的標(biāo)準(zhǔn)。多數(shù)情況下使用embed就可以了,何況現(xiàn)在誰還在用Netscape 4.x以下版本的瀏覽器啊,您說是不是?:)
OK,通過這幾天的學(xué)習(xí),終于對FF的插件編寫有了一個(gè)初步的感性認(rèn)識。到目前為之一切還比較順利。