Phonegap插件开发攻略

本文主要是介绍Phonegap插件开发攻略，希望对大家解决编程问题提供一定的参考价值，需要的开发者们随着小编来一起学习吧！

Phonegap的目的是实现跨移动平台的UI开发，是现在比较有潜力的方向。熟悉html开发且有兴趣往安卓方向发展的朋友可以多了解一下。

1. 动手前的准备工作

配置开发环境
阅读相关资料http://docs.phonegap.com/en/3.4.0/guide_hybrid_plugins_index.md.html#Plugin%20Development%20Guide

2. 开发步骤

phonegap插件由三部分组成源文件(src),js接口(www)，以及描述文件(plugin.xml)。

2.1 关于源文件

源文件应该继承于CordovaPlugin，并重写一个excute方法。

2.2 关于描述文件

描述文件范例如下：

<-plugin xmlns="http://apache.org/cordova/ns/plugins/1.0"xmlns:rim="http://www.blackberry.com/ns/widgets"xmlns:android="http://schemas.android.com/apk/res/android"id="notification"version="1.0.0"><-name>Custom<-/name><-description>Custom Plugin<-/description><-license>Apache 2.0<-/license><-keywords>cordova,Custom<-/keywords><-js-module src="www/test.js" name="send"><-clobbers target="tpx" /><-/js-module><-platform name="android"><-config-file target="res/xml/config.xml" parent="/*"><-feature name="Custom" ><-param name="android-package" value="com.btt.plugin.test.Custom"/><-/feature><-/config-file><-source-file src="src/android/Custom.java" target-dir="src/plugin" /><-/platform>
<-/plugin>

其中比较重要的参数有id，js-module等，具体说明如下：

name:没有特殊含义。
id:该插件的标识，com.btt.plugin.custom.该名字可以随意取，没关系。(可以通过phonegap local plugin list命令查看)
js-module：指明js接口。name表示的是action的名字。clobbers是真正使用时的调用者。
platform：平台相关信息。feature name表示的是service name。value属性值必须为源文件入口(包名.类名 full_name_including_namespace)。
source-file：源文件路径。target-dir：目标文件路径，可自定义。若有多个源文件，应该写多行。

插件add以后，可以查看res/xml/config.xml文件的变化

        <-feature name=""><-param name="android-package" value="" />

2.3 关于js接口

插件的执行可直接通过cordova.exec(function(winParam) {},function(error) {},"Custom","send",params);语句执行的。也可通过js接口来执行：

var exec = require('cordova/exec');  
exports = {send: function(callback) {var params = [];params.push("android toast");params.push("博思");//真正调用的是cordova.exec(...);exec(callback, function(error){alert(error.code + ' ' + error.message);}, "Custom", "send", params);}
};

2.4 相关指令

查看已成功安装的插件列表: phonegap local plugin list
添加本地插件: phonegap local plugin add path(e.g D:\phonegap\plugins\com.btt.plugin.test)
移除本地插件: phonegap local plugin remove id

3 其它相关

3.1 关于插件的实例化

插件在被js调用的时候才创建实例，一种情况下例外：

<-feature name="Echo"><-param name="android-package" value="" /><-param name="onload" value="true" />

3.1 关于线程

插件的执行接口并不是运行在WebView主线程中，而是运行在WebCore线程中，当需要与UI进行交互，可以通过一下手段：

	            cordova.getActivity().runOnUiThread(new Runnable() {public void run() {...callbackContext.success(); // Thread-safe.}});
或cordova.getThreadPool().execute(new Runnable() {public void run() {...callbackContext.success(); // Thread-safe.}});