Developing a Plugin on Android 只拣实用的。。。

Developing a Plugin on Android

http://docs.phonegap.com/en/2.5.0/guide_plugin-development_android_index.md.html#Developing%20a%20Plugin%20on%20Android

           详细介绍请直接点上面的地址，我这里只拣最最实用的。

           js中插件的使用需要以如下的形式调用方法，分别是回调成功函数，回调失败函数，布置在java端的服务，action（这个咋翻译。。），和参数列表。

exec(<successFunction>, <failFunction>, <service>, <action>, [<args>]);

           插件的部署，还用说么。。。

<plugin name="<service_name>" value="<full_name_including_namespace>"/>

            接下来上实例。

           1，部署插件，写在config.xml里。

<plugin name="Echo" value="org.apache.cordova.plugin.Echo" />

            2，java端实现，就是收到页面传递过来的参数后做什么处理

import org.apache.cordova.api.CordovaPlugin;
import org.apache.cordova.api.PluginResult;
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);
            //json对象也可以当作参数传回到页面
           // JSONObject jsono = new JSONObject();           
           // jsono.put("message",message);
           // callbackContext.success(jsono);

 } else { 
callbackContext.error("Expected one non-empty string argument."); 
} 
}
}

          3，js实现，就是页面的传值和回调，挺好理解的吧。

cordova.exec(successFunction, failFunction, "Echo","echo",[message]); //无参就写[]，多个参数的顺序一定不能搞错

function successFunction(e){
    alert(e);  //e就是传递的message
    //如果在callbackContext.success中传递的是json对象，这里也可以直接读取。
   // e.message
}

function failFunction(e){
    //与successFunction同理，取决于callbackContext.error中传递的信息。
}

           4,实用的就是这样，还有一点不能理解的是跟线程有关的，还是放在这里吧。第二种异步执行不跟上面讲的是一个效果么。。。

If you need to interact with the UI, you should use the following:

@Override
public boolean execute(String action, JSONArray args, final CallbackContext callbackContext) throws JSONException {
    if ("beep".equals(action)) {
        final long duration = args.getLong(0);
        cordova.getActivity().runOnUiThread(new Runnable() {
            public void run() {
                ...
                callbackContext.success(); // Thread-safe.
            }
        });
        return true;
    }
    return false;
}

If you do not need to run on the UI thread, but do not want to block the WebCore thread:

@Override
public boolean execute(String action, JSONArray args, final CallbackContext callbackContext) throws JSONException {
    if ("beep".equals(action)) {
        final long duration = args.getLong(0);
        cordova.getThreadPool().execute(new Runnable() {
            public void run() {
                ...
                callbackContext.success(); // Thread-safe.
            }
        });
        return true;
    }
    return false;
}

以上。