安裝依賴plugman
plugman是用於安裝和卸載用於Apache Cordova項目的插件的命令行工具。
https://www.npmjs.com/package/plugman
npm install -g plugman
創建插件
plugman create --name [插件名] --plugin_id [插件id] --plugin_version [插件版本]
為了方便管理,將插件可以創建在 Cordova 項目目錄下的 plugins 文件夾下
例如:
plugman create --name Demo --plugin_id com.cordova.demo --plugin_version 1.0.0
生成目錄結構如下,主要包含兩個文件,plugin.xml 和 [插件名].js
插件配置
首先進入插件目錄,添加插件支持的平台環境
cd Demo plugman platform add --platform_name android plugman platform add --platform_name ios
添加之后將在Demo/src目錄下產生android和ios兩個目錄,此處只以iOS為例
在plugin.xml文件中也會生成添加平台的相應配置
參數說明:
id="com.cordova.demo"
:插件id必須<js-module name="Demo" src="www/Demo.js" >
:此處配置js所在目錄和調用的類名<source-file>
:標示插件所需的oc .m文件<header-file>
:標示插件所需的oc .h文件<resource-file>
:標示插件所需資源文件(圖片、xib資源等)- <framework src="src/ios/xxx.framework"custom="true" />:插件所包含的framework框架文件
<feature name="Demo"><param name="ios-package" value="Demo" />
:指明插件映射至ios的類名。
更多參數參考《插件規范》
修改 Demo.js 文件
Cordvoa插件的輸出文件,在h5/js中直接調用里面的方法與原生進行交互
修改 Demo.m 文件
Cordvoa交互的原生文件需要繼承於 CDVPlugin
在.m和jsh中,相互對應,在.m中完成與原生的交互行為
初始化插件
進入插件目錄執行
npm init
根據提示完成配置,一般默認配置就能滿足要求,生成一個package.json文件。
到此,一個完整的Cordvoa插件就創建完成了。
插件調試
首先,創建調試項目,進入項目目錄
cordova create CordovaProject com.cordova.demo CordovaApp
cd CordovaProject/
安裝插件
cordova plugin add [插件文件夾路徑]
在項目目錄的www文件夾(CordovaProject/www)下,修改html和js文件,添加測試代碼
添加開發平台
sudo cordova platform add ios
運行ios項目,就可以進行代碼調試了,這可以對導入的插件代碼進行修改不會影響到插件源文件,調試完成后只需對插件對應文件進行替換和修改即可