使用插件
小程序開(kāi)發(fā)者可便捷地把插件添加到自己的小程序內(nèi),豐富小程序的服務(wù)。當(dāng)用戶(hù)在使用小程序時(shí),將可以在小程序內(nèi)使用插件提供的服務(wù)。
開(kāi)放范圍
所有小程序
接入流程
在小程序管理后臺(tái)添加插件
小程序開(kāi)發(fā)者可在”小程序管理后臺(tái)-設(shè)置-第三方服務(wù)-插件管理“中,根據(jù)AppID查找需要的插件,并申請(qǐng)使用。插件開(kāi)發(fā)者在24小時(shí)內(nèi)通過(guò)后,小程序開(kāi)發(fā)者可在小程序內(nèi)使用該插件。
在小程序代碼中使用插件
引入插件代碼包
對(duì)于插件的使用者,使用插件前要在 app.json
中聲明需要使用的插件,例如:
1 2 3 4 5 6 7 8 | { "plugins" :
{ "myPlugin" :
{ "version" :
"1.0.0" , "provider" :
"wxxxxxxxxxxxxxxxxx" } } } |
如上例所示, plugins
定義段中可以包含多個(gè)插件聲明,每個(gè)插件聲明中都必須指明插件的 appid
和需要使用的版本號(hào)。
使用插件的 js 接口
在引入插件代碼包之后,就可以在這個(gè)小程序中使用插件提供的自定義組件或者 js 接口。
如果需要使用插件的 js 接口,可以使用 requirePlugin
方法:
1 2 3 | var myPluginInterface = requirePlugin( 'myPlugin' ) myPluginInterface.hello() |
使用插件的自定義組件
使用插件提供的自定義組件,和使用普通自定義組件的方式相仿。在 json
文件定義需要引入的自定義組件時(shí),使用 plugin://
協(xié)議即可,例如:
1 2 3 4 5 | { "usingComponents" : { "hello-component" : "plugin://myPlugin/hello-component" } } |
出于對(duì)插件的保護(hù),插件提供的自定義組件在使用上有一定的限制:
頁(yè)面中的
this.selectComponent
接口無(wú)法獲得插件的自定義組件實(shí)例對(duì)象;wx.createSelectorQuery
等接口的>>>
選擇器無(wú)法選入插件內(nèi)部。