android下phonegap插件

转自：http://blog.csdn.net/avenleft/article/details/7383294

目前PhoneGap虽然提供了很多的API，但是我们也很容易发现，他有很多地方不能满足我们的需求，比如发短信。我也将介绍如何开发一个针对PhoneGap发短信的Plugin。（Android 版本）。

1、创建一个Android工程，创建之后的目录结构如图：
android下phonegap插件_第1张图片

2、把PhoneGap的android版jar包、javascript和xml文件夹加入工程。（参照上一篇中的做法）目录结构：
android下phonegap插件_第2张图片

3、新增一个类MessagePlugin
这个类就是负责发送短信功能的具体类，可以调用发送短信的android API，当然如果是其他功能，则调用相应的API，但是当使用这个API时记得申请权限。
具体代码：
Java代码

packagecom.phonegap.kiddyu.plugin;
importorg.json.JSONArray;
importorg.json.JSONException;
importorg.json.JSONObject;
importandroid.telephony.SmsManager;
importcom.phonegap.api.Plugin;
importcom.phonegap.api.PluginResult;
publicclassMessagePluginextendsPlugin {
privatestaticfinalString SEND ="send";
@Override
publicPluginResult execute(String action, JSONArray data, String callbackId) {
PluginResult result;
if(SEND.equals(action)) {
try{
JSONObject jsonObj =newJSONObject();
String target = data.getString(0);
String content = data.getString(1);
SmsManager sms = SmsManager.getDefault();
sms.sendTextMessage(target,null, content,null,null);
jsonObj.put("target", target);
jsonObj.put("content", content);
result =newPluginResult(PluginResult.Status.OK, jsonObj);
}catch(JSONException ex) {
result =newPluginResult(PluginResult.Status.JSON_EXCEPTION);
}catch(IllegalArgumentException ex){
result =newPluginResult(PluginResult.Status.ERROR);
}
}else{
result =newPluginResult(PluginResult.Status.INVALID_ACTION);
}
returnresult;
}
}

4、为phonegap增加一个javascript的API
在工程目录www/js下面增加一个javascript文件：phonegapPlugin.js，然后加入代码：
Javascript代码

varMessage =function(){};
Message.prototype = {
send:function(success, error, target, content){
PhoneGap.exec(success, error,"MessagePlugin","send", [target, content]);
}
};
PhoneGap.addConstructor(function() {
PhoneGap.addPlugin("message",newMessage());
});

[javascript] view plain copy

varMessage=function(){};
Message.prototype={
send:function(success,error,target,content){
PhoneGap.exec(success,error,"MessagePlugin","send",[target,content]);
}
};
PhoneGap.addConstructor(function(){
PhoneGap.addPlugin("message",newMessage());
});

关键的方法是PhoneGap.exec(success, error, "MessagePlugin", "send", [target, content]);
做一下简单的介绍：
success：方法执行成功时调用该函数；
error：方法执行失败时调用该函数；
"MessagePlugin"：类名，最好与前面创建的Java类一个样；
"send"：插件类中的参数String action；
[target, content]：一个数据，插件类中的参数JSONObject data；

PhoneGap.addPlugin("message", new Message());中的"Message"是你调用send方法时的实例名称。（不知道这样叫是否准确）

5、将自己的插件加入到PhoneGap的配置中
打开目录中res/xml/plugins.xml文件，在最后面加上
<plugin name="MessagePlugin" value="com.phonegap.kiddyu.plugin.MessagePlugin"/>
注意name要和你的插件类名一致！ value是类的包名.类名。

插件到这里就算完成了，让我们测试一下到底能不能工作吧。
加入一个简单的html页面（上一篇已经介绍怎么开发，这里不做重复介绍），代码参照下面：
Html代码

<!DOCTYPE html>
<html>
<head>
<metahttp-equiv="Content-Type"content="text/html; charset=utf-8"/>
<scripttype="text/javascript"charset="utf-8"src="../js/jquery_1_6_4.js"></script>
<scripttype="text/javascript"charset="utf-8"src="../js/phonegap-1.2.0.js"></script>
<scripttype="text/javascript"charset="utf-8"src="../js/phonegapPlugin.js"></script>
<scripttype="text/javascript">
$(function(){
varonSend=function(){
varsuccess=function(data){
alert("tel : " + data.target + ', and content : ' + data.content);
};
varerror=function(e){
alert(e);
};
vartel= $('#tel').val();
varcontent= $('#content').val();
window.plugins.message.send(success, error, tel, content);
};
$('#send').bind('click', onSend);
});
</script>
</head>
<body>
<divid="messageDiv">
<inputtype="tel"id="tel"value="5556"/>
<textarearows="20"cols="25"id="content"></textarea>
<buttontype="button"id="send">Send Me</button>
</div>
</body>
</html>

[html] view plain copy

<!DOCTYPEhtml>
<html>
<head>
<metahttp-equiv="Content-Type"content="text/html;charset=utf-8"/>
<scripttype="text/javascript"charset="utf-8"src="../js/jquery_1_6_4.js"></script>
<scripttype="text/javascript"charset="utf-8"src="../js/phonegap-1.2.0.js"></script>
<scripttype="text/javascript"charset="utf-8"src="../js/phonegapPlugin.js"></script>
<scripttype="text/javascript">
$(function(){
varonSend=function(){
varsuccess=function(data){
alert("tel:"+data.target+',andcontent:'+data.content);
};
varerror=function(e){
alert(e);
};
vartel=$('#tel').val();
varcontent=$('#content').val();
window.plugins.message.send(success,error,tel,content);
};
$('#send').bind('click',onSend);
});
</script>
</head>
<body>
<divid="messageDiv">
<inputtype="tel"id="tel"value="5556"/>
<textarearows="20"cols="25"id="content"></textarea>
<buttontype="button"id="send">SendMe</button>
</div>
</body>
</html>

注意在页面中加入你自己的phonegapPlugin.js，而且顺序必须在phonegap.js之后。
其他的都参照上一篇中，修改自己的Activity就开始测试吧！一下是测试截图：

android下phonegap插件_第3张图片

更多相关文章

随机推荐