一、首先安装plugman :javascript
npm install -g plugman
二、建立一个插件/Create A Pluginhtml
plugman create --name <pluginName> --plugin_id <pluginID> --plugin_version <version> [--path <directory>] [--variable NAME=VALUE] Parameters: - <pluginName>: The name of the plugin - <pluginID>: An ID for the plugin, ex: org.bar.foo - <version>: A version for the plugin, ex: 0.0.1 - <directory>: An absolute or relative path for the directory where the plugin project will be created - variable NAME=VALUE: Extra variables such as description or Author eg: plugin create --name test --plugin_id org.apache.test --plugin_version 0.0.1 /path/to/project
建立后的目录结构以下:(一个简单的插件目录)java
后续为了插件能正常发布,以及能够被其余npm注册的文件使用该插件,须要建立package.json文件android
plugman createpackagejson <directory> eg:plugman createpackagejson c:/path/to/plugin
以上步骤创建在安装了plugman以后:apache
npm install -g plugman
三、插件plugin.xml说明及配置npm
js-module标签指定了通用JavaScript接口的路径。
json
以下:网络
<js-module name="test" src="www/test.js"> <clobbers target="test" /> </js-module>name:即为插件接口名称;
platform标签指定插件所支持的平台
app
以下:ide
<!--android -->
<platform name="android"> <config-file target="config.xml" parent="/*"> <feature name="Echo"> <param name="android-package" value="org.apache.cordova.plugin.Echo"/> </feature> </config-file> <source-file src="src/android/Echo.java" target-dir="src/org/apache/cordova/plugin" /> </platform>【官方解释】:config-file标签封装了一个注入到平台特定的config.xml文件中的特征标签,以使平台知道附加的代码库。 header-file和source-file标签指定了库的组件文件的路径
以上为Android示例,IOS下配置相似,只是貌似多了header-file标签(具体以官方为准);
Android Permissions
如若该插件须要访问手机对应权限,则须要添加以下配置,加上所须要的权限便可:
<config-file target="AndroidManifest.xml" parent="/*"> <!-- Required 一些系统要求的权限,如访问网络等--> <uses-permission android:name="android.permission.READ_CONTACTS" /> </config-file>
其余的一些核心Activity或者Service须要的也能够配置;(如下两种头部声明方式貌似都行,具体使用只能使用其中一种)
<config-file target="AndroidManifest.xml" parent="application"> <config-file target="AndroidManifest.xml" parent="/manifest/application"> <service android:name="com.xxx.xxx" android:enabled="true" android:exported="false"> </service> </config-file>
四、插件代码示例
config.xml定义,省略头尾以及js-module
<platform name="android"> <config-file target="config.xml" parent="/*"> <feature name="Echo"> <param name="android-package" value="org.apache.cordova.plugin.Echo"/> </feature> </config-file> <source-file src="src/android/Echo.java" target-dir="src/org/apache/cordova/plugin" /> </platform>接着添加JAVA文件
Then add the following to the src/android/Echo.java file:
package org.apache.cordova.plugin; import org.apache.cordova.CordovaPlugin; import org.apache.cordova.CallbackContext; import org.json.JSONArray; import org.json.JSONException; import org.json.JSONObject; /** * This class echoes a string called from JavaScript. */ public class Echo extends CordovaPlugin { @Override public boolean execute(String action, JSONArray args, CallbackContext callbackContext) throws JSONException { if (action.equals("echo")) { String message = args.getString(0); this.echo(message, callbackContext); return true; } return false; } private void echo(String message, CallbackContext callbackContext) { if (message != null && message.length() > 0) { callbackContext.success(message); } else { callbackContext.error("Expected one non-empty string argument."); } } }