phonegap 3.4プラグイン開発入門例

公式文書(3.4.0)によるプラグイン開発ガイド:
http://docs.phonegap.com/en/3.4.0/guide_hybrid_プラグィング.index.md.璣Plugin% 20 Development%20ガイド
http://docs.phonegap.com/en/3.4.0/guide_plotforms(u)android_plugin.md.玣Android%20 Plugins
プラグインの機能は、ページから送られてきた文字列を受信し、文字列をそのまま返します.
1,直接にandroidプロジェクトにプラグインパッケージを追加します.
プロジェクト名の上で右ボタンをクリックして、メニューをポップアップします.new->package、Nameはバッグの名前を記入します.org.apphe.co rdova.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.co rdova.plugin.Echoはカバンの中の類名です.
4ページでjsコードを作成してプラグインを起動します.

cordova.exec(
	function(echoValue){//        
		alert(echoValue);
	}, 
	function(err) {//        
		alert(err);
	}, 
	"Echo", "echo", //           
	["send to native"]);//        

出てくるのはこのような効果です.