phonegap3.4插件開發入門例子

根據官方文檔（3.4.0）的插件開發指南：

http://docs.phonegap.com/en/3.4.0/guide_hybrid_plugins_index.md.html#Plugin%20Development%20Guide

http://docs.phonegap.com/en/3.4.0/guide_platforms_android_plugin.md.html#Android%20Plugins

該插件的功能就是接收頁面發過來的一個字符串，並將字符串原樣返回。

1，直接在android工程中添加一個插件包

在項目名稱上點擊右鍵，彈出菜單：new->package，Name填寫包的名稱：org.apache.cordova.plugin

2，編寫插件代碼

在新建出來的包上點擊右鍵，彈出菜單：new->file，File Name填寫：Echo.java，文件內容爲：

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.");
        }
    }
}

3，配置項目的config.xml

config.xml位於res/xml下，在文件中增加以下內容：

    <feature name="Echo">
        <param name="android-package" value="org.apache.cordova.plugin.Echo"/>
    </feature>

這裏feature的name就是我們下面使用javascript調用時指定的名稱，需要一致就行。org.apache.cordova.plugin.Echo就是包中的類名。

4，在頁面中編寫js代碼來調用插件

cordova.exec(
	function(echoValue){//成功時調用的函數
		alert(echoValue);
	}, 
	function(err) {//失敗時調用的函數
		alert(err);
	}, 
	"Echo", "echo", //對應插件中的類和方法名
	["send to native"]);//發到插件中的參數

出來就是這麼一個效果：